Metadata-Version: 2.1
Name: mp3chaps
Version: 0.4
Summary: tool for inserting chapter marks in mp3 files
Home-page: https://github.com/dskrad/mp3chaps
Author: David Karimeddini
Author-email: dskcl1@gmail.com
License: MIT
Keywords: mp3 chapters
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Dist: docopt (>=0.6.2)
Requires-Dist: eyeD3 (>=0.9.5)


mp3chaps
========

commandline utility for adding chapter marks to mp3 files similar to ``mp4chaps`` utility

many pocast apps on Android and iOS support chapter markers in both mp4 (aac) and mp3 files

this utilizes the excellent `eyeD3 <https://github.com/nicfit/eyeD3>`_ tagging module to read and write chapter frames and title subframes

requirements
------------
Python 3 (Python 2 is no longer supported)

installation
------------

``pip3 install mp3chaps``

usage
-----

assuming you have a file named ``episode_42.mp3``, ``mp3chaps`` looks for a chapter marks file called ``episode_42.chapters.txt`` in the same directory::

    00:00:00.000 Introduction
    00:02:00.000 Chapter Title
    00:42:24.123 Chapter Title

add chapter marks
-----------------
add (import) chapter marks from text file (unexpected results may occur if chapters already exist, for best results remove chapters first with -r)

``mp3chaps -i episode_42.mp3``

If you run into errors, try using ASCII. There have been some issue with Unicode.

list chapters
-------------

``mp3chaps -l episode_42.mp3``

remove chapters
---------------

``mp3chaps -r episode_42.mp3``


