Catalyst is a Flutter frontend for Suwayomi Server — a self-hosted manga server. It features a completely redesigned UI with Material You dynamic colour on Android and a native Cupertino glass UI on iOS/iPad.
Requires a running Suwayomi Server instance. See the Suwayomi Server setup guide to get started.
- Material You — Dynamic colour from your wallpaper on Android 12+
- iOS & iPad UI — Native Cupertino shell with frosted glass tab bar and sidebar on iPad
- Redesigned screens — Home, Library with filter chips, Explore, Feed (updates), Downloads
- Full reader — Continuous webtoon, single page, LTR/RTL with volume key support
- Tracker support — MyAnimeList, AniList, Kitsu, Bangumi, MangaUpdates, Shikimori
- Adaptive icon — Proper squircle/circle/teardrop on Android 8+
- Offline reading — Download chapters for local reading
Head to Releases and grab the right file:
| File | Use for |
|---|---|
app-arm64-v8a-release.apk |
Most Android phones (2016+) |
app-armeabi-v7a-release.apk |
Older 32-bit Android |
app-x86_64-release.apk |
Android emulators |
Catalyst.ipa |
iPhone / iPad (sideload via AltStore or Sideloadly) |
Requirements: Flutter 3.x, Dart 3.x
git clone https://github.com/just-for-death/catalyst.git
cd catalyst
flutter pub get
flutter run # debug on connected device
flutter build apk --release --split-per-abi # release APKs
flutter build ipa --no-codesign # unsigned IPACatalyst stands on the shoulders of several great open-source projects. Huge thanks to everyone who built and maintains them.
| Project | Role |
|---|---|
| Tachidesk-Sorayomi by Suwayomi | The original Flutter client Catalyst is forked from. All core logic, GraphQL layer, reader, tracker integration, and data architecture come from this project. |
| Suwayomi-Server by Suwayomi | The self-hosted backend server Catalyst connects to. Handles sources, downloads, library management, and tracking sync. |
| Project | Role |
|---|---|
| Futon by AppFuton | Inspired the Android UI redesign — the Home grouped cover grid, Explore pill-action layout, Feed date headers, Library filter chips, and bottom navigation structure are all modelled after Futon's Material design patterns. |
| Aidoku by Aidoku | Inspired the iOS/iPadOS UI — the Cupertino navigation shell, frosted glass tab bar, large-title app bars, iPad split-view sidebar, and glass card aesthetic are all modelled after Aidoku's native SwiftUI design. |
Catalyst talks to your Suwayomi server using a URL you configure.
- HTTP on a trusted LAN is common for self-hosted setups. If the server is reachable from untrusted networks (e.g. the public internet), prefer HTTPS so traffic and Basic auth are not sent in the clear.
- Basic authentication: when enabled, the app stores the credentials in the OS secure store (Keychain / Keystore) after a one-time migration from older builds that used app preferences. A fully compromised device can still expose secrets; treat physical access accordingly.
- Android: cleartext HTTP and trust for user-installed certificate authorities are intentional so local servers and self-signed TLS work (
android/app/src/main/AndroidManifest.xml,android/app/src/main/res/xml/network_security_config.xml). - iOS: local network HTTP to typical LAN hosts is allowed via App Transport Security (
NSAllowsLocalNetworkinginios/Runner/Info.plist). If you use an unusual host or still see ATS errors, try HTTPS or consult Apple’s ATS documentation.
Pull requests are welcome. For major changes please open an issue first.
- Fork the repo
- Create your branch:
git checkout -b feature/my-feature - Commit:
git commit -m 'feat: add my feature' - Push:
git push origin feature/my-feature - Open a Pull Request
Catalyst is a derivative work of Tachidesk-Sorayomi, which is also licensed under MPL-2.0. Per the terms of MPL-2.0, all modifications are made available under the same license.