back to home

zhashut / goread

GoRead is a lightweight reader application designed specifically for local e‑book reading.

451 stars
15 forks
2 issues
TypeScriptRustKotlin

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing zhashut/goread in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/zhashut/goread)
Preview:Analyzed by RepoMind

Repository Overview (README excerpt)

Crawler view

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 • 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 • 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 • 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 • 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 • 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 • 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 • Multilingual & Internationalization • Built-in English and Simplified Chinese UI, follows system language by default • Planned in-app language switch and more languages support • 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** • Format Support • [x] PDF • [x] Markdown • [x] EPUB • [x] MOBI • [x] TXT • [x] 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 • **Install and launch GoRead** • **Import books**: Import local e‑book files into the app • **Organize groups**: Create groups based on your own reading habits and categorize books • **Start reading**: Select a book from the bookshelf to open the reader • **Listen (TTS, EPUB / MOBI / TXT only)**: Tap **Listen** in the reader; adjust speech rate in **Settings** • **Add bookmarks / track progress**: Add bookmarks for key content while reading; progress is recorded automatically when you exit • **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 Start Development Environment Build Desktop Release --- 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: Run Mobile Apps (Development) After connecting a real device or starting an emulator, you can run mobile dev builds: Build Mobile Packages To generate a signing key for Android, you can use a command similar to: --- 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