AinanPlayer README

The project's README from github.com/Ainanya21/AinanPlayer. As one markdown file: README.md.

Logo AinanPlayer

Modern Windows 11 Media Aggregation & 4K Hardware-Accelerated Streaming Platform

Platform Framework .NET Telegram Channel Telegram Group License

🌐 English | 简体中文

Download • User Guide • Screenshots • Features • Requirements • Cloud Authorization • Community • Disclaimer • Support • Credits


Interface Preview

Home Recommendations


Media Details & Multi-Source Episode Selection (Yaozhi-MPV Hardware Acceleration)

Media Details


Personalization & Appearance (Seamless Light/Dark Themes & Accent Color Picker)

Appearance Settings


4K 60FPS Hardware Acceleration & Live Danmaku Playback (Real-Time Decoding Stats)

Video Player


Key Features


System Requirements


Download & Installation

Visit the Releases Page to download the latest release:

Package Type Description Recommended Usage
AinanPlayer_vX.X.X_Setup.exe Modern graphical setup wizard with custom install path and desktop shortcut Recommended for most users; supports in-app updates
AinanPlayer_vX.X.X_Portable.zip Portable standalone green archive Extract and run directly; ideal for USB drives

Cloud Drive Authorization

To stream 4K original quality resources from cloud aggregators, authenticate your cloud accounts:

  1. Open AinanPlayer and navigate to "Home Recommendations" (首页推荐) on the sidebar.
  2. In the top source dropdown, select "Config Center" (配置中心) (or via "Settings" -> "Cloud Storage Authorization").
  3. Use the mobile app of your cloud drive (Quark / UC / Alibaba Cloud / Baidu Netdisk / 115) to scan the QR code.
  4. Once authorized, the backend will automatically handle automated transfer and high-speed direct stream parsing.

Community & Feedback

Join our official community channels for subscription updates, discussions, and release announcements:


Playback Engine & Customization

AinanPlayer hardware acceleration is fully powered by Yaozhil/mpv-Yaozhi, supporting both Built-in Out-of-the-Box and Customizable External playback modes:

  1. Default Built-in Playback: Ready to play immediately upon extracting or installing. Uses the bundled high-performance Yaozhil/mpv-Yaozhi hardware acceleration engine (runtime/mpv/mpv.exe) with zero third-party dependencies required.
  2. Customizable External Yaozhi-MPV:
    • Navigate to "Settings" -> "Playback Engine Settings".
    • Toggle on "Enable External MPV Hardware Acceleration".
    • Click "Browse..." to select your own Yaozhil/mpv-Yaozhi mpv.exe path (e.g. D:\Yaozhi-MPV\mpv.exe).
    • Click "Test Launch MPV" to verify. Playback will then automatically load your external shaders, scripts, and keybindings.
  3. Customizable Application Icons:
    • Select between Classic Blue, Aurora Pink, Obsidian Dark, or Neon Cyber under "Settings" -> "Appearance" to instantly switch the Taskbar and Title Bar icons.

Support the Project

If AinanPlayer enhances your multimedia experience, donations to support ongoing development are greatly appreciated:

WeChat Pay (微信赞赏) Alipay (支付宝收款)
WeChat Pay QR Alipay QR

Your support enables continuous development, ecosystem enhancements, and optimal playback experiences. Thank you! ❤️


Credits & Acknowledgments

This project is built upon or inspired by the following outstanding open-source projects:


Disclaimer

  1. Local Tool Nature: AinanPlayer is strictly a local client and media player built on WinUI 3 and open-source media engines. The software does not host, store, broadcast, or transmit any audio, video, subtitle, or image resources.
  2. Third-Party Data Sources: All subscriptions, site crawlers, cloud accounts, and playback links are configured or imported by users from third-party public sources. The developers assume no liability for the validity, legality, accuracy, or availability of third-party sources.
  3. Lawful Usage: This project is intended for research, programming education, and multimedia technology exchange. Users must comply with local laws and intellectual property rights. Any unauthorized commercial or copyright-infringing use is strictly prohibited.
  4. Copyright Notice: If any copyright holder believes user-imported third-party sources infringe their rights, please contact the respective third-party hosting service or API provider directly.

License

This project is open source under the MIT License.

AinanPlayer (Ainanya21/AinanPlayer)

Searching Database…

这是什么?一款 Windows 原生的影视聚合与播放客户端:它从 TVBox/CatVod 类型的源拉取影视流,并在 WinUI 3 Fluent 界面中以 4K 硬件加速播放。
它自带内容吗,还是我要自己准备源?需要自己准备:它只是一个纯粹的本地播放器,本身不托管任何内容。你需要自行导入 TVBox/CatVod 订阅和站点配置,或者授权你自己的网盘账号。
我需要先安装其他东西吗?不需要。它完全自包含——内置了 .NET 8 和 Windows App SDK 运行时,以及便携版 mpv 播放引擎。你只需要 Windows 10(build 17763 或更新)或 Windows 11 64 位系统。
它找到的源一定能用吗?无法保证。视频流来自你自行配置的第三方公开源,开发者对其有效性、合法性、准确性或可用性不承担任何责任。
它需要访问我的账号吗?只有当你想用网盘在线播放时才需要:应用内置的扫码登录控制台支持夸克、UC、阿里云盘、百度网盘或 115,可用于自动转存和 4K 直链播放。
它免费开源吗?是的——采用 MIT 许可证。README 还说明它仅供研究和学习用途,禁止未经授权的商业使用或侵犯版权的使用。
播放 4K 需要很强的显卡吗?解码由内置的 Yaozhi-MPV 引擎进行 GPU 加速——支持 4K 超高清、HEVC/H.265、杜比视界以及 60/120 帧——不过 README 中没有给出最低显卡型号要求。
视频流从哪里来?能跨源搜索吗?来自你导入的 TVBox/CatVod 订阅配置,包括加密的 .js.md5 和 Base64 格式——爬虫以隔离的微服务方式运行,支持动态热加载和爬虫脚本缓存。跨源聚合搜索会并发查询所有已启用的订阅站点,并提供多级分类筛选。
底层用的是什么播放器?可以更换吗?内置了便携版 Yaozhi-MPV 引擎(位于 runtime/mpv/mpv.exe),因此 4K 播放开箱即用。你也可以在设置中改为自己指定的外部 mpv.exe,以使用你的 mpv.conf、Anime4K 或 FSRCNNX 等着色器、自定义快捷键以及 Lua 脚本。
我能看到实际播放的画质吗?可以——实时遥测面板会在观看时显示实际解码分辨率(例如 1080P FHD 或 4K UHD)、像素尺寸、视频/音频编码以及实时码率。
应用的外观可以自定义吗?可以——采用原生 WinUI 3 Fluent 样式和 Mica/Acrylic 材质,可在浅色、深色和跟随系统主题间实时切换,还提供四种应用图标样式(Classic Blue、Aurora Pink、Obsidian Dark、Neon Cyber),同时会更新任务栏和标题栏图标。
Creator
Ainanya21
Size
31 MB
Stars
331
Age
2mo
Commits · 90 Days