Uncle Novel is a Java-based open-source offline reader with full-format support and cross-platform compatibility. It parses directories from any site, downloads text and audio novels in TXT, EPUB, MOBI formats, and runs entirely offline with no ads or subscriptions.
In the world of web fiction enthusiasts, Uncle Novel is like a master key — it binds to no platform, yet unlocks the entire library of online novels. This Java-based open-source tool, built around directory parsing, delivers full-format support, cross-platform compatibility, and pure offline operation, making it a hidden gem for book lovers. Let's take a deep dive into what makes it so powerful!
Uncle Novel is a desktop reading application that parses novels from across the web, offering both downloading and reading capabilities. It supports both text novels and audiobooks. Think of it as a universal novel downloader and reader, leveraging directory parsing and book-source rules to fetch content. Uncle Novel supports downloading text novels in multiple formats, including mobi, epub, and txt.
🔍 1. Core Features: More Than a Reader — A Novel Harvester
- Universal Parsing, One Solution Fits All
- Directory Parsing: Paste any novel table-of-contents page link (e.g., Qidian, Zongheng), and it automatically grabs all chapters — no manual source configuration needed.
- Book-Source Mode: Advanced users can define custom crawler rules to adapt to niche websites, supporting the full pipeline of search → TOC → content.
- Ad Filtering: Manually add ad keywords (such as site names) to automatically strip junk content and improve reading purity.
- Dual Content Mode
- Text Novels: After parsing, download with one click in
TXT/EPUB/MOBIformats, compatible with Kindle and mobile readers. - Audio Novels: Automatically verifies audio availability, supports adding to the bookshelf for online listening or batch-downloading to local storage.
- Professional Reading Experience
- Multi-View Reader: Scroll mode + seamless chapter stitching, with customizable font, background, and spacing.
- Voice Narration: Leverages the Windows speech engine for TTS audiobook playback (Windows only).
- Bookshelf Cloud Sync: Back up bookshelf data via WebDAV for seamless cross-device reading.
- Download Powerhouse
- Multi-threaded downloads (adjustable thread count), resume support, and automatic retry on failure — ensuring tens of thousands of novels are archived reliably.
⚙️ 2. Installation & Deployment: From Beginner to Geek
Regular Users (One-Click Install)
- Visit the GitHub Release page and select your system version:
- Windows:
Uncle-Novel-Windows-x64.exe - macOS:
Uncle-Novel-macOS.dmg - Linux:
Uncle-Novel-Linux.deb - Double-click to install and launch. The interface features three zones: Bookshelf Management (left), Parse & Download (center), and Search (top right).
Developers (Source Build)
git clone https://github.com/unclezs/NovelHarvester # Clone source
cd NovelHarvester
./gradlew :app:packageWin64 # Windows package
./gradlew :app:packageMac # macOS packageRequirements: JDK 11+, Node.js (for frontend build), SQLite3 (database operations).
🎯 3. Advanced Tips: Unlock Hidden Power
- Self-Rescue When Parsing Fails
- When encountering parsing errors, enable Browser Simulation Mode (Settings → Parse Config) to bypass anti-crawler mechanisms.
- Manually inspect the TOC page structure and remove non-chapter links (e.g., "Author's Notes") to improve accuracy.
- Audio Novel Download Optimization
- Recommended thread count ≤5 (Settings → Download Config) to avoid IP bans.
- Prefer
.mp3sources for the best compatibility. - Book-Source Sharing Community
- Visit the GitHub Book Source Repository and import ready-made rules.
- DIY Source Tutorial: Use Chrome DevTools to analyze page structure and write XPath rules.
⭐ 4. Competitor Comparison: Why Choose Uncle Novel?
| Tool | Offline | Audio Novels | Format Export | Source Freedom | Platforms |
|---|---|---|---|---|---|
| Uncle Novel | ✅ | ✅ | TXT / EPUB / MOBI | Custom Rules | Win / Mac / Linux |
| Reeden | ✅ | ❌ | Read-only | ❌ | All platforms |
| Dialogue Novel | ❌ | ✅ | ❌ | ❌ | Mobile only |
| Biling AI | ❌ | ❌ | ❌ | ❌ | Web |
Key Advantages Summary:
- Pure Local Operation: No cloud transmission, protecting privacy and ensuring permanent availability.
- Zero-Cost Open Source: No ads, no membership tiers — GPL license guarantees freedom to use.
- Strong Ecosystem: Compatible with TTS plugins, Calibre e-book management, and other toolchains.
💎 5. Final Thoughts: Who Should Use Uncle Novel?
- Web Fiction Hoarders: Batch-download complete novels to build a personal library.
- Multi-Device Users: Use Windows as the download hub, then sync reading on Mac/Linux.
- Tech Enthusiasts: Learn JavaFX desktop development and crawler rule writing in practice.
Reminder: For learning and exchange only! Please support official releases and delete downloaded content within 24 hours.
Take Action Now:
- Visit the Official GitHub for the latest version
- Join the Telegram group to discuss book-source rules (search
Uncle Novel Community)
Say goodbye to "broken chapters" and "garbled ads" — let the entire web of novels become your private collection! 📦
Note: This is the English translation of the original Chinese version.