mirror of
https://github.com/beetbox/beets.git
synced 2025-12-07 09:04:33 +01:00
cb350de2ea
Add a configuration section that lists all options for each plugin. List options in alphabetic order. Mention the default value for each option. Use same sentences to describe concepts common to different plugins eg 'auto option, install description
25 lines
1 KiB
ReStructuredText
25 lines
1 KiB
ReStructuredText
Random Plugin
|
|
=============
|
|
|
|
The ``random`` plugin provides a command that randomly selects tracks or albums
|
|
from your library. This can be helpful if you need some help deciding what to
|
|
listen to.
|
|
|
|
First, enable the plugin named ``random`` (see :ref:`using-plugins`). You'll
|
|
then be able to use the ``beet random`` command::
|
|
|
|
$ beet random
|
|
Aesop Rock - None Shall Pass - The Harbor Is Yours
|
|
|
|
The command has several options that resemble those for the ``beet list``
|
|
command (see :doc:`/reference/cli`). To choose an album instead of a single
|
|
track, use ``-a``; to print paths to items instead of metadata, use ``-p``; and
|
|
to use a custom format for printing, use ``-f FORMAT``.
|
|
|
|
If the ``-e`` option is passed, the random choice will be even among
|
|
artists (the albumartist field). This makes sure that your anthology
|
|
of Bob Dylan won't make you listen to Bob Dylan 50% of the time.
|
|
|
|
The ``-n NUMBER`` option controls the number of objects that are selected and
|
|
printed (default 1). To select 5 tracks from your library, type ``beet random
|
|
-n5``.
|