Skip to main content

audiobook-dl

GitHub release GitHub top language License Donate using Ko-Fi

CLI tool for downloading audiobooks from online sources.

Supported Services

audiobook-dl currently supports downloading from the following sources:

More info

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:

  • title
  • author
  • series
  • narrator

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)

Source distribution for audiobook-dl 0.7.3
File Size Uploaded
audiobook-dl-0.7.3.tar.gz 51.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for audiobook-dl 0.7.3
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.7.3 This release

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page