Skip to content

Latest commit

 

History

870 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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

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.

FeaturesScreenshotsInstallationContributingContributorsLegal


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 (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!

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 (Android, Windows, Linux). Expect potential bugs, quirks, and manual sideloading/signing requirements if you test them.

🛠️ 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 & Guidelines

Contributions are welcome! However, to maintain stability, maintainability, and a unified vision, please adhere to the following rules:

  • Architectural Authority: The architecture, design system, state management patterns, and project direction remain strictly at the discretion of @roshancodespace.
  • No Unsolicited Architectural Changes: Do not submit PRs that alter the core architecture, restructure directory conventions, replace major dependencies, or rewrite foundational patterns. Unsolicited refactors will be closed.
  • Discuss Major Changes First: If you want to propose a significant feature or structural adjustment, open an Issue to discuss and obtain approval before starting work.
  • What is Welcome: Bug fixes, provider and extension bridge improvements, performance optimizations, localized UI polish matching existing design tokens, and features that adhere cleanly to the established architecture.

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: roshan.codespace@gmail.com
Discord: Join Community
License: GPL-3.0 (See LICENSE file)


⭐ Star this repo if you find it useful!

Crafted with ❤️ by Roshan Kumar & Contributors

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

335 stars

Watchers

5 watching

Forks

Releases

Used by

Contributors

Languages