ShonenX
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.
- Stars
- 334
- Forks
- 45
- Last push (UTC)
- Sep 17, 2026
- Project status
- Active
Original README
English project snapshot. Visit GitHub for the latest content.
ShonenX
Read. Watch. Track.
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 • Legal
Supporters
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 |
Details |
Player |
AniList |
🖥️ Desktop Views (Windows/Linux)
Home Screen |
Anime Details |
Video Player |
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
Categories
Dependencies used
Dependency list 65 items
- flutter
{"sdk":"flutter"} - go_router
^17.2.1 - flutter_riverpod
^3.3.1 - flex_color_scheme
^8.4.0 - logger
^2.8.0 - path
^1.9.1 - path_provider
^2.1.5 - isar_community
3.3.2 - isar_community_flutter_libs
3.3.2 - flutter_secure_storage
^10.3.1 - flutter_web_auth_2
{"git":{"url":"https://github.com/aayush2622/flutter_web_auth.git","path":"flutter_web_auth_2"}} - anymex_extension_runtime_bridge
{"path":"packages/anymex_extension_bridge"} - commentum_client
{"path":"packages/commentum_client"} - media_kit
{"git":{"url":"https://github.com/media-kit/media-kit.git","ref":"main","path":"./media_kit"}} - media_kit_video
{"git":{"url":"https://github.com/media-kit/media-kit.git","ref":"main","path":"./media_kit_video"}} - media_kit_libs_video
{"git":{"url":"https://github.com/media-kit/media-kit.git","ref":"main","path":"./libs/universal/media_kit_libs_video"}} - media_kit_libs_windows_video
^1.0.11 - get
^4.7.3 - google_fonts
^8.0.2 - shared_preferences
^2.5.5 - cached_network_image
^3.4.1 - volume_controller
^3.4.4 - screen_brightness
^2.1.7 - http
^1.6.0 - flutter_inappwebview
{"git":{"url":"https://github.com/roshancodespace/flutter_inappwebview.git","path":"flutter_inappwebview"}} - flutter_local_notifications
^20.1.0 - timezone
^0.10.1 - flutter_timezone
^5.1.0 - screenshot
^3.0.0 - window_manager
^0.5.1 - flutter_single_instance
^1.7.0 - url_launcher
^6.3.0 - html
^0.15.7 - flutter_svg
^2.2.4 - dynamic_color
1.8.1 - permission_handler
12.0.3 - file_picker
^8.1.4 - encrypt
^5.0.3 - android_intent_plus
^6.0.0 - open_file
^3.5.11 - device_info_plus
^12.4.0 - package_info_plus
^8.3.0 - scrollable_positioned_list
^0.3.8 - share_plus
^12.0.2 - collection
^1.19.1 - app_links
^6.4.1 - video_player
^2.10.1 - wakelock_plus
^1.3.3 - flutter_markdown_plus
^1.0.12 - palette_generator
^0.3.3+7 - skeletonizer
^2.1.3 - flutter_discord_rpc_fork
{"git":{"url":"https://github.com/kodjodevf/flutter-discord-rpc.git","ref":"update_frb"}} - rhttp
^0.18.0 - intl
^0.20.3 - local_auth
^3.0.1 - crypto
^3.0.3 - flutter_device_apps
^0.8.1 - cupertino_ui
any - flutter_testDevelopment
{"sdk":"flutter"} - flutter_lintsDevelopment
^5.0.0 - isar_community_generatorDevelopment
3.3.2 - package_renameDevelopment
^1.10.1 - inno_bundleDevelopment
^0.11.2 - flutter_launcher_iconsDevelopment
^0.14.4 - build_runnerDevelopment
^2.15.1
Rankings
How do I choose a repository?
Start with your use case, compare repository activity, and check the original project before adopting it.
- Search by repository name, owner or description, then narrow the results by topic.
- Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
- Read the README, license and issues on GitHub before using a project.
Sources and maintenance
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗
- roshancodespace/ShonenX · GitHub ↗
- GitHub Docs — Saving repositories with stars ↗
- Directory maintained by Ducafecat ↗