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.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6ddd1315a5bec07ffbb2f0ead1dc2d0e94ab256df8793a1a273f2bc600d4563b |
|
MD5 | c54de0518a29d794dd7e59092c80d0fc |
|
BLAKE2b-256 | 82487daffc35a0de1d57d3a1985ab6b27e90f4b1d2ed5f9483779f60383794ab |