{"id":43209595,"url":"https://github.com/zhashut/goread","last_synced_at":"2026-02-27T16:18:05.862Z","repository":{"id":331573251,"uuid":"1071273772","full_name":"zhashut/goread","owner":"zhashut","description":"GoRead is a lightweight reader application designed specifically for local e‑book reading.","archived":false,"fork":false,"pushed_at":"2026-02-08T16:44:00.000Z","size":7262,"stargazers_count":366,"open_issues_count":8,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-02-08T22:33:19.749Z","etag":null,"topics":["android-app","bookshelf","ebook-reader","epub","ios-app","offline-reading","pdf","reader","tauri-v2"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhashut.png","metadata":{"files":{"readme":"README.en.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-07T05:56:59.000Z","updated_at":"2026-02-08T16:44:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zhashut/goread","commit_stats":null,"previous_names":["zhashut/goread"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/zhashut/goread","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhashut%2Fgoread","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhashut%2Fgoread/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhashut%2Fgoread/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhashut%2Fgoread/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhashut","download_url":"https://codeload.github.com/zhashut/goread/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhashut%2Fgoread/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29903622,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T14:46:13.553Z","status":"ssl_error","status_checked_at":"2026-02-27T14:46:10.522Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android-app","bookshelf","ebook-reader","epub","ios-app","offline-reading","pdf","reader","tauri-v2"],"created_at":"2026-02-01T07:17:23.597Z","updated_at":"2026-02-27T16:18:05.830Z","avatar_url":"https://github.com/zhashut.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"English | [简体中文](README.md)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./public/app-icon.svg\" alt=\"GoRead Icon\" width=\"128\" height=\"128\"\u003e\n\u003c/p\u003e\n\n# GoRead\n\nGoRead 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.\n\n\u003e Online e‑book source: \u003ca href=\"https://z-lib.id\" target=\"_blank\"\u003eZ-Library\u003c/a\u003e — download online and import locally.\n\n\n---\n\n## Overview\n\nGoRead 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.\n\nYou 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.\n\n\u003cdiv style=\"display: flex; flex-wrap: wrap; gap: 10px; justify-content: center;\"\u003e\n  \u003cimg height=\"300px\" src=\"https://i.meee.com.tw/kGGAF07.jpg\" alt=\"GoRead界面截图\" style=\"max-width: 100%; object-fit: contain;\" /\u003e\n  \u003cimg height=\"300px\" src=\"https://i.meee.com.tw/cIwPQno.jpg\" alt=\"GoRead界面截图\" style=\"max-width: 100%; object-fit: contain;\" /\u003e\n  \u003cimg height=\"300px\" src=\"https://i.meee.com.tw/BQDpLCt.jpg\" alt=\"GoRead界面截图\" style=\"max-width: 100%; object-fit: contain;\" /\u003e\n  \u003cimg height=\"300px\" src=\"https://i.meee.com.tw/muKIQst.jpg\" alt=\"GoRead界面截图\" style=\"max-width: 100%; object-fit: contain;\" /\u003e\n  \u003cimg height=\"300px\" src=\"https://i.meee.com.tw/1ENrDZc.jpg\" alt=\"GoRead界面截图\" style=\"max-width: 100%; object-fit: contain;\" /\u003e\n  \u003cimg height=\"300px\" src=\"https://i.meee.com.tw/mlElLvB.jpg\" alt=\"GoRead界面截图\" style=\"max-width: 100%; object-fit: contain;\" /\u003e\n  \u003cimg height=\"300px\" src=\"https://i.meee.com.tw/d8A54qG.jpg\" alt=\"GoRead界面截图\" style=\"max-width: 100%; object-fit: contain;\" /\u003e\n\u003c/div\u003e\n\n---\n\n## Core Features\n\n### 1. Library \u0026 Bookshelf Management\n- Import local e‑book files once and manage them over the long term\n- Display all books in a **bookshelf view** for quick browsing and filtering\n- Manage book metadata in a unified way for easier search and organization\n\n### 2. Custom Grouping\n- Create custom groups such as \"Reading\", \"Tech\", \"Literature\", \"To Read\", etc.\n- Move books freely between groups to keep your library organized\n- Adjust group order, e.g. pin frequently used groups to the top\n\n### 3. Immersive Reading Experience\n- High‑performance rendering engine for smooth page turns, zooming, and navigation\n- Supports common reading operations: page jump, continuous reading, page zooming, etc.\n- Clean reading UI designed to reduce distractions and keep your attention on the content\n\n### 4. Bookmarks \u0026 Reading Progress\n- Add multiple bookmarks to important pages for quick review later\n- Automatically records reading progress for each book and restores it on the next open\n- All progress is stored locally and does not require a network connection\n\n### 5. Search \u0026 Quick Navigation\n- Search by book title to quickly locate what you want to read\n- Combine grouping and sorting to quickly find the content that matters most\n\n### 6. Local Storage \u0026 Privacy\n- All books and reading data are stored locally on your device\n- No upload of your library or reading history, suitable for users who care about privacy\n\n### 7. Multilingual \u0026 Internationalization\n- Built-in English and Simplified Chinese UI, follows system language by default\n- Planned in-app language switch and more languages support\n\n### 8. Format Support\n\n- [x] PDF\n- [x] Markdown\n- [x] EPUB\n- [x] MOBI\n- [x] TXT\n- [x] HTML\n- [ ] AZW3\n- [ ] FB2\n- [ ] 漫画本\n\n---\n\n## Who Is GoRead For?\n\n- **Heavy readers**: Have many local e‑books and want a unified tool to manage them\n- **Technical / professional users**: Frequently read PDFs or technical manuals and need efficient lookup and bookmarking\n- **Privacy‑conscious users**: Do not want their library or reading history to depend on cloud services or third‑party accounts\n- **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)\n\n---\n\n## Basic Usage Flow\n\n1. **Install and launch GoRead**\n2. **Import books**: Import local e‑book files into the app\n3. **Organize groups**: Create groups based on your own reading habits and categorize books\n4. **Start reading**: Select a book from the bookshelf to open the reader\n5. **Add bookmarks / track progress**: Add bookmarks for key content while reading; progress is recorded automatically when you exit\n6. **Search and manage**: Use search and groups to quickly locate the books you need\n\n---\n\n## Getting Started (Developers)\n\nIf you want to run GoRead locally or contribute to its development, follow these steps.\n\n### Requirements\n- Node.js installed (LTS version recommended)\n- Rust installed (stable channel is sufficient)\n- System dependencies set up according to the official Tauri documentation\n\n### Install Dependencies\n\n```bash\nnpm install\n```\n\n### Start Development Environment\n\n```bash\nnpm run tauri dev\n```\n\n### Build Desktop Release\n\n```bash\nnpm run tauri build\n```\n\n---\n\n## Mobile Support\n\nGoRead can be built as Android and iOS applications, suitable for users who prefer reading on phones or tablets.\n\n### Initialize Mobile Projects\n\nBefore starting mobile development for the first time, run the initialization commands:\n\n```bash\n# Initialize Android\nnpm run tauri android init\n\n# Initialize iOS\nnpm run tauri ios init\n```\n\n### Run Mobile Apps (Development)\n\nAfter connecting a real device or starting an emulator, you can run mobile dev builds:\n\n```bash\n# Android development mode\nnpm run tauri android dev\n\n# iOS development mode\nnpm run tauri ios dev\n```\n\n### Build Mobile Packages\n\n```bash\n# Build Android packages (APK/AAB)\nnpm run tauri android build -- --target aarch64\n\n# Build iOS packages (IPA)\n# Option: app-store, ad-hoc, enterprise, development\nnpm run tauri ios build -- --export-method development\n```\n\nTo generate a signing key for Android, you can use a command similar to:\n```bash\nkeytool -genkey -v \\\n  -keystore \"release-key.keystore\" \\\n  -alias \"goread\" \\\n  -keyalg RSA \\\n  -keysize 4096 \\\n  -validity 10000\n```\n\n---\n\n## Contributing \u0026 Feedback\nGoRead is under active development. You are welcome to:\n\n- Report issues or suggestions to help improve the experience\n- Contribute code or optimize existing features\n- Share your usage scenarios across different devices and reading contexts\n\nIf 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.\n\n---\n\n## License \u0026 Usage Agreement\n\nThis 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.\n\nIn 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.\n\n## ⭐ Star History\n [![Star History Chart](https://api.star-history.com/svg?repos=zhashut/goread\u0026type=Date)](https://star-history.com/#zhashut/goread\u0026Date)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhashut%2Fgoread","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhashut%2Fgoread","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhashut%2Fgoread/lists"}