goread

English | 简体中文

GoRead

GoRead is a lightweight reader application designed specifically for local e‑book reading. It supports both desktop and mobile platforms (Android / iOS), providing a consistent and smooth reading experience across your devices.

Online e‑book source: Z-Library — download online and import locally.

---

Overview

GoRead focuses on local e‑book management and immersive reading. It does not rely on cloud accounts, contains no ads, and minimizes interruptions. It is designed for users who want full control over their library and privacy.

You can consolidate e‑books scattered across different folders, organize them into custom groups, and read them in a unified reader with bookmarks and reading progress management.

---

Core Features

1. Library & Bookshelf Management

• Import local e‑book files once and manage them over the long term
• Display all books in a bookshelf view for quick browsing and filtering
• Manage book metadata in a unified way for easier search and organization

2. Custom Grouping

• Create custom groups such as "Reading", "Tech", "Literature", "To Read", etc.
• Move books freely between groups to keep your library organized
• Adjust group order, e.g. pin frequently used groups to the top

3. Immersive Reading Experience

• High‑performance rendering engine for smooth page turns, zooming, and navigation
• Supports common reading operations: page jump, continuous reading, page zooming, etc.
• Clean reading UI designed to reduce distractions and keep your attention on the content

4. Bookmarks & Reading Progress

• Add multiple bookmarks to important pages for quick review later
• Automatically records reading progress for each book and restores it on the next open
• All progress is stored locally and does not require a network connection

5. Search & Quick Navigation

• Search by book title to quickly locate what you want to read
• Combine grouping and sorting to quickly find the content that matters most

6. Local Storage & Privacy

• All books and reading data are stored locally on your device
• No upload of your library or reading history, suitable for users who care about privacy

7. Multilingual & Internationalization

• Built-in English and Simplified Chinese UI, follows system language by default
• Planned in-app language switch and more languages support

8. Text-to-Speech (TTS)

• Tap the Listen button in the reader to start/stop reading aloud
• Supports EPUB / MOBI / TXT only
• Speech rate can be adjusted in Settings

9. Format Support

• PDF
• Markdown
• EPUB
• MOBI
• TXT
• HTML
• CBZ

---

Who Is GoRead For?

• Heavy readers: Have many local e‑books and want a unified tool to manage them
• Technical / professional users: Frequently read PDFs or technical manuals and need efficient lookup and bookmarking
• Privacy‑conscious users: Do not want their library or reading history to depend on cloud services or third‑party accounts
• Multi‑device users: Want a consistent reading experience on desktop and mobile (you can sync your library across devices using your own file sync tools)

---

Basic Usage Flow

1. Install and launch GoRead
2. Import books: Import local e‑book files into the app
3. Organize groups: Create groups based on your own reading habits and categorize books
4. Start reading: Select a book from the bookshelf to open the reader
5. Listen (TTS, EPUB / MOBI / TXT only): Tap Listen in the reader; adjust speech rate in Settings
6. Add bookmarks / track progress: Add bookmarks for key content while reading; progress is recorded automatically when you exit
7. Search and manage: Use search and groups to quickly locate the books you need

---

Getting Started (Developers)

If you want to run GoRead locally or contribute to its development, follow these steps.

Requirements

• Node.js installed (LTS version recommended)
• Rust installed (stable channel is sufficient)
• System dependencies set up according to the official Tauri documentation

Install Dependencies

npm install

Start Development Environment

npm run tauri dev

Build Desktop Release

npm run tauri build

---

Mobile Support

GoRead can be built as Android and iOS applications, suitable for users who prefer reading on phones or tablets.

Initialize Mobile Projects

Before starting mobile development for the first time, run the initialization commands:

# Initialize Android
npm run tauri android init

# Initialize iOS
npm run tauri ios init

Run Mobile Apps (Development)

After connecting a real device or starting an emulator, you can run mobile dev builds:

# Android development mode
npm run tauri android dev

# iOS development mode
npm run tauri ios dev

Build Mobile Packages

# Build Android packages (APK/AAB)
npm run tauri -- android build -- --target aarch64

# Build iOS packages (IPA)
# Option: app-store, ad-hoc, enterprise, development
npm run tauri -- ios build -- --export-method development

To generate a signing key for Android, you can use a command similar to:

keytool -genkey -v \
  -keystore "release-key.keystore" \
  -alias "goread" \
  -keyalg RSA \
  -keysize 4096 \
  -validity 10000

---

Contributing & Feedback

GoRead is under active development. You are welcome to:

• Report issues or suggestions to help improve the experience
• Contribute code or optimize existing features
• Share your usage scenarios across different devices and reading contexts

If you run into problems while using GoRead or have new ideas for features, please open an Issue or submit a Pull Request in the project repository.

---

License & Usage Agreement

This project is released under the AGPL-3.0 license. For the full legal text, please refer to the “GNU Affero General Public License v3.0” as published by the Free Software Foundation.

In addition, this project explicitly prohibits any form of commercial use, including but not limited to selling this software, using this software or its modified versions as part of paid services, or profiting directly or indirectly in any manner through this software. Any violation may result in legal liability pursued by the author in accordance with applicable laws.

⭐ Star History