Pakete, Repositories und App-Kategorien suchen

GitHub-RepositoryMilkFeng/lumina

lumina

Ein leichtgewichtiger, plattformübergreifender EPUB-Leser, der mit Flutter entwickelt wurde und iOS- und Android-Systeme unterstützt.

Projektcover von lumina
Sterne
286
Forks
19
Letzter Push (UTC)
18.09.2026
Projektstatus
Aktiv

Original-README

Englischer Projektschnappschuss. Aktuelle Inhalte auf 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-Autor

Milk Feng ↗

A student from BIT

Beijing Institute of TechnologyBeijing, China
SprachenDartHTMLTypeScriptKotlinRustSwiftCSSCMakeRubyShellBatchfilePowerShellHandlebarsCObjective-C

Kategorien

Verwendete Abhängigkeiten

Abhängigkeiten 42 Einträge

Ranglisten

Wie wähle ich ein passendes Repository?

Nach Anwendungsfall filtern, Aktivität vergleichen und vor der Nutzung das Originalprojekt prüfen.

  1. Nach Name, Autor oder Beschreibung suchen und nach Thema eingrenzen.
  2. Sterne, Forks und letzte Pushes vergleichen. Sterne zeigen Interesse, garantieren aber keine Qualität.
  3. Vor der Nutzung README, Lizenz und Issues auf GitHub prüfen.

Quellen und Pflege

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

GitHub Docs — About repositories ↗