CLI tool for downloading audiobooks from online sources.
audiobook-dl currently supports downloading from the following sources:
audiobook-dl can be installed from the repo itself or through pip.
To get the newest stable version with pip run:
pip install audiobook-dl
If you want to use the newest version (can be unstable) run:
pip install "git+https://github.com/jo1gi/audiobook-dl.git"
or
git clone https://github.com/jo1gi/audiobook-dl.git
cd audiobook-dl
python3 setup.py install
Some features require ffmpeg which can be installed through most package managers or from ffmpeg.org/download.html.
audiobook-dl uses Netscape cookie files for authentication in most cases. I use this extension to export my cookies from the browser.
Cookies can be placed in current dir as cookies.txt or be given with the
--cookie argument.
Some sources support authentication through login with
username and password (and sometimes library). Use the --username and
--password arguments or enter them through an interactive prompt.
audiobook-dl -c <cookie file> <url>
Most sites require you to provide the listening page not not just the information page
| Argument | Value |
|---|---|
| url | The url of the page where you listen to the audiobook |
| -c/--cookie | Path to a Netscape cookie file |
| --combine | Combine all output files into a single file (requires ffmpeg) |
| --cover | Only download cover |
| -d/--debug | Print debug information |
| -o/--output | Output location |
| --remove-chars | List of characters that will be removed from output path |
| --no-chapters | Don't include chapters in output file |
| --output-format | Output file format |
| --verbose--ffmpeg | Show ffmpeg output in terminal |
| --username | Username to source (Required when using login) |
| --password | Password to source (Required when using login) |
| --library | Specific library on service (Sometimes required when using login) |
By default, audiobook-dl saves all audiobooks to {title} relative to the
current path. This can be changed with the --output argument. Path can be
customized by audiobook with the following fields:
titleauthorseriesnarratorNot all fields are available for all audiobooks.
The file extension can be changed with the --output-format argument.
Issues, bug-reports, pull requests or ideas for features and improvements are very welcome.
If you like the project, please consider donating:
FAQs
CLI tool for downloading audiobooks from online sources
We found that audiobook-dl demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Malicious Go packages are impersonating popular libraries to install hidden loader malware on Linux and macOS, targeting developers with obfuscated payloads.
Security News
Bybit's $1.46B hack by North Korea's Lazarus Group pushes 2025 crypto losses to $1.6B in just two months, already surpassing all of 2024's $1.49B total.
Security News
OpenSSF has published OSPS Baseline, an initiative designed to establish a minimum set of security-related best practices for open source software projects.