Skip to content

roshancodespace/ShonenX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

671 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ShonenX Logo

ShonenX

Read. Watch. Track.

Flutter Dart Version License: GPL v3 GitHub stars Discord

🌐 Visit the Official Website

Started as a fun personal project. Now an open-source anime and manga companion. No ads, no trackers, pure data sovereignty. Syncs cleanly with MAL and AniList.

Features β€’ Screenshots β€’ Installation β€’ Extensions β€’ Legal


β˜• Supporters


Izan

EVEE KNOA

✨ Features

  • Omni-Sync Tracking: Native bidirectional integration with MyAnimeList and AniList.
  • Custom Reader & Player: Low-latency media playback and reading with customizable flow controls and AMOLED dark mode support.
  • Offline Availability: Complete volume and season downloading for offline viewing and reading.
  • External Extensions: Utilizes the AnymeX Extension Runtime Bridge, enabling Aniyomi and Mangayomi extension support. The client ships bare-bones; all sources must be manually added by the user.
  • Cross-Platform: High-performance 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

πŸ”Œ Extensions & DSL

ShonenX ships without built-in content sources.

Instead, it supports external providers powered by the ShonenX DSL β€” a JSON-based runtime that allows Anime, Manga, and Tracker integrations to be developed independently from the app.

Build providers using:

  • HTML scraping
  • JSON APIs
  • Custom trackers
  • External extension repositories

πŸ“– Read the DSL Documentation: DSL Guide

Examples:


βš–οΈ 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 and MyAnimeList. 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
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

License

Stars

310 stars

Watchers

5 watching

Forks

Contributors