CLI tool for downloading audiobooks from online sources
Project description
audiobook-dl
CLI tool for downloading audiobooks from online sources.
Supported Services
audiobook-dl currently supports downloading from the following sources:
- audiobooks.com
- BookBeat
- Chirp
- eReolen (Danish Library)
- Librivox
- Nextory
- Overdrive (Library service)
- Saxo
- Scribd
- Storytel
- 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:
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:
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 audiobook_dl-0.5.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | be069d062bc162571e82cc0c3c63bb4821ef77c2b0045f0f4a369e87350b1ebc |
|
MD5 | fffbfc597bd308953e8600657d40f5ab |
|
BLAKE2b-256 | 03af4a306af0af1ae613da810bf54a8200d439dfeaaf90373a5e55edbe7c18f7 |