Skip to main content
Help us improve Python packaging – donate today!

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.

Install

Installing is as easy as

$ pip install subler

Atoms

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]

Tagging

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,
                    metadata=metadata)
>>> 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 subler.tools 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

Release history Release notifications

This version
History Node

0.4.2

History Node

0.4.1

History Node

0.4.0

History Node

0.3.1

History Node

0.2.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
subler-0.4.2.tar.gz (9.1 kB) Copy SHA256 hash SHA256 Source None Jul 21, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page