ImportFeeds Plugin
******************

This plugin helps you keep track of newly imported music in your
library.

To use the "importfeeds" plugin, enable it in your configuration (see
Using Plugins).


Configuration
=============

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

* **absolute_path**: Use absolute paths instead of relative paths.
  Some applications may need this to work properly. Default: "no".

* **dir**: The output directory. Default: Your beets library
  directory.

* **formats**: Select the kind of output. Use one or more of:

     * **m3u**: Catalog the imports in a centralized playlist.

     * **m3u_multi**: Create a new playlist for each import (uniquely
       named by appending the date and track/album name).

     * **m3u_session**: Create a new playlist for each import session.
       The file is named as "m3u_name" appending the date and time the
       import session was started.

     * **link**: Create a symlink for each imported item. This is the
       recommended setting to propagate beets imports to your iTunes
       library: just drag and drop the "dir" folder on the iTunes dock
       icon.

     * **echo**: Do not write a playlist file at all, but echo a list
       of new file paths to the terminal.

  Default: None.

* **m3u_name**: Playlist name used by the "m3u" format and as a prefix
  used by the "m3u_session" format. Default: "imported.m3u".

* **relative_to**: Make the m3u paths relative to another folder than
  where the playlist is being written. If you're using importfeeds to
  generate a playlist for MPD, you should set this to the root of your
  music library. Default: None.

Here's an example configuration for this plugin:

   importfeeds:
       formats: m3u link
       dir: ~/imports/
       relative_to: ~/Music/
       m3u_name: newfiles.m3u
