Thanks to visit codestin.com
Credit goes to github.com

Skip to content

IReaderorg/IReader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

📖 IReader

IReader is a free and open-source novel reader available for both Android and Desktop platforms. It offers a customizable reading experience with features like multiple reading directions and extensive personalization options.


🚀 Features

  • 📱 Cross-Platform – Android & Desktop support
  • ⚙️ Customizable Reading Experience – Multiple reading directions, fonts, themes
  • 🔌 Extension Support – Add or create new sources
  • 📥 Offline Reading – Download novels and read without internet
  • 🚫 Ad-Free – Clean and distraction-free reading
  • 🔒 Privacy-Focused – No tracking or account required
  • 🌙 Dark Mode – Comfortable reading in low light
  • 🔊 Text-to-Speech – Listen to novels with natural AI voices (Desktop)

🛠 Installation

📲 Android

  1. Download the APK

  2. Install the APK

    • Open the downloaded file on your Android device
    • Enable "Install from Unknown Sources" if prompted

💻 Desktop

🧪 Desktop version is still under development. Stay tuned to the GitHub repo for future releases.

Supported Platforms:

  • Windows 10 or later (x64)
  • macOS 10.15 (Catalina) or later (x64)
  • Linux (x64) with ALSA or PulseAudio

System Requirements:

  • 4GB RAM minimum (8GB recommended)
  • 500MB free disk space (plus additional space for TTS voice models)
  • Working audio output device (for TTS features)

📚 Usage

  1. Launch the App
  2. Add Novels
    • Use the in-app browser to find and download novels
  3. Customize
    • Open settings to change reading direction, themes, fonts, etc.
  4. Install Extensions

🔊 Text-to-Speech (Desktop)

IReader Desktop features Piper TTS - an advanced neural text-to-speech system that brings your books to life with natural-sounding AI voices.

✨ Key Features

  • 🎯 High-Quality Neural Voices – Natural, expressive speech using AI technology
  • 🌐 Offline-First – Works completely offline once voice models are downloaded
  • 🔒 Privacy-Focused – All processing happens locally, no data sent to external servers
  • 🌍 Multi-Language Support – Voices available in English, Spanish, French, German, and more
  • ⚡ Responsive Controls – Pause, resume, and navigate with <200ms response time
  • 📍 Word Highlighting – Follow along visually as each word is spoken
  • 🎚️ Customizable – Adjust speech rate, volume, and pitch to your preference
  • 💾 Efficient – Optimized resource usage with lazy model loading

🚀 Getting Started with TTS

  1. Open a Book in the reader
  2. Click the TTS Button (speaker icon) in the toolbar
  3. Download a Voice Model from the Voice Model Manager
  4. Select Your Voice and start listening!

📥 Voice Models

Voice models are neural networks that generate speech. Each model has different characteristics:

  • Languages: English (US/UK), Spanish, French, German, Italian, Portuguese, and more
  • Quality Levels:
    • Low (~20-30MB) - Fast, good quality
    • Medium (~40-60MB) - Balanced, natural sound
    • High (~80-120MB) - Most expressive and natural
  • Voice Types: Male, Female, and Neutral voices available

Recommended Starting Models:

  • English (US): en_US-lessac-medium (Female, high quality)
  • English (UK): en_GB-alan-medium (Male, natural)

🎮 Playback Controls

  • Play/Pause – Start or pause reading
  • Stop – End playback and return to beginning
  • Next/Previous Paragraph – Navigate through text
  • Next/Previous Chapter – Jump between chapters
  • Speed Control – Adjust from 0.5x to 2.0x speed
  • Volume Control – Independent TTS volume

🛠️ Technical Details

Powered by Piper TTS:

  • Open-source neural TTS using VITS architecture
  • ONNX Runtime for cross-platform compatibility
  • Hardware acceleration support (CPU SIMD, GPU when available)
  • Memory-efficient with <500MB usage cap

Audio Backend:

  • Windows: WASAPI (low-latency)
  • macOS: Core Audio
  • Linux: ALSA/PulseAudio

📖 Documentation

🔄 Fallback Mode

If TTS encounters issues (no models, audio device unavailable, etc.), it automatically switches to simulation mode, allowing you to continue using the app while you resolve the issue.


📖 Documentation

Check out our comprehensive wiki for detailed guides:

Text-to-Speech Documentation

Developer Documentation


📖 Developer Documentation

Comprehensive documentation for developers is available in the docs/ directory:

Architecture & Design

Quick Links


🌍 Contributing

🌐 Translations

  • Help translate the app via Weblate

📦 Create a New Source

💻 Code Contributions

  1. Read the Architecture Guide to understand the project structure
  2. Follow clean architecture principles
  3. Write tests for new features
  4. Document public APIs with KDoc
  5. Submit a pull request

💬 Community & Support

  • Join our Discord Server for help, updates, and community discussions

📄 License

This project is licensed under the Apache 2.0 License


🔗 Website: https://ireaderorg.netlify.app/

Disclaimer

The developer of this application does not have any affiliation with the content providers available.

Screenshots 📷

Views Dark Light
Library library_view_dark library_view_light
Book book_view_dark book_view_light
Reader book_view_dark book_view_light