Skip to content

Repository files navigation

ShonenX Logo

ShonenX

Read. Watch. Track.

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

🌐 Visit the Official Website

Started as a personal project, ShonenX is an open-source anime and manga client. Ad-free with no trackers. Tracks progress across AniList, MyAnimeList, and Kitsu.

FeaturesScreenshotsInstallationExtensionsLegal


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.

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 (Universal Install Script)

We provide a universal interactive installation script for Linux users. It will fetch the latest release, extract it, set up the desktop icon, and add it to your PATH automatically.

Run the following command in your terminal:

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

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

🛠️ Build from Source

Prerequisites: Flutter SDK ≥3.8.1, Git

git clone https://github.com/roshancodespace/ShonenX.git
cd ShonenX
flutter pub get
flutter pub run build_runner build --delete-conflicting-outputs
flutter run # Select your device/platform

Legal & DMCA Disclaimer

Please read this before complaining.

01. Service Nature
Look, ShonenX does not host, upload, or own any of the media you see in the app. It's literally just a frontend client. It's a glorified web browser that makes stuff look pretty. We don't have servers full of anime.

02. APIs & Metadata
The covers, synopses, and schedules you see? That's all pulled directly from public APIs like AniList, MyAnimeList, and Kitsu. ShonenX just displays what they send back. Don't sue us for showing a picture of Goku.

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. If you put in a weird URL and watch something you shouldn't, that's your problem, not ours. Make sure you follow your local laws, we are not your lawyers.

If you're a copyright holder looking to DMCA someone, you're barking up the wrong tree. Go find the extension developers or whoever is actually hosting the video files.


Contributing & Documentation

Contributions are welcome! Feel free to inspect the code, compile from source, open an issue, or contribute if you understand the architecture.


Contributors

Thanks to everyone who has contributed to ShonenX!


Support

Developer: Roshan Kumar Sharma
GitHub: @roshancodespace
Buy Me a Coffee: roshan.codespace
Email: roshan.codespace@gmail.com
Discord: Join Community
License: GPL-3.0 (See LICENSE file)


⭐ Star this repo if you find it useful!

Made with ❤️ by Roshan Kumar

About

A modern Flutter application for media discovery, tracking, and streaming. Featuring seamless AniList and MyAnimeList integration, customizable content providers, offline capabilities, smooth playback, and a refined user experience, the app is built with a strong focus on performance, scalability, and modern design principles.

Topics

Resources

Stars

Watchers

Forks

Releases

Used by

Contributors

Languages