File: ihate.rst

package info (click to toggle)
beets 2.2.0-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 8,536 kB
  • sloc: python: 45,608; javascript: 7,997; xml: 334; sh: 261; makefile: 119
file content (37 lines) | stat: -rw-r--r-- 1,071 bytes parent folder | download | duplicates (5)
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
IHate Plugin
============

The ``ihate`` plugin allows you to automatically skip things you hate during
import or warn you about them. You specify queries (see
:doc:`/reference/query`) and the plugin skips (or warns about) albums or items
that match any query.

To use the ``ihate`` plugin, enable it in your configuration (see
:ref:`using-plugins`).

Configuration
-------------

To configure the plugin, make an ``ihate:`` section in your configuration
file. The available options are:

- **skip**: Never import items and albums that match a query in this list.
  Default: ``[]`` (empty list).
- **warn**: Print a warning message for matches in this list of queries.
  Default: ``[]``.

Here's an example::

    ihate:
        warn:
            - artist:rnb
            - genre:soul
            # Only warn about tribute albums in rock genre.
            - genre:rock album:tribute
        skip:
            - genre::russian\srock
            - genre:polka
            - artist:manowar
            - album:christmas

The plugin trusts your decision in "as-is" imports.