パッケージ、リポジトリ、アプリカテゴリを検索

GitHub リポジトリMilkFeng/lumina

lumina

Flutterで構築された、iOSおよびAndroidシステムをサポートする軽量なクロスプラットフォームEPUBリーダー。

lumina のプロジェクト画像
スター
286
フォーク
19
最終プッシュ(UTC)
2026/09/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 ↗