File: info.rst

package info (click to toggle)
beets 2.5.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky
  • size: 7,988 kB
  • sloc: python: 46,429; javascript: 8,018; xml: 334; sh: 261; makefile: 125
file content (52 lines) | stat: -rw-r--r-- 1,667 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
Info Plugin
===========

The ``info`` plugin provides a command that dumps the current tag values for any
file format supported by beets. It works like a supercharged version of mp3info_
or id3v2_.

Enable the ``info`` plugin in your configuration (see :ref:`using-plugins`) and
then type:

::

    $ beet info /path/to/music.flac

and the plugin will enumerate all the tags in the specified file. It also
accepts multiple filenames in a single command-line.

You can also enter a :doc:`query </reference/query>` to inspect music from your
library:

::

    $ beet info beatles

If you just want to see specific properties you can use the ``--include-keys``
option to filter them. The argument is a comma-separated list of field names.
For example:

::

    $ beet info -i 'title,mb_artistid' beatles

Will only show the ``title`` and ``mb_artistid`` properties. You can add the
``-i`` option multiple times to the command line.

Additional command-line options include:

- ``--library`` or ``-l``: Show data from the library database instead of the
  files' tags.
- ``--album`` or ``-a``: Show data from albums instead of tracks (implies
  ``--library``).
- ``--summarize`` or ``-s``: Merge all the information from multiple files into
  a single list of values. If the tags differ across the files, print
  ``[various]``.
- ``--format`` or ``-f``: Specify a specific format with which to print every
  item. This uses the same template syntax as beets’ :doc:`path formats
  </reference/pathformat>`.
- ``--keys-only`` or ``-k``: Show the name of the tags without the values.

.. _id3v2: http://id3v2.sourceforge.net

.. _mp3info: https://www.ibiblio.org/mp3info/