搜尋套件、儲存庫與 APP 分類

GitHub 儲存庫MilkFeng/lumina

lumina

一個輕量級的跨平台 EPUB 閱讀器,使用 Flutter 建構,支援 iOS 和 Android 系統。

lumina 專案封面
星標
286
分支
19
最近推送(UTC)
2026年9月18日
專案狀態
未封存

原始 README

以下為英文專案原文快照,最新內容請造訪 GitHub。

简体中文 | English

Lumina

A lightweight EPUB e-book reader built with Flutter, supporting both Android and iOS platforms.

Flutter License Platform

CHANGELOG

🚧 Early Development Stage

Please note that this project is currently in Alpha. Breaking changes to the database schema may occur without migration scripts in early versions.

✨ Key Features

  • 📚 EPUB Reading - Supports EPUB 2.0/3.0 formats with smooth page turning, automatic reading progress saving, and complete EPUB rendering based on WebView
  • 🗂️ Bookshelf Management - Custom grouping, multi-dimensional sorting, and batch operations
  • 🎨 Elegant Interface - Light/dark theme switching for comfortable reading experience
  • ⚡ Efficient Architecture - Streaming loading of EPUB compressed files for fast startup

📱 Screenshots


Shelf

About

Reader

Book Details

Table of Contents

Style Settings

Footnote Support

Vertical Reading Support

🚀 Quick Start

Visit the Releases page to download the latest version.

  • Android Users: Download the .apk file and install it directly.
  • iOS Users: Download the .ipa file and install it via sideloading.
    • Recommended Tools: AltStore (Recommended), Sideloadly, or TrollStore (for supported iOS versions).
    • Note: If using a free Apple ID, you will typically need to refresh the app signature every 7 days.

🔧 Developer Guide

Requirements
  • Flutter SDK ≥ 3.10.8
  • Dart SDK ≥ 3.10.8
  • iOS 12.0+ / Android 5.0+ (API Level 21+)
Build from Source
  1. Clone the Repository
git clone https://github.com/MilkFeng/lumina.git
cd lumina
  1. Install Dependencies
flutter pub get
  1. Run the App
flutter run

Or specify a device:

flutter run -d <device-id>
Build Release Version

Android APK

flutter build apk --release

iOS

flutter build ios --release

🗺️ Roadmap

  • [x] Basic EPUB parsing and rendering
  • [x] Stream-from-Zip streaming loading
  • [x] Smooth page turning animations
  • [x] Automatic reading progress saving
  • [x] Bookshelf grouping management
  • [x] Table of contents navigation
  • [x] Adaptive light/dark themes
  • [x] Internationalization support (Chinese/English)
  • [x] Avoid duplicate page turns when two NCX navigation points are on the same page
  • [x] Long press images to view full-size
  • [x] Simple swipe page turning mode
  • [x] Improve screenshot speed during page turns on iOS
  • [x] Import folders
  • [x] Optimize initial loading lag when opening the first book
  • [x] Export library
  • [x] Test import/export functionality on iOS
  • [x] Bookshelf homepage can switch between "Compact, Comfortable" layout modes, and can set whether to show book reading progress bars
  • [x] Vertical and RTL support
  • [x] Associate with epub format for direct opening of epub files
  • [x] Edit book metadata (title, author, etc.)
  • [x] Reading settings (font size, background color, etc.)
  • [x] Footnote support
  • [x] Link handling
  • [ ] Better color rendering
  • [ ] Cloud sync (WebDAV)
  • [ ] Search functionality
  • [ ] Annotation and bookmarking features
  • [ ] Edit book covers
  • [ ] More reading settings options
  • [ ] Chinese support for error messages

🙏 Acknowledgements

This project uses the following excellent open-source projects:

  • Flutter - Google's UI toolkit
  • Riverpod - Reactive state management
  • Isar - High-performance NoSQL database

Thanks to all contributors for their support!


⭐ If this project helps you, feel free to star it!

Issues and pull requests are welcome

Milk Feng GitHub avatar
GitHub 作者

Milk Feng ↗

A student from BIT

Beijing Institute of TechnologyBeijing, China
語言DartHTMLTypeScriptKotlinRustSwiftCSSCMakeRubyShellBatchfilePowerShellHandlebarsCObjective-C

分類

使用的依賴

依賴清單 42 項

所在榜單

如何選擇適合專案的儲存庫?

先依使用情境篩選,再比較專案活躍情況,最後到原始儲存庫確認使用要求。

  1. 透過儲存庫名稱、作者或描述搜尋,再依技術分類縮小範圍。
  2. 綜合星標、分支與最近推送比較專案;星標反映社群關注,不保證品質。
  3. 使用前在 GitHub 確認 README、授權條款與 Issues。

來源與維護

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗