beets/docs/plugins
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
..
absubmit.rst
acousticbrainz.rst
advancedrewrite.rst
albumtypes.rst
aura.rst
autobpm.rst
badfiles.rst
bareasc.rst
beatport.rst
beetsweb.png
bpd.rst
bpm.rst
bpsync.rst
bucket.rst
chroma.rst
convert.rst
deezer.rst
discogs.rst
duplicates.rst
edit.rst
embedart.rst
embyupdate.rst
export.rst
fetchart.rst
filefilter.rst
fish.rst
freedesktop.rst
fromfilename.rst
ftintitle.rst
fuzzy.rst
hook.rst
ihate.rst
importadded.rst
importfeeds.rst
importsource.rst
index.rst
info.rst
inline.rst
ipfs.rst
keyfinder.rst
kodiupdate.rst
lastgenre.rst
lastimport.rst
limit.rst
listenbrainz.rst
loadext.rst
lyrics.rst
mbcollection.rst
mbpseudo.rst
mbsubmit.rst
mbsync.rst
metasync.rst
missing.rst
mpdstats.rst
mpdupdate.rst
musicbrainz.rst
parentwork.rst
permissions.rst
play.rst
playlist.rst
plexupdate.rst
random.rst
replace.rst
replaygain.rst
rewrite.rst
scrub.rst
shared_metadata_source_config.rst
smartplaylist.rst
sonosupdate.rst
spotify.rst
subsonicplaylist.rst
subsonicupdate.rst
substitute.rst
the.rst
thumbnails.rst
titlecase.rst
types.rst
unimported.rst
web.rst
zero.rst