Metadata-Version: 2.1
Name: mp3chapters
Version: 0.5.0
Summary: tool for inserting chapter marks in mp3 files
Home-page: https://github.com/rfjaquez/mp3chapters
Author: rfjaquez
Author-email: rfjqz-github@yahoo.com
License: MIT
Keywords: mp3 chapters
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Requires-Dist: docopt (>=0.6.2)
Requires-Dist: eyeD3 (>=0.9.6)


mp3chapters
===========

 Command line utility for adding chapter marks to mp3 files.

 Many podcast and audiobook apps on Android and iOS support chapter markers in mp3 files

 This uses the `eyeD3 <https://github.com/nicfit/eyeD3>`_ lib to read and write the chapters details

requirements
------------
 Python 3

installation
++++++++++++

 ``pip3 install mp3chapters``

usage
+++++

 The chapter markers format should be in either::
 
 - Timecode: hours:minutes:seconds.milliseconds + space + chapter title
 - Milliseconds: milliseconds (whole) + space + chapter title
 - Audacity: seconds (floating point) + tab + seconds (no used) + tab + chapter title

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 
 
 00000000 Introduction 
 00060000 Chapter Title 
 00276123 Chapter Title 
 
 0.000000	0.000000	Introduction 
 85.180378	85.180378	Chapter Title 
 543.822379	543.822379	Chapter Title 

Add chapter marks
++++++++++++++++++
 
 Add (import) chapter marks from text file (if chapters already exist, remove first with the option -r) 
 
 ``mp3chaps -i episode_42.mp3``

Remove chapters
+++++++++++++++
 
 ``mp3chaps -r episode_42.mp3`` 

List chapters
+++++++++++++
 ``mp3chaps -l episode_42.mp3``

List chapters with frame details
++++++++++++++++++++++++++++++++
 
 ``mp3chaps -p episode_42.mp3`` 

Export chapters to <filename>.chaps.txt::
+++++++++++++++++++++++++++++++++++++++++
 with **timecode** markers 
 
 ``mp3chaps -e=tc episode_42.mp3``

 with **milliseconds** markers 
 
 ``mp3chaps -e=ms episode_42.mp3``

Add test chapters marks
+++++++++++++++++++++++
 ``mp3chaps -t episode_42.mp3``
