Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lonode/royalroad-fetchandconvert
Automatically download a royalroad story, convert it to kindle format and push it to the device.
https://github.com/lonode/royalroad-fetchandconvert
adb azw3 ebook epub fanfiction kindle python royalroad webfiction webnovel
Last synced: about 2 months ago
JSON representation
Automatically download a royalroad story, convert it to kindle format and push it to the device.
- Host: GitHub
- URL: https://github.com/lonode/royalroad-fetchandconvert
- Owner: lonode
- License: gpl-3.0
- Created: 2021-09-18T10:08:09.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-08-04T10:46:43.000Z (5 months ago)
- Last Synced: 2024-08-04T18:29:46.595Z (5 months ago)
- Topics: adb, azw3, ebook, epub, fanfiction, kindle, python, royalroad, webfiction, webnovel
- Language: Python
- Homepage:
- Size: 62.5 KB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/lonode/royalroad-fetchAndConvert/releases) 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](https://github.com/tomschimansky/customtkinter). All the front end is inside the file ``gui_rfetcher.py``.
The release is made by following this [official](https://customtkinter.tomschimansky.com/documentation/packaging) tutorial.
# CLI
## Install
Install Python3 on your operating system.
Install needed libraries :
pip install requests-html
Also [Install ADB drivers](https://adb.clockworkmod.com/) if you plan to automatically push the book into your Kindle.
It also uses [calibre](https://github.com/kovidgoyal/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.