| Name | mp3chaps2 JSON |
| Version |
1.0.5
JSON |
| download |
| home_page | None |
| Summary | A tool for managing MP3 chapter markers, modified from mp3chaps. The original version can be found here: https://github.com/dskrad/mp3chaps |
| upload_time | 2025-01-21 23:43:00 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.7 |
| license | None |
| keywords |
audio
chapters
metadata
mp3
podcast
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# mp3chaps2
Source code available [here](https://github.com/StevenZuber/mp3chaps2.git)
A robust command-line utility for managing chapter markers in MP3 files. This is an enhanced version of the original [mp3chaps](https://github.com/dskrad/mp3chaps) project, with improved error handling and reliability.
This utilizes the excellent [eyeD3](https://github.com/nicfit/eyeD3) tagging module to read and write chapter frames and title subframes.
## Features
- Add chapter markers from a text file
- List existing chapters
- Remove chapter markers
- Robust error handling and validation
- Compatible with podcast apps on Android and iOS
### Requirements
`Python >3.7`
### Installation
---
```bash
pip install mp3chaps2
```
### Usage
---
The tool looks for chapter marks in a companion .chapters.txt file. For example, if your audio file is `episode_42.mp3`, create `episode_42.chapters.txt` in the same directory:
```bash
00:00:00.000 Introduction
00:02:00.000 Main Topic Discussion
00:42:24.123 Closing Thoughts
```
If you run into errors, try using ASCII. There have been some issue with Unicode.
### Commands
```bash
# Add chapters (remove existing chapters first with -r for best results)
mp3chaps2 -i episode_42.mp3
# List existing chapters
mp3chaps2 -l episode_42.mp3
# Remove all chapters
mp3chaps2 -r episode_42.mp3
```
### Options
```bash
-h Show help text
-l List chapters in <filename>
-i Import chapters from <filename>.chapters.txt
-r Remove chapters from <filename>
```
### Development
---
If you want to modify this project locally, you can clone the repository and install the dependencies.
```bash
git clone https://github.com/StevenZuber/mp3chaps2.git
cd mp3chaps2
pip install -e .
```
Or you can install it with dependencies directly with:
```bash
pip install mp3chaps2[dev]
```
The `requirements.txt` file is also available for poeple who prefer that approach.
`pip install -r requirements.txt`
### License
MIT License
Raw data
{
"_id": null,
"home_page": null,
"name": "mp3chaps2",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "audio, chapters, metadata, mp3, podcast",
"author": null,
"author_email": "Steven Zuber <stevenjzuber@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/92/b0/e1aa2b198c6d723ae618a3596298dcde74164c0fb6acd011c67693a151d8/mp3chaps2-1.0.5.tar.gz",
"platform": null,
"description": "# mp3chaps2\n\nSource code available [here](https://github.com/StevenZuber/mp3chaps2.git)\n\nA robust command-line utility for managing chapter markers in MP3 files. This is an enhanced version of the original [mp3chaps](https://github.com/dskrad/mp3chaps) project, with improved error handling and reliability.\n\nThis utilizes the excellent [eyeD3](https://github.com/nicfit/eyeD3) tagging module to read and write chapter frames and title subframes.\n\n## Features\n\n- Add chapter markers from a text file\n- List existing chapters\n- Remove chapter markers\n- Robust error handling and validation\n- Compatible with podcast apps on Android and iOS\n\n### Requirements\n\n`Python >3.7`\n\n### Installation\n\n---\n\n```bash\npip install mp3chaps2\n```\n\n### Usage\n\n---\n\nThe tool looks for chapter marks in a companion .chapters.txt file. For example, if your audio file is `episode_42.mp3`, create `episode_42.chapters.txt` in the same directory:\n\n```bash\n00:00:00.000 Introduction\n00:02:00.000 Main Topic Discussion\n00:42:24.123 Closing Thoughts\n```\n\nIf you run into errors, try using ASCII. There have been some issue with Unicode.\n\n### Commands\n\n```bash\n# Add chapters (remove existing chapters first with -r for best results)\nmp3chaps2 -i episode_42.mp3\n\n# List existing chapters\nmp3chaps2 -l episode_42.mp3\n\n# Remove all chapters\nmp3chaps2 -r episode_42.mp3\n```\n\n### Options\n\n```bash\n-h Show help text\n-l List chapters in <filename>\n-i Import chapters from <filename>.chapters.txt\n-r Remove chapters from <filename>\n```\n\n### Development\n\n---\nIf you want to modify this project locally, you can clone the repository and install the dependencies.\n\n```bash\ngit clone https://github.com/StevenZuber/mp3chaps2.git\ncd mp3chaps2\npip install -e .\n```\n\nOr you can install it with dependencies directly with:\n\n```bash\npip install mp3chaps2[dev]\n```\n\nThe `requirements.txt` file is also available for poeple who prefer that approach.\n\n`pip install -r requirements.txt`\n\n### License\n\nMIT License\n",
"bugtrack_url": null,
"license": null,
"summary": "A tool for managing MP3 chapter markers, modified from mp3chaps. The original version can be found here: https://github.com/dskrad/mp3chaps",
"version": "1.0.5",
"project_urls": null,
"split_keywords": [
"audio",
" chapters",
" metadata",
" mp3",
" podcast"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ad3bdd346db586ff5f24d6bc5cc4c8f8218eebe989001cc4204c1523d6f50b94",
"md5": "e8367b8260a673c5715c46fea4ff0f10",
"sha256": "86badc6cf4f8c39f1a83262e6d382d84c0ba9d764bcdf2af4cb8dd832e78dd28"
},
"downloads": -1,
"filename": "mp3chaps2-1.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e8367b8260a673c5715c46fea4ff0f10",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 6469,
"upload_time": "2025-01-21T23:42:57",
"upload_time_iso_8601": "2025-01-21T23:42:57.422361Z",
"url": "https://files.pythonhosted.org/packages/ad/3b/dd346db586ff5f24d6bc5cc4c8f8218eebe989001cc4204c1523d6f50b94/mp3chaps2-1.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "92b0e1aa2b198c6d723ae618a3596298dcde74164c0fb6acd011c67693a151d8",
"md5": "343c315b6a60ec2bf57f38e891f92ef6",
"sha256": "6e64657a4b69aa00fee5bed239a9ce03a6fade06d75374256f32bc34b0ab98dd"
},
"downloads": -1,
"filename": "mp3chaps2-1.0.5.tar.gz",
"has_sig": false,
"md5_digest": "343c315b6a60ec2bf57f38e891f92ef6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 7497,
"upload_time": "2025-01-21T23:43:00",
"upload_time_iso_8601": "2025-01-21T23:43:00.510235Z",
"url": "https://files.pythonhosted.org/packages/92/b0/e1aa2b198c6d723ae618a3596298dcde74164c0fb6acd011c67693a151d8/mp3chaps2-1.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-21 23:43:00",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "mp3chaps2"
}
