This is a hard fork of kobo-book-downloader, a command line tool to download and remove Digital Rights Management (DRM) protection from media legally purchased from Rakuten Kobo. The resulting EPUB files can be read with, amongst others, KOReader.
kobodl preserves the features from kobo-book-downloader :
- stand-alone; no need to run other software or pre-download through an e-reader.
- downloads
.epubformatted books
it adds some new feautres
- multi-user support; fetch books for multiple accounts.
- web interface; adds new browser gui (with flask)
- docker image
- pypi package
WebUI provides all the same functions that the CLI did. It was added to allow other members of a household to add their accounts to kobodl and access their books without having to set up python. An example of how to run kobodl on your server with systemd can be found at subdavis/selfhosted.
with pipx
pipx install kobodlwith pypi
pip3 install kobodlwith docker
# list users
docker run --rm -it --user $(id -u):$(id -g) \
-v ${HOME}/.config/kobodl.json:/home/kobodl.json subdavis/kobodl \
--config /home/kobodl.json user list
# run http server
docker run --rm -it --user $(id -u):$(id -g) \
-p 5000:5000 \
-v ${HOME}/.config/kobodl.json:/home/kobodl.json \
-v ${PWD}/kobo_downloads:/home/downloads \
subdavis/kobodl \
--config /home/kobodl.json \
serve \
--host 0.0.0.0 \
--output-dir /home/downloadsGet started by adding one or more users
~$ kobodl user addList books from multiple accounts
~$ kobodl book list
+---------------------------------+-----------------------------+--------------------------------------+---------------------------+
| Title | Author | RevisionId | Owner |
|---------------------------------+-----------------------------+--------------------------------------+---------------------------|
| Dune | Frank Herbert | c1db3f5c-82da-4dda-9d81-fa718d5d1d16 | [email protected] |
| Foundation | Isaac Asimov | 3e12197c-681a-4a53-80b4-88fcdf61e936 | [email protected] |
| Girls Burn Brighter | Shobha Rao | 1227cc03-7580-4469-81a5-b6558500832f | [email protected] |
| On Earth We're Briefly Gorgeous | Ocean Vuong | 4ccc68b1-3dac-433e-b05a-63ab0f93578f | [email protected] |
| She Said | Jodi Kantor | 5d0872bf-8765-4654-9f90-aca4f54e5707 | [email protected] |
+---------------------------------+-----------------------------+--------------------------------------+---------------------------+Download a book
~$ kobodl book get -u [email protected] c1db3f5c-82da-4dda-9d81-fa718d5d1d16
Downloading book to kobo_downloads/Isaac Asimov - Foundation.epubRun the web ui
~$ kobodl serve
* Serving Flask app "kobodl.app" (lazy loading)
* Environment: production
WARNING: This is a development server. Do not use it in a production deployment.
Use a production WSGI server instead.
* Debug mode: off
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)Adding a user requires a bit of hackery to get a reCAPTCHA code from Kobo's website. This GIF helps to explain how to do that.
To get set up for development:
- clone this repo
- create a virtual environment (optional)
pip3 install -e .to install for developmentkobodlshould be available inside the virtual env
First, update setup.py's version, then run the following
docker build -t subdavis/kobodl .
docker push subdavis/kobodl
python3 setup.py sdist bdist_wheel
twine upload dist/*kobo-book-downloader will prompt for your Kobo e-mail address and password. Once it has successfully logged in, it won't ask for them again. Your password will not be stored on disk; Kobodl uses access tokens after the initial login.
Credit recursively to kobo-book-downloader and the projects that lead to it.