Back to results
jo1gi/audiobook-dl(opens in a new tab)
Language: Python
Audiobook CLI downloader
- stars
- 523
- watchers
- 13
- forks
- 83
- open issues
- 77
- Last updated
- 07/02/2026
gem-hunterLanguage: Python
Audiobook CLI downloader
CLI tool for downloading audiobooks from online sources.
I'm currently looking for maintainers to support the different services. I don't use all the services and have a hard time keeping up the support.
If you are interested, please contact me on:
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 installSome 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.
audiobook-dl can be configured using a configuration file, which should be placed at:
C:\\Users\\$user\\AppData\\Local\\jo1gi\\audiobook-dl\\audiobook-dl.toml/Users/$user/Library/Application Support/audiobook-dl/audiobook-dl.toml$XDG_CONFIG_DIR/audiobook-dl/audiobook-dl.tomlSource credentials can be provided in the configuration file:
[sources.yourcloudlibrary] username = "yourusername" password = "supersecretpassword" library = "hometown"
Cookie files can be specified in a similar way:
[sources.everand] cookie_file = "./everand_cookies.txt"
Paths are relative to the configuration directory.
Issues, bug-reports, pull requests or ideas for features and improvements are very welcome.