semvec/pypi-packages huggingface dataset:
beets-copyartifacts 0.1.2
beets plugin to copy non-music files to import path
License: MIT

copyartifacts plugin for beets
==============================

A plugin that moves non-music files during the import process.

This is a plugin for `beets <http://beets.radbox.org/>`__: a music
library manager and much more.

Installing
----------

Installation of the plugin can be done using pip:

::

    pip install beets-copyartifacts

or by using these commands:

::

    git clone https://github.com/sbarakat/beets-copyartifacts.git
    cd beets-copyartifacts
    python setup.py install

If you get permission errors try running it with ``sudo``

You will then need to enable the plugin in beets' config.yaml

::

    plugins: copyartifacts

Configuration
-------------

It can copy files by file extenstion:

::

    copyartifacts:
        extensions: .cue .log

Or copy all non-music files (it does this by default):

::

    copyartifacts:
        extensions: .*

It can also print what got left:

::

    copyartifacts:
        print_ignored: yes

Renaming files
~~~~~~~~~~~~~~

Renaming works in much the same way as beets `Path
Formats <http://beets.readthedocs.org/en/v1.3.3/reference/pathformat.html>`__
with the following limitations: - The fields available are ``$artist``,
``$albumartist``, ``$album`` and ``$albumpath``. - The full set of
`built in
functions <http://beets.readthedocs.org/en/v1.3.3/reference/pathformat.html#functions>`__
are also supported, with the exception of ``%aunique`` - which will
return an empty string.

Each template string uses a query syntax for each of the file
extensions. For example the following template string will be applied to
``.log`` files:

::

    paths:
        ext:log: $albumpath/$artist - $album

This will rename a log file to:
``~/Music/Artist/2014 - Album/Artist - Album.log``

Example config
~~~~~~~~~~~~~~

::

    plugins: copyartifacts

    paths:
        default: $albumartist/$year - $album/$track - $title
        singleton: Singletons/$artist - $title
        ext:log: $albumpath/$artist - $album
        ext:cue: $albumpath/$artist - $album
        ext:jpg: $albumpath/cover

    copyartifacts:
        extensions: .cue .log .jpg
        print_ignored: yes

Thanks
------

copyartifacts was built on top of the hard work already done by Adrian
Sampson and the larger community on
`beets <http://beets.radbox.org/>`__. We have also benefited from the
work of our
`contributors <https://github.com/sbarakat/beets-copyartifacts/graphs/contributors>`__.

This plugin was built out of necessity and to scratch an itch. It has
gained a bit of attention, so I intend to maintain it where I can,
however I doubt I will be able to spend large amount of time on it.
Please report any issues you may have and feel free to contribute.

License
-------

Copyright (c) 2015 Sami Barakat

Licensed under the `MIT
license <https://github.com/sbarakat/beets-copyartifacts/blob/master/MIT-LICENSE.txt>`__.