README

ShonenX Logo

ShonenX

Read. Watch. Track.

Flutter Dart Version License: GPL v3 GitHub stars Discord Buy Me a Coffee

🌐 Visit the Official Website

Created and maintained by Roshan Kumar with the help of community contributors. ShonenX is an open-source, ad-free, and tracker-free anime and manga client. Tracks progress across AniList, MyAnimeList, and Kitsu.

Features • Screenshots • Installation • Contributing • Contributors

Caution 注意

01. Service Nature: ShonenX does not host, upload, or own any of the media you see in the app. It’s simply a frontend client—a glorified web browser. We do not have servers hosting anime.

02. APIs & Metadata: The covers, synopses, and schedules are pulled directly from public APIs like AniList, MyAnimeList, and Kitsu. ShonenX merely displays the metadata they provide.

03. User Extensions & Content: Any “extensions” or third-party sources you decide to install are entirely on you. ShonenX doesn’t distribute copyrighted material or endorse piracy. Ensure you follow your local laws; we are not your lawyers. If you’re a copyright holder looking to DMCA someone, please contact the extension developers or the host of the video files.

Supporters

Buy Me a Coffee



Izan

EVEE KNOA

Features

  • Parallel Progress Tracking: Sync watch and read progress across your linked trackers (AniList, MyAnimeList, and Kitsu).
  • Custom Reader & Player: Low-latency media playback and reading with customizable flow controls and AMOLED dark mode support.
  • Offline Availability: Volume and episode downloading for offline viewing and reading.
  • External Extensions: Utilizes the AnymeX Extension Runtime Bridge for Aniyomi and Mangayomi extension support. The client ships bare-bones; all sources are user-managed.
  • Cross-Platform: Native builds for Android, Windows, and Linux (with experimental macOS and iOS support).

Technology Stack

Framework: Flutter ≥3.8.1 | Language: Dart ≥3.8.1

View Key Dependencies
dependencies:
  flutter_riverpod: ^3.0.1
  go_router: ^14.7.1
  media_kit: ^1.2.6
  media_kit_video: ^2.0.1
  isar_community: ^3.3.0
  flex_color_scheme: ^8.4.0

Screenshots

📱 Android Screenshots (Click to expand)
Home
Home
Details
Details
Player
Player
AniList
AniList
🖥️ Desktop Views (Windows/Linux)
Desktop Home
Home Screen
Desktop Details
Anime Details
Desktop Player
Video Player
Desktop AniList
AniList Integration

Installation

📱 Android

Download the latest .apk from the GitHub Releases page.

🪟 Windows

Download the Windows-Portable.zip or the .exe installer from the Releases page.

🐧 Linux

Download the ShonenX-linux-x86_64.flatpak bundle from the Releases page and install:

flatpak install --user ShonenX-linux-x86_64.flatpak

Run with:

flatpak run com.roshancodespace.shonenx

(Flatpak bundles all native multimedia dependencies such as libmpv in an isolated sandbox, ensuring seamless playback across any distribution, including Steam Deck / SteamOS, Fedora Silverblue, Arch, and Ubuntu).

Option 2: Universal Install Script

We provide an interactive shell installation script for Linux. It fetches the latest release, configures desktop shortcuts, registers URL protocol handlers, and sets up your PATH automatically:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/roshancodespace/ShonenX/main/install.sh)"

Note: You can run this same command again to update or uninstall ShonenX safely!

Option 3: AppImage & Portable Zip

Download ShonenX-linux-x86_64.AppImage or ShonenX-linux.zip directly from GitHub Releases.

macOS & iOS (⚠️ Highly Experimental)

[!WARNING] macOS and iOS builds are HIGHLY EXPERIMENTAL.
Builds for macOS and iOS might be present in releases or might not be available at all, even if a release is marked stable for other platforms. Expect potential bugs, quirks, and manual sideloading/signing requirements.

🛠️ Build from Source

Prerequisites: Flutter SDK ≥3.8.1, Git, Rust

  • Linux Dependencies: Building on Linux requires GTK, libmpv, and libwpewebkit (Ubuntu/Debian: sudo apt install libgtk-3-dev libmpv-dev libwpewebkit-1.0-dev, Arch Linux: sudo pacman -S gtk3 mpv wpewebkit). See the Local Setup Guide for details.
git clone https://github.com/roshancodespace/ShonenX.git
cd ShonenX
flutter pub get
dart run build_runner build -d
flutter run # Select your device/platform

Contributing

Contributions are welcome. Before opening a PR, please review the Contribution Guidelines.

For significant features, architectural changes, dependency changes, or structural refactors, please open an issue for discussion before submitting implementation work.


Contributors

A huge thank you to everyone who has contributed to ShonenX!


Author & Support

Lead Developer & Maintainer: Roshan Kumar Sharma
GitHub: @roshancodespace
Buy Me a Coffee: roshan.codespace
Email: [email protected]
Discord: Join Community
License: GPL-3.0 (See LICENSE file)


⭐ Star this repo if you find it useful!

Crafted with ❤️ by Roshan Kumar & Contributors

评论

暂无评论