1ImportFeeds Plugin
2==================
3
4This plugin helps you keep track of newly imported music in your library.
5
6To use the ``importfeeds`` plugin, enable it in your configuration
7(see :ref:`using-plugins`).
8
9Configuration
10-------------
11
12To configure the plugin, make an ``importfeeds:`` section in your
13configuration file. The available options are:
14
15- **absolute_path**: Use absolute paths instead of relative paths. Some
16  applications may need this to work properly.
17  Default: ``no``.
18- **dir**: The output directory.
19  Default: Your beets library directory.
20- **formats**: Select the kind of output. Use one or more of:
21
22   - **m3u**: Catalog the imports in a centralized playlist.
23   - **m3u_multi**: Create a new playlist for each import (uniquely named by
24     appending the date and track/album name).
25   - **link**: Create a symlink for each imported item. This is the
26     recommended setting to propagate beets imports to your iTunes library:
27     just drag and drop the ``dir`` folder on the iTunes dock icon.
28   - **echo**: Do not write a playlist file at all, but echo a list of new
29     file paths to the terminal.
30
31  Default: None.
32- **m3u_name**: Playlist name used by the ``m3u`` format.
33  Default: ``imported.m3u``.
34- **relative_to**: Make the m3u paths relative to another
35  folder than where the playlist is being written. If you're using importfeeds
36  to generate a playlist for MPD, you should set this to the root of your music
37  library.
38  Default: None.
39
40Here's an example configuration for this plugin::
41
42    importfeeds:
43        formats: m3u link
44        dir: ~/imports/
45        relative_to: ~/Music/
46        m3u_name: newfiles.m3u
47