From 8d06820d9a2ad288a3addb15b62d9920eb0b4b90 Mon Sep 17 00:00:00 2001 From: Adrian Sampson Date: Mon, 25 Nov 2013 14:55:43 -0800 Subject: [PATCH] docs: flexattrs guide in "advanced" guide --- docs/guides/advanced.rst | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/guides/advanced.rst b/docs/guides/advanced.rst index c7baad5e8..6b312d8a1 100644 --- a/docs/guides/advanced.rst +++ b/docs/guides/advanced.rst @@ -104,3 +104,28 @@ The plugin has many more dials you can fiddle with to get your conversions how you like them. Check out :doc:`its documentation `. .. _ffmpeg: http://www.ffmpeg.org + + +Store any data you like +----------------------- + +The beets database keeps track of a long list of :ref:`built-in fields +`, but you're not limited to just that list. Say, for example, +that you like to like to categorize your music by the setting where it should +be played. You can invent a new ``context`` attribute store this. Set the +field using the :ref:`modify-cmd` command:: + + beet modify context=party artist:'beastie boys' + +And then :doc:`query ` your music just as you would with any +other field:: + + beet ls context:mope + +You can even use these fields in your filenames (see +:ref:`path-format-config`). + +Read more than you ever wanted to know about the *flexible attributes* +feature `on the beets blog`_. + +.. _on the beets blog: http://beets.radbox.org/blog/flexattr.html