RoyalRoad Downloader with UI

A download utility for archiving content from RoyalRoad.

Exports stories and books in three formats (TXT, HTML, PDF) with four color theme choices (Light, Dark, Midnight, Antique). With UI.

Supported Formats

• .txt - Plain text
• .html - Web page
• .pdf - Portable Document Format

Other formats may be added in future if requested

Color Themes

• Light - Standard light theme
• Dark - RoyalRoad's dark theme
• Midnight - Dark theme with low contrast (recommended for reading)
• Antique - Sepia/old paper theme

Other themes may be added in future if requested

Requirements

• Python 3.10 or higher
• Main required Python packages:
  • BeautifulSoup4
  • WeasyPrint
  • Requests
  • PySide6 (Qt for Python)

(look for full list in requirements.txt)

Installation

Option 1: Executables

Look for Linux and Windows executables in releases

Should work by itself without any additional packages and libraries

Option 2: From Source

Linux

Install Python if not installed already

sudo apt update
sudo apt install python3 python3-pip

Clone or download the project files

git clone https://github.com/NaikeR303/UI_royalroad_downloader.git
cd royalroad-downloader

Create virtual environment and activate it

python3 -m venv venv
source venv/bin/activate

Install requirements

pip install -r requirements.txt

Run the application

python main.py

Windows

• Install Python if not installed already
• Clone or download the project files

Create virtual environment and activate it

python3 -m venv venv
.\venv\Scripts\activate

Install requirements

pip install -r requirements.txt

Run the application

python main.py

Usage

1. Enter URL: Paste the RoyalRoad story URL in the input field
2. Select Theme: Choose from one of the four color themes
3. Choose Format: Click your preferred download format button
4. Wait for Completion: A popup will notify you when download finishes
5. Find File: Check the directory with main.py or executable for your exported file

License

MIT License

Do whatever you want, just don't forget to mention me

And please, for personal use only. Respect authors of the books you archive