Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python interface to the Subler style metadata tagging.

Project Description

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
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
subler-0.4.2.tar.gz (9.1 kB) Copy SHA256 Checksum SHA256 Source Jul 21, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting