audiobook-dl
CLI tool for downloading audiobooks from online sources.
Supported Services
audiobook-dl currently supports downloading from the following sources:
- audiobooks.com
- Blinkist
- Chirp
- eReolen
- Everand (previously Scribd)
- Librivox
- Nextory
- Overdrive / Libby
- Podimo
- Saxo
- Storytel / Mofibo
- YourCloudLibrary
Installation
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.
Authentication
Cookies
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.
Login
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.
Downloading audiobooks
audiobook-dl -c <cookie file> <url>
Most sites require you to provide the listening page not not just the information page
Arguments
| 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) |
Output
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:
titleauthorseriesnarrator
Not all fields are available for all audiobooks.
The file extension can be changed with the --output-format argument.
Contributions
Issues, bug-reports, pull requests or ideas for features and improvements are very welcome.
Donations
If you like the project, please consider donating:
Cryptocurrencies
- Bitcoin: bc1qrh8hcnw0fd22y7rmljlmrztwrz2nd5tqckrt44
- Bitcoin Cash: qp6rt9zx7tfyu9e4alxcn5yf4re5pfztvu8yx0rywh
- Dash: XfgopGkj4BBpuzsUvrbj9jenXUZ6dXsr3J
- Etherium: 0x8f5d2eb6d2a4d4615d2b9b1cfa28b4c5b9d18f9f
- Litecoin: ltc1qfz2936a04m2h7t0srxftygjrq759auav7ndfd3
- Monero: 853tLAbK5wQ93mdj884C31JGKBUEJCpM25gEjGGLnuVDc8PEDMJi6uC5Vcz9g37K2PeT8FY1bjEveUWqJXNPotFRLwLnn9a
Metadata
Release files for audiobook-dl 0.7.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| audiobook-dl-0.7.3.tar.gz | 51.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| audiobook_dl-0.7.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 118.6 kB
Release files / audiobook-dl-0.7.3.tar.gz
| Download URL | audiobook-dl-0.7.3.tar.gz |
|---|---|
| Size | 51.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
be8bdd514b3d518a727d21d71388fb2634fe56fc10914005670b9d49b8c04d10
|
|
BLAKE2b-256 checksum How to use checksums |
61f885ce982c7415ff9d116292cb8aa5d313abd50301ab34b2892921e1f92a73
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.10.12
|
Release files / audiobook_dl-0.7.3-py3-none-any.whl
| Download URL | audiobook_dl-0.7.3-py3-none-any.whl |
|---|---|
| Size | 67.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
06241ad7f6aed3ed28c25de1f00e2f4681d41e8a3b1bb34a034d53fc69098744
|
|
BLAKE2b-256 checksum How to use checksums |
d7267b02b8b33179f600803144c8c40b75e5d74dd689543ec51e53130d9a2d68
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.10.12
|