mirror of
https://github.com/beetbox/beets.git
synced 2025-12-09 01:54:08 +01:00
*All* URLs were checked manually, but only once per domain! I mostly concerned myself with URLs in documentation rather than source code because the latter may or may not have impactful changes, while the former should be straight forward. Changes in addition to simply adding an s: - changed pip and pypi references as their location has changed - MPoD (iOS app) url redirects to Regelian, so I replaced those - updated homebrew references Notable observations: - beets.io does have HTTPS set up properly (via gh-pages) - beatport.py uses the old HTTP url for beatport - as does lyrics.py for lyrics.wikia.com - https://tomahawk-player.org/ expired long ago, but the http page redirects to https regardless - none of the sourceforge subdomains have https (in 2019!)
45 lines
1.6 KiB
ReStructuredText
45 lines
1.6 KiB
ReStructuredText
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 simple glob patterns where ``*`` matches any
|
||
string. For example::
|
||
|
||
$ beet info -i 'title,mb*' beatles
|
||
|
||
Will only show the ``title`` property and all properties starting with
|
||
``mb``. 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.
|
||
* ``--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/
|