mirror of
https://github.com/beetbox/beets.git
synced 2025-12-08 09:34:23 +01:00
28 lines
1.3 KiB
ReStructuredText
28 lines
1.3 KiB
ReStructuredText
Inline Plugin
|
|
=============
|
|
|
|
The ``inline`` plugin lets you use Python expressions to customize your path
|
|
formats. Using it, you can define template fields in your beets configuration
|
|
file and refer to them from your template strings in the ``[paths]`` section
|
|
(see :doc:`/reference/config/`).
|
|
|
|
To use inline field definitions, first enable the plugin by putting ``inline``
|
|
on your ``plugins`` line in your configuration file. Then, make a
|
|
``pathfields:`` block in your config file. Under this key, every line
|
|
defines a new template field; the key is the name of the field (you'll use the
|
|
name to refer to the field in your templates) and the value is a Python
|
|
expression. The expression has all of a track's fields in scope, so you can
|
|
refer to any normal attributes (such as ``artist`` or ``title``) as Python
|
|
variables. Here are a couple of examples::
|
|
|
|
pathfields:
|
|
initial: albumartist[0].upper() + u'.'
|
|
disc_and_track: u'%02i.%02i' % (disc, track) if
|
|
disctotal > 1 else u'%02i' % (track)
|
|
|
|
Note that YAML syntax allows newlines in values if the subsequent
|
|
lines are indented. These examples define ``$initial`` and
|
|
``$disc_and_track`` fields that can be referenced in path templates like so::
|
|
|
|
paths:
|
|
default: $initial/$artist/$album%aunique{}/$disc_and_track $title
|