mirror of
https://github.com/beetbox/beets.git
synced 2025-12-30 12:32:33 +01:00
79 lines
2.8 KiB
ReStructuredText
79 lines
2.8 KiB
ReStructuredText
Yamleditor Plugin
|
|
================
|
|
The ``yamleditor`` plugin lets you open the tags, fields from a group of items
|
|
, edit them in a text-editor and save them back.
|
|
|
|
You simply put in a query like you normally do in beets.
|
|
|
|
beet yamleditor beatles
|
|
beet yamleditor beatles -a
|
|
beet yamleditor beatles -f'$title-$lyrics'
|
|
|
|
|
|
You get a list of hits and then you can edit them.
|
|
The ``yamleditor`` opens your standard text-editor with a list of your hits
|
|
and for each hit a bunch of fields.
|
|
|
|
Without anything specified in your ``config.yaml`` for ``yamleditor:``
|
|
you will get
|
|
|
|
track-$title-$artist-$album for items
|
|
and
|
|
|
|
$album-$albumartist for albums
|
|
|
|
you can get more fields from the cmdline by adding
|
|
|
|
-f '$genre $added'
|
|
or
|
|
|
|
-e '$year $comments'
|
|
|
|
If you use ``-f '$field $field'`` you get *only* what you specified.
|
|
|
|
If you use ``-e '$field $field'`` you get what you specified *extra*.
|
|
|
|
-f or -e '$_all' gets you all the fields
|
|
|
|
After you edit the values in your text-editor - *and you may only edit the values,
|
|
no deleting fields or adding fields!* - you save the file, answer with y on ``Done`` and
|
|
you get a summary of your changes.
|
|
Check em, answer y or n and the changes are written to your library.
|
|
|
|
Configuration
|
|
------------
|
|
|
|
Make a ``yamleditor:`` section in your config.yaml ``(beet config -e)``
|
|
|
|
yamleditor:
|
|
editor: # specify the editor you like
|
|
editor_args: # additional arguments for editor
|
|
diff_method: ndiff # 4 different ways to view your changes
|
|
diff_method: unified # Pick one. See ex https://pymotw.com/2/difflib/
|
|
diff_method: html # for details or just try it :)
|
|
diff_method: vimdiff # this opens up vim diff
|
|
html_viewer: # viewer to see the diff_method html
|
|
html_args : # additional arguments for the viewer
|
|
albumfields: genre album # a list of albumfields to edit
|
|
itemfields: track artist # a list of itemfields to edit
|
|
not_fields: id path # list of not-wanted fields
|
|
separator: "|>" # something that separates printed fields
|
|
|
|
* You can pick 1 of the diff-methods (or none and you get the beet way).
|
|
If you pick ``html`` you can specify a viewer for it. If not the systems-default
|
|
will be picked.
|
|
|
|
* The ``albumfields`` and ``itemfields`` let you put in a list of fields you want to change.
|
|
``albumfields`` gets picked if you put -a in your search query else ``itemfields``. For a list of fields
|
|
do the ``beet fields``.
|
|
|
|
* The ``not_fields`` always contain ``id`` and standard also the ``path``.
|
|
Don't want to mess with them.
|
|
|
|
* The default ``separator`` prints like:
|
|
|
|
-02-The Night Before-The Beatles-Help!
|
|
|
|
but with ex "|>" it will look like:
|
|
|
|
|>02|>The Night Before|>The Beatles|>Help!
|