Freereads
About
A terminal-based application that searches Library Genesis for e-books and displays the results. The user can then download the book, and the application will send it directly to their Amazon Kindle.
Freereads is built with Python. The terminal display is handled with curses. Interaction with Library Genesis and its mirror sites is done with Requests and BeautifulSoup4. Emailing is done through Gmail's smtp server.
Demo
Downloading "Inferno" by Larry Niven, and sending it to an email.
Using Freereads
Download and setup
Run the following commands:
$ git clone https://github.com/nickmpaz/freereads.git && cd freereads
$ sudo pip3 install -r requirements.txt
$ mv .env.example .env
Install calibre - (Ex. Ubuntu):
$ sudo apt install calibre
Edit the .env file
Fill out the following information:
SENDER_EMAIL="your_gmail_address"
SENDER_PASSWORD="your_gmail_password"
RECEIVER_EMAIL="your_kindle_email_address"
Email configuration
For a Gmail account to be used by the application, it must "allow less secure apps" (It may be smart to create a seperate Gmail account). How to do this:
Whichever Gmail account you use, the account must be added to your Amazon account as an approved email. How to do this:
Starting the application
$ python3 freereads.py
Controls
General Controls
- ctrl-C: exit
- up/ down: Change the selected search result. Moving above the first result will focus the search bar. The search bar is focused by default. When the search bar is focused simply type and press enter to perform a search.
Search Bar is Focused
- enter: perform search
- delete: clear search bar
Search Result is Focused
- enter: download book and send it to Kindle