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.
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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
