Ephyra

Your content, your library, your way.

A personal media reader and library manager for Android — organize, track, and read your manga, comics, and webtoons in one place.

Download

Requires Android 8.0 or higher.

About

Ephyra is built for people who own their content. Whether your collection lives on a Jellyfin server, on your phone's local storage, or elsewhere, Ephyra helps you organize, track, and read it all in one place with a polished, configurable reading experience.

Key Features

📖 Powerful Reading Experience

• Multiple reading modes — right-to-left, left-to-right, vertical scroll, and continuous webtoon modes with configurable tap zones and navigation.
• Smooth page transitions — choose between instant jump or smooth scroll when navigating with the page slider.
• Smart page combine — automatically merges short watermark or credit stubs with the preceding page for an uninterrupted reading flow.
• Device-adaptive performance — preload windows and download workers scale based on available RAM, keeping low-end devices responsive and high-end devices aggressive.
• Bandwidth-isolated preloading — adjacent chapters download in the background without competing with your active chapter, with opportunistic cross-chapter prefetch and automatic retry on failures.

🗄️ Jellyfin Integration

• Track read progress on your self-hosted Jellyfin media server.
• Bidirectional library sync — manage your library once, read everywhere.
• Automatic Jellyfin library scanning after sync (admin-gated).

🏷️ Authority-Based Metadata

• Pair series with authoritative metadata sources (MangaUpdates, AniList, MyAnimeList, Jellyfin) for rich, accurate library organization.
• Per-field metadata priority — choose whether each metadata field (title, description, cover, author, etc.) should prefer your content source or the authority source.
• Field-level locking — protect your manual edits from being overwritten during authority refresh.
• Smart content source matching with intelligent deduplication, prioritizing sources with available chapters.

📊 Tracking & Organization

• Tracker support: MyAnimeList, AniList, Kitsu, MangaUpdates, Shikimori, Bangumi, and Jellyfin.
• Categories to organize your library.
• Configurable authority source order — control which metadata source takes priority.
• Schedule automatic library updates for new chapters.

🎨 Customization

• Light and dark themes with branded theme options.
• E-Ink display mode with configurable flash intervals and colors.
• Color filters, grayscale, and inverted color modes for comfortable reading.
• Create backups locally or to your preferred cloud service.

🔌 Content Sourcing Architecture (Dynamic Scrapers, Heuristics, & On-Device Transpilation)

Ephyra implements a highly modular, secure, and lightweight dynamic content sourcing system. The application starts with a completely clean, empty sandbox (no pre-bundled scrapers). Users can add remote extension repositories and install extensions dynamically.

The retrieval pipeline consists of three core components:

1. On-Device Legacy Extension Transpiler:

   • Raw Kotlin Compilation: Ephyra downloads the raw Kotlin source code of extensions directly from remote repositories.
   • QuickJS Transpilation: An on-device sandboxed compiler (transpiler.js running in QuickJS) translates the Kotlin code into secure, sandboxed JavaScript scraper files on the fly.
   • Auto-Updates: When remote repositories are refreshed, Ephyra automatically checks version codes, fetches updated Kotlin sources, re-transpiles, and hot-updates the on-device JS scraper scripts in the background.

2. Sandboxed JavaScript Engine (ScriptableContentSourceEngine):

   • Play Store Compliant QuickJS: Leverages a secure, fully sandboxed QuickJS runtime to execute user-provided or transpiled .js scraper files.
   • Url Mapping: Links specific base URLs of content providers to their respective transpiled scraper scripts (e.g., mangadex_scraper.js), offering exact control over fetching, pagination, and API payloads in a secure sandbox.

3. Layout Heuristics Engine (AdaptiveHeuristicEngine):

   • DOM Structure Heuristics: Analyzes web pages on the fly using Jsoup to auto-discover selectors for search grids, item details, titles, covers, chapter lists, and reader images if a custom scraper is not mapped.
   • Intelligent Fallbacks & Caching: Employs heuristic rules matching common classes/IDs and caches the discovered selector rules into a serialized SourceProfile template for optimal performance on subsequent requests.

Contributing

Code of conduct · Contributing guide

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Before reporting a new issue, take a look at the already opened issues.

Credits

Thank you to all the people who have contributed!

Ephyra builds on upstream open source reader technology and the work of many contributors.

Disclaimer

The developer(s) of this application do not have any affiliation with the content providers available, and this application hosts zero content. Ephyra is intended for use with content you personally own or have authorized access to.

License

Copyright © 2015 Javier Tomás
Copyright © 2024 Ephyra Open Source Contributors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.