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)

danmaku
Searching Database…

What is this?A native Windows media aggregation and streaming client: it pulls film and TV streams from TVBox/CatVod-style sources and plays them with 4K hardware acceleration in a WinUI 3 Fluent interface.
Does it come with content, or do I bring my own sources?You bring your own: it is strictly a local player that hosts nothing. You import TVBox/CatVod subscription and site configs yourself, or authorize your own cloud-drive accounts.
Do I need to install anything else first?No. It is fully self-contained — the .NET 8 and Windows App SDK runtimes plus a portable mpv playback engine are bundled. You only need Windows 10 (build 17763 or newer) or Windows 11 64-bit.
Will the sources it finds always work?Not guaranteed. Streams come from third-party public sources you configure yourself, and the developers take no liability for their validity, legality, accuracy, or availability.
Does it need access to any of my accounts?Only if you want cloud-drive streaming: an in-app QR console lets you scan-to-login with Quark, UC, Alibaba Cloud, Baidu Netdisk, or 115 for automated transfers and 4K direct streaming.
Is it free and open source?Yes — MIT licensed. The README adds that it is intended for research and education, and prohibits unauthorized commercial or copyright-infringing use.
Do I need a powerful graphics card for the 4K playback?Decoding is GPU-accelerated by the bundled Yaozhi-MPV engine — 4K UHD, HEVC/H.265, Dolby Vision, and 60/120FPS — though the README names no minimum GPU model.
Where do the streams come from, and can I search across them?From TVBox/CatVod subscription configs you import, including encrypted .js.md5 and Base64 ones — spiders run as isolated microservices with dynamic hot-loading and crawler script caching. Cross-source aggregate search then queries all active subscription sites concurrently, with multi-level category filters.
What player is under the hood, and can I swap it?A portable Yaozhi-MPV engine is bundled at runtime/mpv/mpv.exe, so 4K playback works out of the box. In Settings you can instead point to your own external mpv.exe to use your mpv.conf, shaders like Anime4K or FSRCNNX, custom keybindings, and Lua scripts.
Can I see what quality I am actually getting?Yes — a real-time telemetry panel extracts the actual decoded resolution (e.g. 1080P FHD or 4K UHD), pixel dimensions, video/audio codecs, and live stream bitrate while you watch.
Can I customize how the app looks?Yes — native WinUI 3 Fluent styling with Mica/Acrylic materials, real-time switching between Light, Dark, and System themes, plus four app icon styles (Classic Blue, Aurora Pink, Obsidian Dark, Neon Cyber) that also update the Taskbar and Title Bar.
Creator
Ainanya21
Size
31 MB
Stars
331
Age
2mo
Commits · 90 Days