Skip to main content

Fix mp3 tags to use in iTunes/iPhone audiobooks

Project description

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.

Installation

You should have Python 3.6+ installed.

pip install audiobook-tags

Usage

audiobook-tags [-h] [--encoding ENCODING] [--extension EXTENSION] [--set-tag [SET_TAG ...]] [--track-num TRACK_NUM] [--title-prefix TITLE_PREFIX] [--dry] [folder]

Fixes mp3 tags for iOS audiobooks.

positional arguments:
  folder                Folder to process, do not add file name.

options:
  -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 including dot, for example `.mp3`.
  --set-tag [SET_TAG ...]
                        Change mp3 tag to specified string. Format "tag-name/tag-value".
  --track-num TRACK_NUM
                        Sort files and set mp3 tag `track_num`: TRACK_NUM=`name` - sort by names; TRACK_NUM=`tag-<TAG>` - sort by mp3 tag with name <TAG>.
  --title-prefix TITLE_PREFIX
                        Prefix each file title with the track number for the file.
  --dry                 Dry run without changing files.

Example:

audiobook-tags --set-tag="album_artist/Юрий Заборовский (Ардис)" --track-num="name"
  • Convers all .mp3 files in current folder and subfolders
  • fix encoding supposing that original encoding was Windows 1251
  • change tag album artist.
  • set track_num mp3 tag to file number as ordered by file name

Development

OS Dependencies

MacOS

brew update brew install libmagic

Python dependencies

Note the dot before ./activate.sh:

. ./activate.sh

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

audiobook-tags-1.0.0.tar.gz (3.2 kB view hashes)

Uploaded Source

Built Distribution

audiobook_tags-1.0.0-py3-none-any.whl (3.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page