패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소MilkFeng/lumina

lumina

Flutter로 구현된 경량의 크로스 플랫폼 EPUB 리더로, 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 ↗