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 и воспроизводит их с аппаратным ускорением 4K в интерфейсе WinUI 3 Fluent.
Встроенный контент есть, или мне нужно добавлять свои источники?Свои: это строго локальный плеер, который ничего не хостит. Вы сами импортируете подписки и конфиги сайтов в формате TVBox/CatVod или подключаете свои аккаунты облачных дисков.
Мне нужно сначала что-то ещё установить?Нет. Программа полностью автономна — в неё уже включены среды выполнения .NET 8 и Windows App SDK, а также портативный движок воспроизведения mpv. Нужна только Windows 10 (сборка 17763 или новее) или Windows 11 64-бит.
Найденные источники всегда будут работать?Это не гарантировано. Потоки берутся из сторонних публичных источников, которые вы настраиваете сами, и разработчики не несут ответственности за их работоспособность, законность, точность или доступность.
Приложению нужен доступ к моим аккаунтам?Только если вы хотите стримить с облачных дисков: встроенная QR-консоль позволяет войти по QR-коду в Quark, UC, Alibaba Cloud, Baidu Netdisk или 115 для автоматических переносов и прямого 4K-стриминга.
Это бесплатно и с открытым кодом?Да — лицензия MIT. В README уточняется, что проект предназначен для исследований и обучения, а несанкционированное коммерческое использование и нарушение авторских прав запрещены.
Для 4K-воспроизведения нужна мощная видеокарта?Декодирование ускоряется на GPU встроенным движком Yaozhi-MPV — 4K UHD, HEVC/H.265, Dolby Vision и 60/120FPS — но в 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