royalroad-fetchAndConvert

Automatically download a royalroad story, optionally convert it to kindle format and push it to the device.

Features

• Retrieve automatically all the chapters of the given story
• Support table of content for ebook conversion
• Support author note at both end and start of the chapter
• Support images
• Support CSS rules for different stories (e.g. "Everybody Love Large Chest")
• Convert the story in the azw3 format, and push it to the kindle.

GUI

Install

Download the latest released graphical version. For now, only the downloading is supported. The ebook generated need to be given to Calibre to convert it & to push it to your device.

Developpement

The GUI has been developped with Tkinter. Specifically, customtkinter. All the front end is inside the file gui_rfetcher.py.

The release is made by following this official tutorial.

CLI

Install

Install Python3 on your operating system.

Install needed libraries :

pip install requests-html

Also Install ADB drivers if you plan to automatically push the book into your Kindle.

It also uses calibre to convert and push the ebook to the kindle. Everything is included here.

Usage

Fetch and convert to AZW3 (Kindle Format)

The following command pull the chapter

python fetch_book.py url_of_chapter number_of_chapters name_of_ebook

Parameters :

• url_of_chapter : The URL of the chapter (not of the story homepage!)
• number_of_chapters : You guessed. If you want the whole book, just enter something like 99999
• name_of_ebook : The name of the ebook, .html extension will be added when the file is written on the filesystem.

It reads the chapter content of the URL given ( url_of_chapter ) and goes to the next chapter, and it loops number_of_chapters times.

This command will give you a file name_of_ebook.html on your filesystem, that can be used through Calibre to be directly pushed to your Kindle.

Fetch, convert, and push to your device :

fetchAndCopy.py url_of_chapter number_of_chapters name_of_ebook

This script will download the chapter and push it to the first kindle detected. name_of_ebook is the name of the ebook which will be visible.

Example

If you want to fetch the best rated story Mother of Learning from the first chapter, execute the following command :

python fetch_book.py https://www.royalroad.com/fiction/21220/mother-of-learning/chapter/301778/1-good-morning-brother 102 Mother_Of_Learning

In the example above, MOL.html is written a the working directory.