FLUTTER ECOSYSTEM

roshancodespace/ShonenX

一款現代化的Flutter應用程式,用於媒體探索、追蹤與串流播放。支援無縫整合AniList與MyAnimeList,可自訂內容來源,具備離線功能、流暢播放與優化使用者體驗,應用程式著重於效能、可擴展性與現代設計原則。

少年X 專案封面
Stars
334
Forks
45
最近推送(UTC)
2026年9月17日
專案狀態
未封存
Roshan GitHub avatar
GITHUB User

Roshan ↗

語言DartC++ShellCMakeJavaSwiftCKotlinObjective-C

技術主題

使用的依賴

依賴清單 65 項

所在榜單

原始 README

以下為英文專案原文快照,最新內容請造訪 GitHub。

展開 / 收合專案 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.

FeaturesScreenshotsInstallationContributingContributorsLegal


Supporters

Buy Me a Coffee


https://cdn.buymeacoffee.com/uploads/profile_pictures/default/v2/DEBBB9/IZ.png
Izan
https://cdn.buymeacoffee.com/uploads/profile_pictures/default/v2/E3CBF4/EK.png
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!

https://contrib.rocks/image?repo=roshancodespace/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