Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2025-12-26 02:24:33 +01:00
Code Issues Projects Releases Wiki Activity

docs: update cookbook for modern beets

Browse source
This commit is contained in:
Carl Suster 2019-06-02 22:24:49 +10:00
parent aa9e39327d
commit 176fac781f
1 changed files with 13 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
docs/guides/advanced.rst
View file

@ -158,28 +158,28 @@ Automatically add new music to your library
As a command-line tool, beets is perfect for automated operation via a cron job
or the like. To use it this way, you might want to use these options in your
`config file`_::
:doc:`config file </reference/config>`:
[beets]
import_incremental: yes
import_quiet: yes
import_log: /path/to/log.txt
.. code-block:: yaml
The ``import_incremental`` option will skip importing any directories that have
import:
incremental: yes
quiet: yes
log: /path/to/log.txt
The :ref:`incremental` option will skip importing any directories that have
been imported in the past.
``import_quiet`` avoids asking you any questions (since this will be run
:ref:`quiet` avoids asking you any questions (since this will be run
automatically, no input is possible).
You might also want to use the ``import_quiet_fallback`` options to configure
You might also want to use the :ref:`quiet_fallback` options to configure
what should happen when no near-perfect match is found -- this option depends
on your level of paranoia.
Finally, ``import_log`` will make beets record its decisions so you can come
Finally, :ref:`import_log` will make beets record its decisions so you can come
back later and see what you need to handle manually.
The last step is to set up cron or some other automation system to run
``beet import /path/to/incoming/music``.
.. _config file: http://beets.readthedocs.org/page/reference/config.html
Useful reports
--------------
@ -193,17 +193,13 @@ powerful queries to run on your library.
* See a list of all albums with the tracks listed in order of bit rate::
beet ls -f '$bitrate $artist - $title' | sort -n
* See a list of all albums with the tracks listed in order of sample rate::
beet ls -f '$samplerate $artist - $title' | sort -n
beet ls -f '$bitrate $artist - $title' bitrate+
* See a list of albums and their formats::
beet ls -f '$albumartist $album $format' | sort | uniq
Note that ``beet ls --album -f '... $format'`` doesn't do what you want,
because there is no notion of an album format.
because ``format`` is an item-level field, not an album-level one.
If an album's tracks exist in multiple formats, the album will appear in the
list once for each format.