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 Transparent background logo for docs 2023-10-29 10:30:33 +01:00
_templates/autosummary A number of smaller additions. 2025-09-04 12:49:43 +01:00
api Add index for API Reference 2025-09-04 12:49:48 +01:00
dev Move PromptChoice to beets.util module 2025-12-02 01:51:14 +00:00
extensions Add Sphinx extension for configuration value documentation 2025-10-19 01:34:32 +01:00
guides Update python version references 2025-11-08 12:09:52 +00:00
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 Streamlined auto api referencing for documentation (#5795) 2025-05-22 11:35:40 +02:00
changelog.rst Fix convert --format with never_convert_lossy_files (#6171) 2025-12-03 22:48:41 +01:00
code_of_conduct.rst Update docstrfmt 2025-09-04 12:49:44 +01:00
conf.py Add Sphinx extension for configuration value documentation 2025-10-19 01:34:32 +01:00
contributing.rst Update docstrfmt 2025-09-04 12:49:44 +01:00
faq.rst Run formatter. 2025-10-11 13:52:35 +02:00
index.rst Re-added macport instructions. Removed mailing list ref. Added section 2025-10-11 13:52:35 +02:00
Makefile Streamlined auto api referencing for documentation (#5795) 2025-05-22 11:35:40 +02:00
modd.conf Switch to modd for live docs build 2017-12-21 11:39:08 -05:00
team.rst Reformat all docs using docstrfmt 2025-08-10 16:25:05 +01:00