Skip to main content

Python interface to the Subler style metadata tagging.

Project description

Travis CI Status Coverage

Simple Python interface to the SublerCLI utility to make scripting metadata tagging with SublerCLI. even easier. Full documentation can be found on Read The Docs.


Installing is as easy as

$ pip install subler


To construct metadata you simply create a collection of Metadata Atoms like so,

>>> artist = Atom('Artist', 'Linkin Park')
>>> album = Atom('Album', 'Hybrid Theory')
>>> metadata = [artist, album]


Then, you simply pass that through to a Subler instance and use the Subler tag method, like so,

>>> subler = Subler(path_to_source_file, dest=path_to_dest_file,
>>> subler.tag()

Interactive Tagging

As of PySubler version 0.4.0 you can optionally use the pysubler command line utility to interactively write metadata to your files. More information is provided in the Docs, but the gist of interactive tagging is to run the pysubler cli like so

$ pysubler /path/to/your/file.m4v

You will then be prompted with a template that you can fill in with all sorts of provided metadata that will then be written to your file.

Release History

0.4.2 (2015-07-21)

  • Fixed an issue with improperly escaping metadata for use with subprocess.check_output

  • Added improved DEBUG logging for generated commands and their results

  • Improved the default Subler.dest attibute to create a unique destination filename

  • Added a collection of automated tests for Travis CI

  • Added Travis CI support

0.4.0 (2014-09-20)

  • Added module

  • Added subler.cli module which provides the interactive pysubler commandline tool

  • Added subler.subler.Subler.existing_metadata_collection property

  • Fixed bug with default Subler dest attribute

0.3.1 (2014-09-14)

  • Bug fix to keep RTD happy

0.3.0 (2014-09-14)

  • Addition of subler.utils module for utility functions

  • More intuitive SublerCLI executable path discovery

  • Added better shell escaping for SublerCLI arguments

  • Fixed SublerCLI version property

  • Fixed tracks property for outputting the track listings of the source file

  • Subler existing_metadata property is now returned as a list of Atoms

0.2.0 (2014-06-21)

  • Initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

subler-0.4.2.tar.gz (9.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page