A tool to standardize audiobook files into single m4b files with clean metadata based on Audible and chapters.
Project description
Functionality
The steps accomplished by using this tool are as follows:
- Easy batch inputs via
-i folder1/ folder2/* file.mp3
etc. - Only user input required is one ASIN per book.
- Converts mp3(s) into single m4b files
- Matches existing bitrate and samplerate for target file.
- Standardizes chapter names, like 'Chapter 1'.
- Merges or edits m4a/m4b into single m4b file, without re-converting.
- Moves input file/folder to
done
folder when processed.
Audible data features:
- Title, author(s), narrator(s), series, release year, description
- For generating folder structure
- For seeding M4b metadata fields
- Chapters (title and length) used for m4b/m4a inputs.
CLI usage
usage: m4b-merge [-h] -i INPUTS [INPUTS ...] [--log_level LOG_LEVEL]
m4b-merge cli
optional arguments:
-h, --help show this help message and exit
-i INPUTS [INPUTS ...], --inputs INPUTS [INPUTS ...]
Input paths to process
--log_level LOG_LEVEL
Set logging level
- Check the user editable variables in config.py, and see if there's anything you need to change.
- On first run, you will be prompted to signin to Audible. This is a one-time process that will be saved to your system's relevant config folder, under
m4b-merge
.
Module usage
If you are a developer wanting to use this in a project, you can import the modules as so:
from m4b_merge import audible_helper, config, helpers, m4b_helper
And then creating the objects you need (from audible_helper.BookData(asin)
and m4b_helper.M4bMerge(input_data, metadata)
)
You can see more usage examples in the sister project, Bragi Books
The parser
function in audible_helper.BookData
returns some extra data not used in the CLI here. This is a list of all data returned:
- Title
- Short Summary
- Long Summary
- Authors
- Narrators
- Series
- Release Date
- Publisher
- Language
- Runtime in minutes
- Format type (abridged, unabridged, other)
Credits
- Uses the audible package.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for m4b_merge-0.3.5.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 42bf067900bad17d916184412f3a87f9f576411b400dc01a2d37732b073ba2cc |
|
MD5 | c6520e134ea7200d628d35e8f43d00a3 |
|
BLAKE2b-256 | 5c4f7941b32feee68eeaf5f7db73681208c9fa34b645b71bb0917333dfda3766 |