Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



39 Commits

Repository files navigation


A Beets plug-in that imports singles as soon as they are dropped in a folder.

You can provide a function to set meta-data or custom attributes depending on the sub-folder in which the file has been dropped. The examples folder contains some examples of on_item functions you may adapt to your needs.

We use Beets' auto-tagger in quiet mode, and inotify to detect dropped files.

Get started

You'll need Python3 and an existing Beets library. Run:

pip install drop2beets

Enable and configure the plug-in by running beet config -e and set at least the path to the "dropbox" folder.

plugins: drop2beets
    dropbox_path: ~/beets-dropbox

We advise you configure Beets to always move files out of the Dropbox, and set quiet_fallback:

    move: yes
    copy: no
    quiet_fallback: asis

quiet_fallback tells Beets what to do when the auto-tagger is not sure about the song's identifiaction. Set it to skip to abort the importation in case of ambiguity, or asis to import using tags as they are in the incoming file. This will avoid surprises in case of ambiguous matches, because this script invokes Beet's auto-tagger in quiet mode (as beet import -q) after your custom function.

This function is on_item. It is written in Python, and lets you set some tags depending of which sub-folder the file is dropped in. If you want one, define it in the configuration from this template:

    on_item: |
        def on_item(item, path):
                item: the beets Item that we're about to import
                path: its sub-folders path in our dropbox ; if the items has been dropped at the root, then it's empty.
                A dict of custom attributes (according to path, maybe) ; return None if you don't want to import the file right now.
            return {}

Now you're ready to test by calling beet dropbox on the command line and dropping a few files in the folder. Hit Ctrl+C to close the script.

For a longer-term installation, configure a log file path

    log_path: ~/drop2beets/log.log

Linux users can install this as a user-lever systemd service by running beet install_dropbox (in a shell where the virtual environment is activated). Note that you'll have to restart the service when you update the on_item function.

Examples wanted !

I'd be happy to include your own variations of this script or the on_item function in the examples folder, feel free to post them in Issues or Pull Requests.


a Beets plug-in that import singles as soon as they are dropped in a folder







No releases published


No packages published