Skip to content

A web scraping suite to efficiently load .epub files onto your Kindle.

Notifications You must be signed in to change notification settings

bbrown430/endless-library

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

endless-library

endless-library is a tool to easily download and send books to a Kindle, featuring a search menu, Goodreads list imports, and an intuitive CLI menu.

Features

Installation

  1. Extract all files into a folder (can delete the .gitignore)
  2. Open a terminal in the folder
  3. Install the required dependencies using
pip install -r requirements.txt
  1. Rename example_config.json to config.json, and populate with the proper information
    • "mode"
      • "download" to only download books
        • NOTE: if using "download" mode, you do not need to configure the email settings
      • "kindle" to download books, and email to Kindle
    • "email_sender"
    • "email_receiver"
      • the email address of the Kindle device you want to send e-books to
      • NOTE: this email address can be found here
    • "email_password"
      • the app password of the Gmail account under "email_sender"
      • NOTE: an app password can be generated here

Usage

Run endless-library.py by double clicking, or by opening a terminal in the root folder and typing

python endless-library.py

Screenshots

cli screenshot

Known Issues / Shortcomings

  • Some .epub files will be rejected when sent to Kindle. I haven't determined what causes some .epubs to be unsupported, but when an error occurs, you will receive an email titled "There was a problem with the document(s) you sent to Kindle." This is not a shortcoming of this program, rather, the Kindle's .epub processing.
  • Email sending only supports Gmail accounts.

Future Features

  • Additional mirror support
  • Email support outside of Gmail accounts.
  • Documented testing

About

A web scraping suite to efficiently load .epub files onto your Kindle.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages