Commit graph

76 commits

Author SHA1 Message Date
Guy Bloom
2bd77b9895
Fix convert --format with never_convert_lossy_files (#6171)
## Description

Fixes #5625 

When `convert.never_convert_lossy_files` is enabled, `beet convert` was
ignoring the explicit `--format` option and just copying the lossy files
without
transcoding them. For example:

- `beet convert format:mp3 --format opus`

would still produce MP3 files instead of OPUS.

Change:

- Allows to override options `never_convert_lossy_files`, `max_bitrate`
or `no_convert` for `beet convert` as well as trying to convert to the
same format as existing already with a new option `--force`. That way,
for example lossy files selected by the query are transcoded to the
requested format anyway.
- Keeps existing behavior for automatic conversion on import (no CLI
override there).
- Adds tests to cover checking whether `--force` correctly overrides
settings or CLI options.
- Documents the behavior in the convert plugin docs

Co-authored-by: J0J0 Todos <jojo@peek-a-boo.at>
2025-12-03 22:48:41 +01:00
Multipixelone
699e0a1272 fixup! add documentation for write_metadata option 2025-09-24 22:11:47 -04:00
Multipixelone
98170f6c04 add documentation for write_metadata option 2025-09-24 21:52:57 -04:00
Šarūnas Nejus
ab5acaabb3
Reformat all docs using docstrfmt 2025-08-10 16:25:05 +01:00
Šarūnas Nejus
769dcdc88a
Docs: fix linting issues 2025-08-10 16:16:02 +01:00
J0J0 Todos
997e8a8440 Fix m3u8 wikipedia link in convert plugin docs 2023-04-21 22:12:17 +02:00
J0J0 Todos
94784c2c29 convert: playlist: Documentation overhaul 2023-04-02 21:14:50 +02:00
J0J0 T
a1baf9e94b convert: playlist: Fix rst linter error in docs
Fix "inline empasis start string without endstring" error in docs.
2023-03-29 07:46:08 +02:00
J0J0 T
c1908d551a convert: playlist: Document the feature
leaving out the fact that #EXTM3U is added to the playlist file header
(that important?).
2023-03-29 07:46:08 +02:00
Alok Saboo
5f87371229 rephrase 2023-03-14 20:57:34 -04:00
Alok Saboo
05cdecfb7c Add more examples to convert plugin 2023-03-14 20:39:47 -04:00
Aidan Epstein
c906e55ba9 Fix recent bug that would not transcode when format was wrong
Bug introduced in c6d623241b, should_transcode would return False even when the format was different.

Also fix up tests and documentation.
2022-10-19 08:55:51 -07:00
Aidan Epstein
d66a513d80
Fix documentation to refer to wma instead of wmv
This format actually has a definition.
2022-07-30 16:13:18 +00:00
Adrian Sampson
3f6da68af2
Slight docs rewording 2022-03-16 11:08:05 -04:00
Duc Nguyen
c0e44960c6 expand documentation on auto and auto_keep 2022-03-16 14:04:40 +01:00
Duc Nguyen
c4281ddacc add some documentation 2022-03-09 18:34:31 +01:00
Duc Nguyen
af5858d200 doc + linter + changelog 2022-03-04 10:42:17 +01:00
Adam Fontenot
07eb26f276 Resize album art when embedding (convert plugin)
Fixes #2116
2022-02-09 23:52:21 -08:00
jtpavlock
c9f59ee38d
Add broken link checker to integration test (#3703)
* fix broken links
* add link check command to tox
* add link check to the weekly integration test
2020-09-04 15:42:36 -05:00
Samuel Cook
b89a2650cc
Delete after convert (#3700)
* If import move is true, files will be deleted after converting.
Fixes #2947

* Removed trailing whitespace to comply with W293, fixing build

* Add period to the end of the comment

Co-Authored-By: Adrian Sampson <adrian@radbox.org>

* Added changelog entry for this fix.

* Added delete_originals option to remove source files after transcode

* Added unit test, removed redundant syspath call

Co-authored-by: Logan Arens <logan-arens@users.noreply.github.com>
Co-authored-by: Logan Arens <heresmygithub@protonmail.com>
Co-authored-by: Adrian Sampson <adrian@radbox.org>
Co-authored-by: Logan Arens <logan.arens@protonmail.com>
2020-08-03 20:20:20 -05:00
Vexatos
7aab50b7b8
convert: Reduce amount of duplicate code for linking.
Also slightly reworded documentation.
2019-08-21 12:19:47 +02:00
Vexatos
aeb7d8846e
convert: disable album-art embedding for linked files.
Fixed flag precedence of link and hardlink over their options.
Fixed formatting issue.
2019-08-20 16:40:02 +02:00
Vexatos
a61aa74061
convert: add option to hardlink instead of copying.
Overrides the --link option.

As proposed in #2324.
2019-08-20 16:07:01 +02:00
Kier Davis
4820cee35c
convert: add option to symlink instead of copying
As proposed in #2324.

Updated commit from #2326.

Co-authored-by: Vexatos <stuarzt@gmx.de>
2019-08-20 14:50:44 +02:00
Adrian Sampson
23c9f87142 Typography (#3319) 2019-06-28 09:24:15 -04:00
Justin Mayer
9e5c45d6dd
Convert plugin skips previously-converted files
Clarifies documentation so it's clear that one can run `beet convert` without fearing that previously-converted files will be needlessly re-converted.
2019-06-28 14:47:38 +02:00
FichteFoll
aa31fea037
Update a lot of URLs to use HTTPS
*All* URLs were checked manually, but only once per domain!

I mostly concerned myself with URLs in documentation rather than source
code because the latter may or may not have impactful changes, while the
former should be straight forward.

Changes in addition to simply adding an s:

- changed pip and pypi references as their location has changed
- MPoD (iOS app) url redirects to Regelian, so I replaced those
- updated homebrew references

Notable observations:

- beets.io does have HTTPS set up properly (via gh-pages)
- beatport.py uses the old HTTP url for beatport
- as does lyrics.py for lyrics.wikia.com
- https://tomahawk-player.org/ expired long ago, but the http page
  redirects to https regardless
- none of the sourceforge subdomains have https (in 2019!)
2019-06-05 03:11:49 +02:00
Carl Suster
2e0230789f docs: fix some markup issues and typos 2019-04-27 12:43:13 +10:00
Jan Holthuis
0579046487 docs: Add new id3v23 config option to convert plugin documentation 2019-02-14 23:42:36 +01:00
Aaron Jubbal
e24f732014 Changed dont_convert to no_convert. 2017-11-29 20:08:50 -08:00
Aaron Jubbal
e5d782a3b1 Added docs for dont_convert option. 2017-11-29 16:41:27 -08:00
Adrian Sampson
f6dc981217 Edit docs from #2576 for brevity
Fixes #1741.
2017-06-10 20:42:18 -04:00
Scott Leggett
348e04464a Remove absolute paths from sample script. 2017-05-26 07:26:07 +10:00
Scott Leggett
a93414dc9d Document gapless mp3 encoding. 2017-05-25 22:53:22 +10:00
Adrian Sampson
272aa88703 Expand convert format config docs (fix #2384) 2017-01-12 13:16:35 -05:00
Jack Wilsdon
be897e964a Specify the optionality of the file extension in documentation
Also change "command-line" to "command" for accuracy.
2016-04-29 14:54:23 +01:00
Adrian Sampson
5b5a8c5a6d Minor docs refinements for #1894 2016-02-27 09:59:34 -08:00
Ali Graham
a98bc481cd tweaks for style, option name 2016-02-27 19:05:56 +10:30
Ali Graham
b59792c7a8 doc note for new copy_album_art_maxwidth option 2016-02-25 21:35:39 +10:30
Mara Kim
ddca1b2e13 Add 'tmpdir' option to convert plugin
Closes sampsyo/beets#1382

Add tmpdir setting

document tmpdir setting
2015-03-27 02:11:33 -05:00
Fabrice Laporte
e54254b69e fix #1076 2014-11-09 08:50:05 +01:00
Fabrice Laporte
5d25dbc0d6 docs: convert.rst, fix options order 2014-11-08 07:15:47 +01:00
Fabrice Laporte
f7ecb9cbae doc: emphasize options names by using bold font instead of fixed width 2014-11-07 22:13:25 +01:00
Angel Alonso
ad9786ce81 convert: update documentation and add a trailing comma. 2014-11-02 10:58:46 +01:00
Adrian Sampson
e80f84e666 Typo fixes 2014-10-31 09:48:19 -07:00
Adrian Sampson
f7fe10a376 make auto: Ignore "deleted" events
vim's atomic writes delete the file and then re-add it, which was leading to
Sphinx being triggered twice.
2014-10-30 15:54:39 -07:00
Adrian Sampson
a253eb4f72 Refresh without scrolling to top 2014-10-30 14:37:02 -07:00
Adrian Sampson
613c85ad6e Plugin docs overhaul tweaks through "duplicates"
Moving alphabetically through the docs. Got a long way to go...
2014-10-30 11:42:27 -07:00
Fabrice Laporte
ca1d6a9899 always a colon between the option name and the rest of the description
plus typos and case change
2014-10-29 22:33:13 +01:00
Fabrice Laporte
b922abef06 docs: remove space before colon 2014-10-28 23:23:44 +01:00