-legado-build

Project Overview

阅读Shimmer is an Android e-book reader for heavy readers. It keeps the book-source system and interface skeleton of Legado, but ships under its own package name io.legado.app.shimmer, so it can be installed on the same phone as Legado and Legado Archive. Users import their own book sources; the app bundles no book content, and local files are supported in TXT and EPUB.

Item	Value
Platform	Android 7.0 (API 24) and above
Package	io.legado.app.shimmer
Language	Kotlin
Versioning	Epoch minute timestamp
License	GPL-3.0

The independent package name lets it run beside the original Legado, and sources, shelves and reading progress can move over through a backup file.

Key Features

• Book-source reading: import Legado-format sources; search, tables of contents, text and images come from user-chosen sites
• Local library: read TXT and EPUB directly, with native typesetting in EPUB mode
• Highlight rules: import local .red rule files, plus pattern highlights, fonts and page HTML/CSS/JavaScript templates
• Text-to-speech: system and network TTS, a cross-app floating controller, and TTS that follows manual page turns
• Shelf management: list and grid views, groups and tags, batch actions, scheduled catalog refresh
• Backups: local backups handled separately from WebDAV and object-storage backups, so a cloud failure never aborts the local one
• Network controls: switch DNS and DoH, split traffic by feature, set domain exceptions and test services
• AI helpers: configurable AI services for source search, book and chapter reading, and reading-history queries

Who It Is For

• Readers who need two readers installed side by side
• Users who maintain and import their own source files
• Commuters who rely on TTS and the floating controller
• Long-term readers who back up to WebDAV
• Android developers building on this codebase

Installation and Migration

Fresh Install

1. Download the APK that matches your device architecture from Releases
2. Open the app and import your source files in Source Management
3. Copy local books to phone storage and choose Import Local Books on the shelf page

Migrating From an Older Build

1. In the old app open Backup and Restore and export a full backup, which produces a .zip file
2. Install 阅读Shimmer and restore that file from the same screen
3. Check that sources, shelves, reading progress and reading settings all came back
4. Uninstall the old app only after everything looks right

System Requirements

Item	Requirement
OS	Android 7.0 (API 24) and above
Architecture	arm64-v8a, armeabi-v7a
Build environment	JDK 17, Android SDK with compileSdk 37
Network	Online sources need a connection; local books read offline

Notes

• Package isolation: data from the old package does not carry over, so export a backup before uninstalling
• API floor: the main UI renderer requires API 24, so Android 5.0 and 6.0 devices cannot display it properly even if installed
• EPUB limits: paragraph rules and pclick stay off in plain EPUB mode, while image click and replacement cleanup still work
• WebDAV account: after restoring a backup WebDAV needs its account entered again; local backups are unaffected