Skip to main content

Build Status

Audiobooks from mp3 with broken tags

Fix mp3 files tags to convert them into iTunes/iPhone audiobooks..

  • Fixes sort order.
  • Supports messed encoding like cyrillic Win1251.

Details in my blog's article.

MacOS

brew update brew install libmagic

Python dependencies

Note the dot before ./activate.sh:

. ./activate.sh

Usage

python src/itunes_audiobook_from_mp3.py
     [folder]
     [-h]
     [--encoding ENCODING]
     [--extension EXTENSION]
     [--set-tag [SET_TAG [SET_TAG ...]]]
     [--track-num TRACK_NUM] [--fix FIX]
     [--dry DRY]

positional arguments:

  • folder Folder to process

optional arguments:

  • -h, --help show this help message and exit
  • --encoding ENCODING mp3 tags encoding. "none" if you do not need mp3 tags encoding fix.
  • --extension EXTENSION Files extension.
  • --set-tag [SET_TAG [SET_TAG ...]] Change mp3 tag to specified string. Format "tag- name/tag-value".
  • --track-num TRACK_NUM Set mp3 tag track_num as specified. - - file number for files sorted by names. Use none if you do not want to set this tag.
  • --fix Process and fix files.
  • --dry DRY Just dry run without files fix.

For example:

python src/itunes_audiobook_from_mp3 --fix --set-tag="album_artist/Юрий Заборовский (Ардис)"

  • Convers all .mp3 files in current folder and subfolders, fix encoding supposing
  • that original encoding was Windows 1251, and change tag album artist.
  • Also it will set track_num mp3 tag to file number as ordered by file name.

Metadata

Release files for audiobook-tags 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for audiobook-tags 0.1.0
File Size Uploaded Provenance Actions
audiobook-tags-0.1.0.tar.gz 3.1 kB Without provenance Details for audiobook-tags-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for audiobook-tags 0.1.0
File Interpreter ABI Platform Actions
audiobook_tags-0.1.0-py3-none-any.whl Python 3 none any Details for audiobook_tags-0.1.0-py3-none-any.whl

Total release size: 6.4 kB

Release files / audiobook-tags-0.1.0.tar.gz

Download URL audiobook-tags-0.1.0.tar.gz
Size 3.1 kB
Tags Source
SHA-256 checksum
How to use checksums
00679f76170141b4d1169b203ed6a5484fd504e4b1c91af89c9f39a692756503
BLAKE2b-256 checksum
How to use checksums
31fc97a8e29a3cd6edf68da29cf8012676847f6d93c44b653eead11ed8afb2c3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.4

Release files / audiobook_tags-0.1.0-py3-none-any.whl

Download URL audiobook_tags-0.1.0-py3-none-any.whl
Size 3.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6bfba70ad024899d5ebe789fedd6299f06d774613bca71962233661bd1591a52
BLAKE2b-256 checksum
How to use checksums
af8a3a7ac6229e305ea94787f3b9f044bf6b61e18691f1281130f7913bc0ccce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.4

Security for audiobook-tags 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page