Skip to main content
`Ctrl`+`K`

# 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