beets/docs
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
..
_static
_templates/autosummary
api
dev Move PromptChoice to beets.util module 2025-12-02 01:51:14 +00:00
extensions
guides
plugins Fix convert --format with never_convert_lossy_files (#6171) 2025-12-03 22:48:41 +01:00
reference Add album template value in ftintitle plugin 2025-11-21 18:31:59 +01:00
.gitignore
changelog.rst Fix convert --format with never_convert_lossy_files (#6171) 2025-12-03 22:48:41 +01:00
code_of_conduct.rst
conf.py
contributing.rst
faq.rst
index.rst
Makefile
modd.conf
team.rst