客户端本身不含任何内容源,需自行安装第三方扩展才能播放;Linux 从源码构建需额外安装 GTK、libmpv 和 libwpewebkit 依赖;macOS 与 iOS 构建高度实验性,可能需要手动签名与侧载
ShonenX
roshancodespaceGPL-3.0活跃维护基于 Flutter 的跨平台动漫追番应用,整合 AniList 与 MyAnimeList 同步观看记录,支持自定义片源、离线缓存和流畅播放。
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.
flatpak install --user ShonenX-linux-x86_64.flatpak
flatpak run com.roshancodespace.shonenxREADME 未说明具体硬件要求;Android、Windows、Linux 提供原生构建,macOS 与 iOS 为高度实验性支持
开源无广告的动漫漫画客户端,聚合多平台追番进度并支持离线观看
基于 Flutter 的跨平台动漫追番应用,整合 AniList 与 MyAnimeList 同步观看记录,支持自定义片源、离线缓存和流畅播放。
核心能力
- 并行同步 AniList、MyAnimeList、Kitsu 三平台进度
- 内置低延迟播放器与可定制阅读器,支持 AMOLED 深色模式
- 支持剧集与卷册下载,离线观看和阅读
- 通过 AnymeX 扩展运行时桥接 Aniyomi 与 Mangayomi 扩展源
- 原生支持 Android、Windows、Linux,macOS/iOS 实验性
容易踩的坑
- v2.1.6-alpha.1最新正式版2026-11-07 · 2026-11-07 22:04 UTC
v2.1.6-alpha.1
New Features
- Added app-wide localization support.
- Introduced Flatpak packaging support and updated Linux installation documentation.
- Added NixOS packaging support.
- Included additional URL scheme handlers for Flatpak.
Improvements
- General performance optimizations.
- Improved subtitle overlay performance.
- Enhanced HLS decryption performance and improved security with TLS verification in the HTTP client.
Full Changelog: https://github.com/roshancodespace/ShonenX/compare/v2.1.5...v2.1.6-alpha.1
- v2.1.52026-10-25 · 2026-10-25 18:06 UTC
查看更新说明
v2.1.5 Release Notes
New Features
- TorrServer Addon: Added a new addon service and dedicated settings UI for managing TorrServer torrent streams.
- DNS-over-HTTPS (DoH): Implemented DNS-over-HTTPS (DoH) networking support with caching for enhanced privacy and security.
- Battery Optimization: Added battery optimization permissions for improved background download reliability.
- Local HLS Server: Introduced a local HLS server for stream handling and a force refresh option for sources.
- Player Settings: Added a video adjustments overlay and enhanced bottom sheet capabilities for player settings.
- Backup & Restore: Added record counts and improved the UI for backup and restore settings.
- Download Management: Added subtitle remuxing for downloads and extra header support for 1DM downloads.
- Cloudflare Bypass: Implemented a native Cloudflare bypass using
webview_all. - Enhanced Installer: Added support for atomic/immutable Linux distributions and a more robust user-space installation.
- Download Task Tracking: Added error reason tracking and stream subscription management to download tasks.
Bug Fixes
- Resolved background and search crashes.
- Fixed various installer issues, including cache path resolution, false immutable detection, and library checks.
- Corrected player progress and total duration display from milliseconds to seconds.
- Addressed player wakelock issues.
- Improved subtitle loading, fixed progress tracking, and enhanced playback resumption in the player.
- Resolved custom subtitle loading issues for Cloudflare-protected content.
- Fixed deep link argument forwarding for desktop applications (Linux/Windows).
- Corrected history routing issues when pushing continue items to prevent URL slashes problems.
- Fixed a fallback issue where the custom JSON picker failed in backup settings.
Improvements
- Player Performance: Significantly improved overall player performance.
- Subtitle Handling: Enhanced subtitle matching, resolution logic using language aliases and scoring, and improved subtitle handling in the media player and batch downloads.
- Stream Quality: Improved stream title and quality label cleaning logic for better display.
- UI Performance: Optimized wallpaper palette extraction with caching and reduced thumbnail capture pixel ratio.
- Discovery Screen: Enhanced quick tiles skeleton loader with genre headers and realistic dummy items.
- Episode Discovery: Improved media matching and error handling in the episodes discovery panel.
- History & Data: Unified watch and read history with improved data resilience.
- Discord RPC: Optimized Discord RPC integration and improved settings customization.
- Image Loading: Introduced a
SmartImagewidget for improved network and layout configurations. - UI Consistency: Refined CalendarDayRow layout for consistent spacing and styling.
- Media Titles: Improved media title properties and added an HTTP client cache interceptor.
Full Changelog: https://github.com/roshancodespace/ShonenX/compare/v2.1.4-hotfix.1...v2.1.5
- v2.1.4-hotfix.12026-09-25 · 2026-09-25 08:36 UTC
查看更新说明
v2.1.4-hotfix.1
New Features & Improvements
- UI/UX:
- Implemented a responsive layout system and a new docked header style.
- Enhanced avatar selection interface and functionality for tracker profiles.
- Improved the display of user bios for Anilist profiles.
- Tracker Profiles:
- Added display of manga status counts.
- Video Playback:
- Introduced video format detection for HLS streams.
- Linux:
- The installer now registers protocol handlers for better system integration.
Bug Fixes
- Resolved an issue where extensions did not correctly handle
/index.jsonpaths.
Full Changelog: https://github.com/roshancodespace/ShonenX/compare/v2.1.4...v2.1.4-hotfix.1
- UI/UX:
- v2.1.42026-09-23 · 2026-09-23 15:05 UTC
查看更新说明
Release Notes - v2.1.4
New Features
- Integrated Better Player engine and settings, replacing the old Video Player engine.
- Added "Continue Watching" and "Continue Reading" sections to the home feed.
- Introduced customizable home header styles.
- Added support for local subtitle loading and multi-server subtitle aggregation.
- Added Markdown support to tracker profile bio display and updated title thresholds.
- Added a filtered discover route and increased tracker pagination limits.
- Added log file rotation and initialization safety to the app logger.
Bug Fixes
- Fixed brightness and volume resetting when toggling the player lock.
- Fixed missing subtitles and audio tracks for MKV files.
- Fixed an issue where extensions failed to install.
- Fixed missing
libmpv.soerror on Android 8. - Fixed batch downloading not recognizing watched episodes.
- Fixed unwanted characters appearing in media descriptions.
- Fixed volume and brightness control swap.
- Resolved an autoDispose provider lifecycle crash.
- Redesigned and overhauled the player server and subtitle sheet layouts.
Improvements & UI/UX Enhancements
- Updated the episode metadata fetching fallback order to: AniZip -> Tenrai -> Kitsu.
- Optimized download progress handling, throttled notifications, and transitioned to the byte_me ecosystem for downloads.
- Enhanced subtitle handling architecture and UI components.
- Improved time-remaining formatting to display both hours and minutes.
- Optimized image loading logic to prioritize widget media covers and included HTTP headers.
- Centralized navigation bar styling using
NavBarThemeData. - Refactored player controls into a dedicated overlay with modular widgets and adjusted scaling factors for different screen widths.
- Removed the
SafeAreawrapper from player top controls to improve layout. - Simplified the sources tab variant layout and item presentation.
- Configured Discord RPC to automatically disconnect when the app is detached.
- Updated media kit libraries and plugin references for improved performance across platforms.
Full Changelog: https://github.com/roshancodespace/ShonenX/compare/v2.1.4-alpha.3...v2.1.4
- v2.1.4-alpha.32026-09-12 · 2026-09-12 13:46 UTC
查看更新说明
v2.1.4-alpha.3
Features
- Introduced a dedicated TV library screen.
- Added a manual match dialog.
- Implemented keyboard navigation for settings and details sections.
- Enabled torrent stream resolution.
- Enhanced episode metadata parsing with regex support.
Improvements
- Simplified and optimized the Discover screen.
- Improved filter UI feedback.
Bug Fixes
- Resolved an issue causing stream delays.
- Fixed connection issues related to Anilist tag requests.
Full Changelog: https://github.com/roshancodespace/ShonenX/compare/v2.1.4-alpha.2...v2.1.4-alpha.3
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
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
[!CAUTION]
Legal & DMCA Disclaimer
01. Service Nature: ShonenX does not host, upload, or own any of the media you see in the app. It's simply a frontend client—a glorified web browser. We do not have servers hosting anime.
02. APIs & Metadata: The covers, synopses, and schedules are pulled directly from public APIs like AniList, MyAnimeList, and Kitsu. ShonenX merely displays the metadata they provide.
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. Ensure you follow your local laws; we are not your lawyers. If you're a copyright holder looking to DMCA someone, please contact the extension developers or the host of the video files.
Supporters
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
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
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
Option 1: Flatpak (Recommended — Sandboxed & Universal)
Download the ShonenX-linux-x86_64.flatpak bundle from the Releases page and install:
flatpak install --user ShonenX-linux-x86_64.flatpak
Run with:
flatpak run com.roshancodespace.shonenx
(Flatpak bundles all native multimedia dependencies such as libmpv in an isolated sandbox, ensuring seamless playback across any distribution, including Steam Deck / SteamOS, Fedora Silverblue, Arch, and Ubuntu).
Option 2: Universal Install Script
We provide an interactive shell installation script for Linux. It fetches the latest release, configures desktop shortcuts, registers URL protocol handlers, and sets up your PATH automatically:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/roshancodespace/ShonenX/main/install.sh)"
Note: You can run this same command again to update or uninstall ShonenX safely!
Option 3: AppImage & Portable Zip
Download ShonenX-linux-x86_64.AppImage or ShonenX-linux.zip directly from GitHub Releases.
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. Expect potential bugs, quirks, and manual sideloading/signing requirements.
🛠️ Build from Source
Prerequisites: Flutter SDK ≥3.8.1, Git, Rust
- Linux Dependencies: Building on Linux requires GTK,
libmpv, andlibwpewebkit(Ubuntu/Debian:sudo apt install libgtk-3-dev libmpv-dev libwpewebkit-1.0-dev, Arch Linux:sudo pacman -S gtk3 mpv wpewebkit). See the Local Setup Guide for details.
git clone https://github.com/roshancodespace/ShonenX.git
cd ShonenX
flutter pub get
dart run build_runner build -d
flutter run # Select your device/platform
Contributing
Contributions are welcome. Before opening a PR, please review the Contribution Guidelines.
For significant features, architectural changes, dependency changes, or structural refactors, please open an issue for discussion before submitting implementation work.
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: [email protected]
Discord: Join Community
License: GPL-3.0 (See LICENSE file)
⭐ Star this repo if you find it useful!
Crafted with ❤️ by Roshan Kumar & Contributors