File: importfeeds.rst

package info (click to toggle)
beets 1.0~b14-2
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 1,876 kB
  • sloc: python: 12,200; makefile: 136
file content (24 lines) | stat: -rw-r--r-- 1,176 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
ImportFeeds Plugin
==================

The ``importfeeds`` plugin helps you keep track of newly imported music in your library.

To use the plugin, just put ``importfeeds`` on the ``plugins`` line in your
:doc:`/reference/config`::

    [beets]
    plugins: importfeeds

The ``feeds_dir`` parameter can be set to specify another folder than the default library directory.
Three different types of outputs coexist, specify the ones you want to use by setting the ``feeds_formats`` parameter: 

- ``m3u``: catalog the imports in a centralized playlist. By default, the playlist is named ``imported.m3u``. To use a different file, just set the ``m3u_name`` parameter inside the ``importfeeds`` config section.
- ``m3u_multi``: create a new playlist for each import (uniquely named by appending the date and track/album name). 
- ``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 ``feeds_dir`` folder on the iTunes dock icon.

An example of ``importfeeds`` configuration::

    [importfeeds]
    feeds_formats: m3u link
    feeds_dir: ~/imports/
    m3u_name: newfiles.m3u