Skip to main content

copyartifacts plugin for beets

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

This is a plugin for beets: 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 with the following limitations: - The fields available are $artist, $albumartist, $album and $albumpath. - The full set of built in 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. We have also benefited from the work of our 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.

Metadata

Release files for beets-copyartifacts 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for beets-copyartifacts 0.1.2
File Size Uploaded Provenance Actions
beets-copyartifacts-0.1.2.tar.gz 4.2 kB Without provenance Details for beets-copyartifacts-0.1.2.tar.gz

Release files / beets-copyartifacts-0.1.2.tar.gz

Download URL beets-copyartifacts-0.1.2.tar.gz
Size 4.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f244459ff5cd1e277657dfb3b841d0dc53c3a0f0f7721e3165f09f3bf5cfb3f3
BLAKE2b-256 checksum
How to use checksums
48e91384fb0fc444f9997f7f2faa1a820ef219c893bb77342c85a6e46af0db23
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for beets-copyartifacts 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page