mpv-anime-build

Chinna95PMIT活跃维护

一套能自动识别动漫画面的 MPV 播放器配置,集成 Anime4K、ArtCNN 等超分着色器,按 SD/HD 和动漫/真人自动切换画质管线。

Anime-aware (Auto-Detection) MPV configuration with Anime4K, ArtCNN, FSRCNNX, NNEDI, SD/HD pipelines for Anime and Live-Action and clean OSD

v5.6发布于 2026-10-13 15:01 UTC235star3fork同步于 2026-11-11 00:02 UTC

怎么上手

由 README 提炼,执行前请确认
1. 安装 64 位 MPV(推荐 shinchiro 构建)
2. 将构建内容解压到 %APPDATA%/mpv/(Windows)或 ~/.config/mpv(Linux)
硬件要求按 README 说明

README 未说明具体显存或 GPU 型号要求;RTX VSR 需 Nvidia RTX 显卡,SVP 为可选组件。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

面向动画与真人视频的 MPV 播放配置,自动识别内容并切换 AI 放大与着色器管线

一套能自动识别动漫画面的 MPV 播放器配置,集成 Anime4K、ArtCNN 等超分着色器,按 SD/HD 和动漫/真人自动切换画质管线。

核心能力

  • 按动画/真人内容自动切换 Anime4K、ArtCNN、FSRCNNX、NNEDI 着色器管线
  • 内置 UOSC 定制界面,支持菜单调参、字幕搜索与状态叠加显示
  • 跨平台按显示器映射音频设备,并显示可读的显示器型号
  • 提供 HDR 直通与色调映射选项,支持 Windows 与 KDE 的 HDR 状态
  • 支持 RTX VSR、SVP 共存与 Smart Skip 片头片尾跳过

容易踩的坑

需安装附带的 Source Sans Pro 字体,否则 Stats 叠加层显示异常;自定义覆盖文件必须只保留一个 mpv-*.conf,多个同时存在会导致全部不加载;UOSC 上游自更新已被移除,需手动检查更新。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v5.6
  1. v5.6MPV Anime Build v5.6最新正式版2026-10-13 · 2026-10-13 15:01 UTC

    MPV Anime Build v5.6

    [v5.6] – FSR Shader Options, HDR Toys Stability & Subtitle Search Fixes

    🎛️ Shader Controls

    • FSR Shader Swapper Options: Added FSR/FSRCNNX variant choices to the Anime Build shader swapper so alternate reconstruction and scaling profiles are available from the customized UOSC menus.
    • HDR Toys Pipeline Race Fix: Stabilized HDR Toys shader pipeline handling so the HDR Toys shader chain remains reliable alongside Anime Build profile changes.

    💬 Subtitle Downloader

    • Query-First OpenSubtitles Search: Updated UOSC subtitle search to use query text or the current search suggestion before falling back to moviehash lookup, avoiding OpenSubtitles/Cloudflare connection resets seen with combined moviehash + query requests.

    📚 Agent Documentation

    • Customized UOSC Scope: Documented scripts/uosc/lib/menus.lua as a high-risk customized UOSC file alongside scripts/uosc/main.lua, including the subtitle downloader/search behavior that must be preserved during future UOSC ports.

    The Link to Full Changelog: Changelog Full


    🛡️ Automated VirusTotal checks

    These results are generated automatically from the downloadable release ZIP. They provide scanner transparency but are not an absolute guarantee of safety.

    mpv-anime-build-v5.6.zip

    • SHA-256: 291fca874d8a31b56b98fa62ea331ba33889de94dbf1129c081881b907936377
    • Result: 2 malicious, 0 suspicious, 64 undetected and 0 harmless out of 75 engine results
    • Scanned: 2026-10-13 15:02 UTC
    • Report: View the complete VirusTotal analysis

    Flagged engines:

    • Bkav: W32.Malware.D00355EB
    • Fortinet: PossibleThreat.PALLASNET.M
  2. v5.5MPV Anime Build v5.52026-10-04 · 2026-10-04 10:16 UTC
    查看更新说明

    [v5.5] – HDR Toys and Adaptive Sharpen 2-pass Overhaul

    🌈 HDR & Tone-Mapping

    • HDR Toys UI: Integrated interactive HDR Toys sub-menu within the Audio & HDR UOSC control section. Enables advanced real-time gamut (Bottosson) and tone-mapping (Astra) adjustments with persistent configuration state.
    • Unified 2-Pass Sharpening: Upgraded all resolution-specific and generic Adaptive Sharpen shaders to the purist 2-pass DX11 framework. Provides significant edge anti-ringing improvements relying on explicitly calibrated L_overshoot and D_overshoot structures.
    • Calibrated Strength Curves: Responsibly lowered all curve_height sharpening coefficients globally by 25% for a much more balanced refinement over native/anime imagery without aggressive haloing.

    🛡️ Automated VirusTotal checks

    These results are generated automatically from the downloadable release ZIP. They provide scanner transparency but are not an absolute guarantee of safety.

    mpv-anime-build-v5.5.zip

    • SHA-256: 4666f23faa40ed00f1940838134cc6048ab1257844d55adf8101f6f6d706a18f
    • Result: 2 malicious, 0 suspicious, 64 undetected and 0 harmless out of 75 engine results
    • Scanned: 2026-10-04 10:17 UTC
    • Report: View the complete VirusTotal analysis

    Flagged engines:

    • Bkav: W32.Malware.D00355EB
    • Fortinet: PossibleThreat.PALLASNET.M
  3. v5.4MPV Anime Build v5.4 — Cross-Platform Audio Switching, Subtitle Lines & Refined Overlays2026-09-11 · 2026-09-11 11:00 UTC
    查看更新说明

    MPV Anime Build v5.4

    💬 Subtitle Navigation

    • Searchable Subtitle Lines: Added mpv-subtitle-lines for browsing and seeking to dialogue in the selected primary or secondary subtitle track.
    • Contextual UOSC Control: Added a Subtitle Lines button immediately to the right of UOSC's normal subtitle button. It opens the primary subtitle-line browser and remains hidden when no subtitle track is available.
    • Keyboard Access: Added CTRL+f for primary subtitle lines and CTRL+F for secondary subtitle lines.

    🔊 Audio Devices

    • Quiet Startup Detection: auto-audio-device.lua now treats an empty display-names list as MPV's normal pre-window startup state instead of printing a misleading Unknown display return value warning.
    • Readable Linux and Windows Display Names: Linux DRM EDID data is decoded directly in Lua, while Windows asynchronously correlates MPV's GDI display identifier through EnumDisplayDevicesW and WmiMonitorID. Console output can therefore identify displays as DP-1 (MSI G241) or \\.\DISPLAY1 (MSI G241) while retaining the connector/GDI identifier as the unambiguous mapping key.
    • Safe Windows Lookup: Windows monitor-name resolution is cached, runs through a hidden non-interactive PowerShell process without blocking playback, falls back to the native GDI identifier when unavailable, and is skipped entirely when display-name logging is disabled.
    • Safer Windows Invocation: The inline Windows lookup does not request an execution-policy bypass, reducing unnecessary security-tool scrutiny while preserving the same lookup behavior.
    • Portable User Mappings: Replaced the bundled machine-specific macOS CoreAudio mappings with configurable display-to-device mappings in script-opts/auto_audio_device.conf, supporting MPV's native identifiers on Linux, Windows, and macOS without editing the Lua script.
    • Safe Unmatched Displays: Displays without a configured mapping now preserve the active audio device by default. An optional fallback can explicitly restore the former audio-device=auto behavior.
    • Decorated-Key Guidance: A one-time warning now identifies mappings copied from a readable console label such as DP-1 (MSI G241) and directs the user to the required raw connector/GDI key.
    • Existing Controls Preserved: The CTRL+a automatic-switching toggle and public set-audio-device/toggle-switching script bindings remain available.

    📊 Status Overlay & OSD Fonts

    • Accurate Context-Aware Shader Reporting: The CTRL+i statistics overlay now combines the controller's authoritative Anime/Live/Fidelity context with the actual primary shader variant. FSRCNNX remains correctly identified when Anime Fidelity includes an Anime4K restoration pass, while native 4K Fidelity, Anime4K Performance, Anime4K Ultra, ArtCNN, and every selectable FSRCNNX/NNEDI3 counterpart are reported separately.
    • Current Shader Variant Names: Updated FSRCNNX detection for the current Anime Mild and Anime Aggressive filenames while retaining compatibility with their legacy names and all selectable custom variants.
    • Clear Context and Scaler Rows: Anime Fidelity, Anime Performance, and Live Action are shown separately from the actual scaler variant, avoiding ambiguous counterpart labels. The glass panel is wider and taller so the longest shader, resolution, audio, and HDR values remain inside its bounds with readable spacing.
    • Consistent OSD Text: MPV's global OSD, UOSC text, built-in media information, and the Anime Build statistics overlay now use the build's bundled Microsoft Sans Serif font on every platform, preventing Linux font fallback from rendering numbers smaller than the surrounding text.
    • Balanced Interface Font Sizing: Applied a consistent size correction across native MPV messages, Ctrl+i and built-in statistics, the K A/V filter display, UOSC text, Smart Skip and Up Next cards, audio metadata, and the Anime Profile, HDR, Power, and VSR overla
  4. v5.3MPV Anime Build v5.3 — Update-Safe Integrations, Smarter Subtitles & Release Security2026-09-05 · 2026-09-05 04:04 UTC
    查看更新说明

    MPV Anime Build v5.3

    ⚙️ Configuration

    • Custom MPV Override File: Added automatic cross-platform loading for one mpv-<custom-name>.conf file placed beside mpv.conf. The file loads after the shipped configuration, allowing personal values such as fullscreen=no to override build defaults without modifying tracked files.
    • Safe Discovery: If multiple matching custom files are present, none are loaded and MPV reports the conflict instead of applying an ambiguous precedence order.
    • Override Separation: Documented that mpv-*.conf files control normal MPV options, while the existing user-*.conf layer continues to store remembered Anime Build menu settings.

    🔌 External Players, IPC & SVP

    • External IPC Preservation: Reworked mpvSockets.lua so an IPC endpoint supplied by MediaFlick or another external controller remains authoritative instead of being silently replaced.
    • Shared Unix Discovery: Linux and macOS sessions with an externally owned IPC socket expose a per-process alias under the standard mpvSockets directory, allowing SVP and other discovery-based integrations to attach without disconnecting the controlling application.
    • Safe SVP Profile Isolation: The Windows and Unix SVP profiles no longer replace externally supplied IPC endpoints. Normal standalone MPV sessions retain the existing SVP pipe/socket behavior.
    • Native Windows Handling Preserved: Standalone Windows sessions continue using per-process named pipes without opening command windows.

    💬 Subtitle Selection

    • Commentary Exclusion: Commentary subtitle tracks are excluded from every automatic selection path, including preferred-language, dialogue, muxer-default, and language-fallback matching.
    • Complete SDH Last Resort: When no usable clean subtitle exists, the selector falls back to a complete SDH or hearing-impaired track even when its language metadata is missing or outside slang.
    • Safe Commentary Disable: If MPV initially activates commentary and no usable clean or SDH fallback exists, automatic selection disables subtitles instead of retaining commentary. Explicit manual selections and saved manual overrides remain respected.

    🎨 Smart Skip

    • Contrast-Separated Intro/PV Colors: Swapped the Intro and PV colors in both skip_intro.lua and the UOSC chapter timeline. Intro now uses magenta (#FF00FF) and PV uses orange (#FF9900), improving contrast between neighboring chapter ranges while preserving OP green and ED blue.
    • Synchronized Color Documentation: Updated the README, cheat sheet, website descriptions, and repository guidance to use the same current Smart Skip palette.

    🛡️ UOSC Update Safety

    • Upstream Self-Updater Removed: Removed UOSC's Update uosc menu entry, script binding, and updater implementation. UOSC is customized for MPV Anime Build, so installing an upstream UOSC release in place could overwrite main.lua and remove Anime Build menus and integrations.
    • Direct Release Access: The separate System → Check for Updates entry remains available and checks MPV Anime Build releases without replacing customized UOSC files. Manually selecting it now displays the latest version and opens that exact GitHub release in the default browser; automatic startup checks never open a browser.

    🛡️ Release Verification

    • Automated VirusTotal Reports: Added a GitHub Actions workflow that scans every ZIP attached to a published release, reuses reports for matching SHA-256 hashes, supports VirusTotal's large-file upload endpoint, and appends a replaceable results section without modifying the handwritten release notes.
    • Historical Backfill Support: Release scans can also be launched manually for an existing tag, allowing older ZIP releases to receive the same transparent report.

    ✅ Validation

    • Validated external IPC preservation and simultaneous SVP attachment through the MediaFlick playback pipeline on Linux.
    • Tested Track Selector against p
  5. v5.2MPV Anime Build v5.22026-08-30 · 2026-08-30 17:20 UTC
    查看更新说明

    [!IMPORTANT] The original v5.2 ZIP was uploaded with an incorrect script-folder structure, which prevented MPV scripts from loading. Please download the updated mpv-anime-build-v5.2.zip from this release and reinstall the build. If you previously downloaded v5.2, replace that copy with the updated ZIP.


    MPV Anime Build v5.2

    Reliable Live-Action Detection and Safer Playback Defaults

    MPV Anime Build v5.2 restores the explicit Live-Action path/title override in Auto mode, makes Thumbfast thumbnail generation use its safer software-decoding default, limits yt-dlp subtitle requests to English, and corrects the documented Smart Skip colors.

    📦 Updating from v5.1

    A fresh installation is not required when updating from v5.1. Extract the complete v5.2 package over your existing configuration while keeping personal user-<custom-name>.conf files and other runtime-generated user files. They are not included in the release archive and will continue to persist.

    The bundled mpv.conf and script-opts/thumbfast.conf contain the stream-subtitle and thumbnail-decoding changes. If you maintain customized copies of those files, merge the new values rather than skipping them.

    Users upgrading from v4.9 or earlier should still follow the one-time clean-install guidance introduced with v5.0 because the configuration-layout and shader-name migration remains necessary.

    🎬 Restored Live-Action Auto Detection

    • Reconnected is_live_action(path, title) to the controller’s main evaluation flow.
    • Explicit Live Action, Live-Action, liveaction, drama, and real person markers now override Anime folder, Japanese-audio, release-syntax, and CRC signals in Auto mode.
    • Forced Anime Mode behavior is unchanged.
    • Resolution-aware Live-Action profiles continue to be selected normally after detection.

    🖼️ Safer Thumbfast Thumbnails

    • Changed the shipped Thumbfast option from hwdec=yes to hwdec=no.
    • This matches Thumbfast’s built-in safe default and avoids requiring a compatible hardware decoder in its helper process.
    • Main video playback hardware decoding is not changed by this Thumbfast option.

    🌐 Focused Stream Subtitles

    • Removed the unintended Telugu te and tel requests from yt-dlp arguments.
    • Authored and automatic stream subtitles now request en and en-orig only.

    🎨 Correct Smart Skip Colors

    • Corrected website screenshot descriptions and chapter-timeline documentation to match the displayed colors: OP green, ED blue, PV magenta, and Intro orange.

    ✅ Validation

    • Verified the 1920×1080 Ranma ½ Live-Action.mkv case inside an Anime folder with Japanese audio selects the Live-Action context and FHD-Native profile in Auto mode.
    • Loaded the affected controller and Thumbfast scripts through mpv’s embedded Lua runtime without script errors.
    • Validated the updated yt-dlp option syntax with mpv.
    • Integrity-tested the install-ready ZIP and confirmed it matches the 315-entry flat package layout used by v5.1.

    The Link to Full Changelog: Changelog Full


    🛡️ Automated VirusTotal checks

    These results are generated automatically from the downloadable release ZIP. They provide scanner transparency but are not an absolute guarantee of safety.

    mpv-anime-build-v5.2.zip

    • SHA-256: 510ae78050f2c7cb060e771255daebb23320ab44e9c54c68da0cbed833c89227
    • Result: 2 malicious, 0 suspicious, 62 undetected and 0 harmless out of 75 engine results
    • Scanned: 2026-09-05 01:26 UTC
    • Report: View the complete VirusTotal analysis

    Flagged engines:

    • Bkav: W32.Malware.D00355EB
    • Fortinet: PossibleThreat.PALLASNET.M

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    🎬 MPV Anime Build v5.6

    The Cross-Platform Audio Switching & Dialogue Search Update: cross-platform display-to-device audio mapping, human-readable display identification, searchable subtitle dialogue browser, refined status overlays, and balanced interface fonts.

    Discord Ask DeepWiki Sponsor on GitHub Buy Me a Coffee

    An advanced, context-aware MPV configuration featuring AI upscaling, dynamic power management, universal HDR support, and intelligent audio processing.

    📱 Android Support Available

    The MPV Anime Build is also available for Android (mpvEX / Aniyomi)!

    • Features: Gesture Controls, Smart Auto-Detection, and Optimized Shaders for mobile.
    • Download: Switch to the Android Branch to get the mobile-specific files.

    Note for HDR Users: Auto (Detected) follows active Windows HDR displays and KDE Plasma's Linux HDR state. Other Linux compositors use mpv's native colorspace negotiation. HDR Display (Passthrough) remains available as a manual override when a display driver does not expose its HDR state correctly.


    🚀 What's New in (v4.0 - v5.6)

    • 🧩 FSR Shader Swapper Options (v5.6): Added FSR/FSRCNNX variant choices to the Anime Build shader swapper so alternate reconstruction and scaling profiles can be selected from the customized UOSC menus.

    • 🌈 HDR Toys Pipeline Stability (v5.6): Fixed HDR Toys shader-pipeline race behavior and documented the HDR Toys button, menu flow, and release packaging requirements for future agent work.

    • 💬 Reliable UOSC Subtitle Search (v5.6): Updated the UOSC subtitle downloader to prefer text-query searches when a query or suggestion exists, avoiding OpenSubtitles moviehash request resets while preserving hash lookup when no query is available.

    • 📚 UOSC Agent Documentation (v5.6): Marked scripts/uosc/lib/menus.lua as a customized/high-risk UOSC file alongside scripts/uosc/main.lua so future upstream ports preserve Anime Build menu and subtitle-search behavior.

    • HDR Toys UI (v5.5): Integrated interactive HDR Toys sub-menu within the Audio & HDR UOSC control section. Enables advanced real-time gamut (Bottosson) and tone-mapping (Astra) adjustments with persistent configuration state.

    • Unified 2-Pass Sharpening (v5.5): Upgraded all resolution-specific and generic Adaptive Sharpen shaders to the purist 2-pass DX11 framework. Provides significant edge anti-ringing improvements relying on explicitly calibrated L_overshoot and D_overshoot structures.

    • 🔊 Cross-Platform Audio Device Switching (v5.4): Configurable display-to-device audio mappings in script-opts/auto_audio_device.conf supporting Linux, Windows, and macOS. Displays without a mapping safely preserve the active audio device by default.

    • 🖥️ Human-Readable Display Names (v5.4): Decodes Linux DRM EDID directly in Lua and resolves Windows display identifiers asynchronously to show readable monitor models (e.g., DP-1 (MSI G241)) in logs and console diagnostics.

    • 🔎 Searchable Subtitle Lines (v5.4): Added mpv-subtitle-lines for browsing and seeking to dialogue in the active primary or secondary subtitle track. The contextual Subtitle Lines UOSC button appears immediately next to the subtitle button; CTRL+f and CTRL+F provide keyboard access.

    • 📊 Refined Status Overlays & Unified OSD Fonts (v5.4): Context-aware shader reporting in CTRL+i, expanded glass overlay dimensions, unified bundled Microsoft Sans Serif OSD font across all platforms, and balanced font sizing across all overlays.

    • 🎨 Content-Aware Debanding Rebalance (v5.4): Anime profile debanding tuned to 40/20/6 for gradient cleanup while preserving fine art textures. Low-End and 8K profiles explicitly keep debanding disabled for performance.

    • 🔌 External Player, IPC & SVP Coexistence (v5.3): MediaFlick and other controllers retain ownership of their IPC endpoint while Unix systems expose a discoverable per-process alias for SVP and related integrations. Standalone Windows and Linux MPV sessions retain their normal named-pipe/socket behavior.

    • ⚙️ Update-Safe Personal MPV Config (v5.3): One mpv-<custom-name>.conf file can override normal options after the shipped mpv.conf, keeping personal choices separate from build updates while safely rejecting ambiguous multiple override files.

    • 💬 Commentary-Safe Subtitle Fallbacks (v5.3): Automatic selection completely skips commentary subtitles, preserves clean-track priority, and falls back to a complete SDH or hearing-impaired track when no usable clean subtitle exists—even without preferred-language metadata.

    • 🎨 Contrast-Separated Smart Skip Colors (v5.3): Intro and PV colors are swapped across Skip Intro and the UOSC timeline so adjacent chapters remain distinct: OP green, ED blue, PV orange, and Intro magenta.

    • 🛡️ Protected Customized UOSC (v5.3): Removed UOSC's upstream self-updater so it cannot overwrite the Anime Build's customized main.lua. A manual System → Check for Updates opens the exact latest Anime Build release, while automatic checks never launch a browser.

    • 🔍 Automated VirusTotal Reports (v5.3): Published ZIP assets receive SHA-256-specific VirusTotal results in their release descriptions, with support for large archives and historical release backfills.

    • 🎬 Restored Live-Action Path Override (v5.2): Explicit Live Action, Live-Action, liveaction, drama, and real person path/title signals once again take priority over Anime folder and Japanese-audio signals while Anime Mode is set to Auto.

    • 🖼️ Safer Thumbfast Decoding (v5.2): Thumbnail generation now explicitly uses software decoding by default, matching Thumbfast's built-in safe fallback and avoiding hardware-decoder instability in the helper process.

    • 🌐 English-Only Stream Subtitles (v5.2): yt-dlp automatic and authored subtitle requests are limited to English and original-English tracks; unintended Telugu language requests were removed.

    • 🎨 Correct Smart Skip Documentation (v5.2): Website image descriptions and chapter-timeline documentation were corrected to match the palette used in that release: OP green, ED blue, PV magenta, and Intro orange.

    • 🔋 Durable Eco Profile Ownership (v5.1): Power Saving now remains authoritative across file loads, metadata changes, and saved UOSC setting updates. User preferences are preserved for normal playback and restored deterministically when Eco mode ends.

    • 💬 Preferred-Language SDH Fallback (v5.1): When no clean preferred-language subtitle exists, the selector now chooses a preferred-language SDH or hearing-impaired track before an unrelated clean language, while still rejecting forced and signs-only tracks.

    • 🌈 Cross-Platform HDR Detection (v5.0): Windows uses the DisplayConfig API with a WMI compatibility fallback, KDE Plasma uses KScreen, and other Linux compositors defer safely to mpv's native colorspace negotiation. Windows and Linux detection paths remain strictly isolated.

    • 💾 Durable User Overrides (v5.0): UOSC Controls and HDR choices are remembered in untracked user-<custom-name>.conf files, loaded alphabetically and reapplied after profile evaluation so build updates do not overwrite personal settings.

    • 🧩 Community-Reported Reliability Fixes (v5.0): Fixed disabled track-selector overrides, wireless peripheral batteries forcing Linux desktops into Eco mode, and nil-sensitive profile conditions during startup.

    • 🎨 Clear Anime FSRCNNX Names (v5.0): Renamed the two easily-confused Anime FSRCNNX shaders to explicit anime_mild and anime_aggressive filenames, with automatic migration of saved legacy paths.

    • 🔋 Cross-Platform Power Guard (v4.9): Completely reworked power_manager.lua for automatic Windows and Linux support. Windows uses modern PowerShell/CIM battery monitoring, while Linux reads the native system power-supply interface without requiring PowerShell or manual platform-specific edits.

    • 🖥️ Smart Desktop/Laptop Detection (v4.9): Battery-equipped laptops retain automatic Eco switching on battery and smart restoration on AC power. Desktop systems cleanly use Manual Toggle Only mode without generating failed-subprocess warnings.

    • 🎞️ Safe Decoder Restoration (v4.9): Power Guard now remembers and restores the active hardware decoder instead of forcing a platform-specific value. This preserves D3D11VA on Windows and NVDEC, VA-API, Vulkan, or SVP copy-back decoding on Linux.

    • ✨ Smoother High-Quality Scaling (v4.9): Enabled MPV's built-in high-quality rendering foundation and changed Anime native scaling from ewa_lanczossharp to spline64 for smoother edges, reduced ringing, and more consistent rendering.

    • 📺 FHD-Native Profile Clarity (v4.9): Renamed the custom [High-Quality] profile to [FHD-Native] and synchronized controller state detection, profile evaluation, menus, and OSD labels to distinguish it from MPV's built-in high-quality profile.

    • 📸 Video-Only Screenshots (v4.9): Added F6 for clean video-frame screenshots alongside the existing F5 window screenshot shortcut.

    • 🧩 Optimized Anime Profile Controller & Main UI Logic (v4.8): Optimized anime_profile_controller.lua and main.lua to fix minor bugs and reduce unnecessary processing while preserving the existing profile system and menu synchronization.

    • 📂 Dedicated UOSC Open File Button (v4.8): Added an Open File button directly to the UOSC controls bar. It opens UOSC's file-selection menu for selecting video and audio files without leaving the player.

    • 🖼️ Image Filtering in Open File Menu (v4.8): The UOSC file browser can now be configured with load_types=video,audio, show_hidden_files=no, and an empty image_types value so poster/backdrop image assets are not shown alongside playable media.

    • 🎛️ Refined UOSC Behaviors (v4.8): Adjusted several UOSC controls and menu behaviors for a cleaner, more consistent MPV Anime Build experience.

    • 🎵 Track Selector Fixes & Refinements (v4.8): Updated track-selector.lua with the fixes and behavior changes developed for v4.8, improving track-selection reliability while retaining the manual-selection/override workflow.

    • 🎨 Resolution-Tuned Adaptive Sharpen & Anime Line-Thinner (v4.7): Adjusted sharpening and line-thinner strengths across resolution tiers for smoother, more soothing edges on both Anime and Live-Action content while retaining background and subject detail.

    • 📥 Working Stream Downloads (v4.7): Added the mpv-youtube-download script and connected it to the UOSC Download button. Stream downloads are saved to ~/ytdl by default and can be redirected through youtube-download.conf.

    • 🪟 Windows CMD Flash Fix (v4.7): Updated mpvSockets.lua to prevent command-window flashes on Windows when socket commands are issued.

    • 🌊 Expanded Audio-Only Visualizers (v4.7): Added new visualizer styles to the Audio-Only profile for more visual variety during music playback.

    • 🎛️ UOSC 5.13.0 (v4.7): Updated UOSC to the latest 5.13.0 release while retaining the MPV Anime Build's custom controls, menus, and integrations.

    • 🌈 Color-Coded Chapter Timeline (v4.7): UOSC highlights detected chapter ranges using the same colors as Skip Intro. The current displayed palette is OP #00FF00, ED #0080FF, PV #FF9900, and Intro #FF00FF, with transparent timeline colors. (PV and Intro used the opposite colors in the original v4.7 palette and were swapped in v5.3 for stronger contrast between neighboring chapter ranges.)

    • 💾 Track Selector Resume Manual Override (v4.7): Manual audio/subtitle overrides are persisted per video. When resumed in a later MPV session, the matching override is restored and then remains active for the rest of that session/playlist, including next/previous files.

    • 📜 Native Watch History & Progress Bars (v4.5): Tracks up to 50 recent files with visual progress blocks, 95% watched thresholds, greyed-out completed entries, and a dedicated control bar button.

    • 🗡️ Anime Line-Thinner Suite & Context Locks (v4.5): Resolution-aware line-thinning shaders mapped into FSRCNNX with a persistent menu toggle (Ctrl+j) and safety lockdown checks.

    • ✨ Refined Adaptive Sharpening (v4.5): Balanced strength curves across SD, HD, FHD, and 4K tiers for pristine edge fidelity.

    • ⚡ ArtCNN Performance Optimizations (v4.4): Upgraded the Ani4Kv2 and AniSD shader chains to use highly optimized fragment iterations (_i2 / _i4) instead of heavy compute models, entirely eliminating frame drops during real-time playback.

    • 🔒 Strict Fidelity Locks & UI Sync (v4.4): Anime4K profiles are now strictly locked out while Fidelity Mode is active, complete with custom OSD warnings. UOSC menus have also been reorganized and dual-synced for a cleaner right-click experience.

    • 🎵 Audio-Only Smart Toggle & Fix (v4.3): Added a new UOSC menu toggle to enable (Auto) or completely bypass (Disable) the audio-only battery-saving profile. Fixed a major race condition that incorrectly applied audio-profiles to video files on systems without discrete GPUs.

    • Status Overlay Overhaul (v4.3): The status view now features structured, color-coded layouts for audio/video filters and shaders. Implemented smart text wrapping and native table parsing to eliminate string artifacts and ensure perfect readability on all screen resolutions. Press 'k' for A/V Filter and Shaders Info

    • ✨ Anime4K Ultra Tier (v4.2): Integrated the unified Anime4K-Ultra shaders by Th-Underscore. The quality setting is now a 3-tier system (Fast, HQ, Ultra), bringing superior line thinning, pre-sharpen blur-pulls, and de-aliasing to the pipeline.

    • 🔤 Dynamic UI Labels (v4.2): The UOSC Anime4K Profiles menu now dynamically updates its descriptions based on the active quality tier, mapping specific Th-Underscore files to the correct modes.

    • 🧠 Resolution-Aware Engine Persistence (v4.1): The toggle choice between Anime Fidelity (FSRCNNX) and Performance (Anime4K) is now tracked and remembered independently per resolution tier. Mix and match purist edge refinement for 1080p content while running aggressive upscaling on 720p content completely automatically.

    • 💻 ArtCNN Compute Engine Optimizations (v4.1): Next-gen Ani4Kv2 and AniSD rendering engines now leverage dynamic compute profiles. Fast Quality utilizes general loops, while HQ Quality triggers parallel hardware Compute pipelines (*_CMP.glsl) to maximize your graphics card's hardware capabilities.

    • 📺 Advanced 3-Way HDR Matrix Switch (v4.0): Overhauled the display engine output to route through an explicit 3-way layout loop: Auto, HDR Display (Passthrough), and SDR Display (Tone-Mapping).

    • 🔤 Interactive Subtitle Styling (v4.0): Fine-tune your subtitle fonts, colors, and borders directly from the new Subtitles section in the UOSC Controls Menu.

    • 🔊 Screen-Wide Scroll Volume Engine (v4.0): Adjust sound balances comfortably by using your mouse scroll wheel anywhere across the video output field, syncing natively with the custom smoked glass volume popups.

    • ⌨️ New ArtCNN Control Interfacing (v4.0): Quick-swap layout styles on the fly using standard keyboard overrides (CTRL+7 for Ani4Kv2 and CTRL+8 for AniSD).

    • ⚡ NVIDIA Decoding Priority (v4.0): The Windows core engine now prioritizes nvdec hardware decoding, ensuring maximum performance and lower power draw for RTX/GTX users.


    🚀 What's New (v3.0 - v3.2)

    • 🧠 Resolution-Aware Anime4K (v3.2): Anime4K is no longer a single global toggle. The build now remembers your precise Quality ("fast" vs "hq") and Mode (A, B, C, AA, BB, CA) preferences independently for each resolution tier (SD, HD, FHD, 2K, 4K, 8K), seamlessly swapping settings on the fly to match your content.
    • 🎛️ Interactive Denoise Filter (v3.1): A dedicated Denoise (hqdn3d) control suite in the UOSC menu with independent Luma and Chroma adjustments. It features a Smart Hardware Fallback that safely manages your hwdec settings to prevent crashes when engaging CPU-based filters.
    • 🌐 Smart Track Selector (v3.1): Intelligently handles missing metadata, prioritizing "Dialogue" or "Full" subtitle tracks over "Signs/Songs", and cleanly falls back to muxer defaults if your preferred language isn't found.
    • 🎵 Audio-Only Profile (v3.0): Instantly drops GPU load to 0% for music playback. Automatically disables heavy video shaders/scalers while displaying embedded album art and dynamic visualizers.
    • 🎚️ On-the-Fly Equalizer & PIP (v3.0): Fine-tune your audio frequencies directly from the UI, and seamlessly pop the video out into a floating Picture-in-Picture (PIP) window for multitasking.
    • ⚡ 8K Optimized Mode (v3.0): Automatically detects massive 8K resolution files and bypasses heavy upscaling shaders to prevent GPU crashes and ensure buttery-smooth playback.
    • 🌈 Ambient Crop Shader (v3.0): A highly immersive viewing mode that fills black bars with ambient glowing colors. (⚠️ Note for SVP Users: Use SVP's dedicated "Fill black bars" instead).
    • ⚡ Core Performance Optimizations (v3.0): Refined underlying scripts for significantly faster state transitions and lower startup overhead.
    • 🎨 Menu Overhaul (v3.0): The UOSC Glass UI has been completely reorganized with new intuitive submenus for PIP, Ambient, and Equalizer controls.

    🧠 Smart Intelligence & Automation

    1. Universal Auto-Detection

    The build automatically switches profiles (Anime vs Live Action) based on what you are watching.

    • File/Folder Rules: If the path contains anime, it applies Anime shaders. If it contains live action, drama, real person, or lacks anime tags, it applies Live Action shaders.
    • 3D/Donghua: Automatically recognizes keywords like donghua, 3d_anime, and cartoon.
    • Streaming Detection: Works flawlessly on Web Streams (Stremio, Debrid, URLs) by automatically scanning audio tracks for Japanese language tags to trigger Anime Mode.

    2. Power Guard (Battery Safety)

    A cross-platform power manager designed for Windows and Linux laptops, portable systems, and desktops.

    • Automatic Platform Detection: Uses modern PowerShell/CIM battery monitoring on Windows and the native system power-supply interface on Linux. No platform-specific script editing is required.
    • Auto-Eco: Unplugging a laptop automatically disables high-end shaders (Anime4K/FSRCNNX), locks them out, and switches to the lightweight [Low-End] bilinear profile.
    • Auto-Restore: Reconnecting AC power restores the smart video profile and the exact hardware decoder that was active before Eco mode.
    • Desktop Mode: Systems without a battery automatically use Manual Toggle Only mode through Ctrl+P or the UOSC power menu.
    • Decoder Safety: Preserves D3D11VA, NVDEC, VA-API, Vulkan, and SVP copy-back configurations instead of forcing an incompatible decoder.
    • Note for SVP Users: Create a "Battery Profile" in SVP 4 Pro to disable frame interpolation when on battery to ensure total efficiency.

    3. Adaptive Nvidia VSR (RTX AI Upscaling)

    • Smart Ratio: Calculates the exact pixel ratio between your video and monitor to maximize quality without wasting GPU power (e.g., scales 720p to 4K at 3.0x, but leaves 1080p on a 1080p screen at 1.0x).
    • Safety & Bit-Depth: Automatically selects p010 (10-bit) for HDR/Anime to prevent banding.

    🎨 The Video Pipeline (Visuals & Shaders)

    Anime Mode: Stylized vs. Faithful

    You have two distinct engines for watching Anime.

    ModeEngineBest ForPhilosophy
    Performance (Default)Anime4K720p / Old Anime"Make it look like 4K." Aggressive upscaling, artifact removal, and "painting" effect. Razor-sharp.
    Fidelity (Purist)FSRCNNX1080p / Modern Anime"Show exactly what the artist drew." Preserves original texture, line art, and film grain.
    • SD Content: Applies FSRCNNX-16 (Anime Enhance) for deep reconstruction.
    • HD/FHD Content: Applies FSRCNNX-8 (Line Art) for subtle edge refinement.

    Live-Action Pipeline

    Non-anime content uses a completely separate "Modern TV" adaptive processing path.

    • SD (< 576p): Choose between NNEDI3 (Clean/Texture) or FSRCNNX (Sharp Mode).
    • HD (720p-1080p): Choose between NNEDI3 (Geometry) or FSRCNNX (Detail/Sharp).
    • 4K (2160p): Native 1:1 Pixel Mapping with subtle Adaptive Sharpening + Glaze. Bypasses all heavy upscalers.
    • 8K (4320p) [v3.0]: Engages Hardware-Decoded optimized mode. Bypasses all post-processing.

    Native Scalers Guide (Manual Overrides)

    If you disable shaders (CTRL+g), MPV falls back to its high-quality native scaling configuration:

    • spline64: The v4.9 default for Anime and native FHD processing. Produces smooth, stable edges with less aggressive ringing.
    • ewa_lanczossharp: A sharper manual alternative when stronger edge definition is preferred.
    • mitchell: A softer option that can help conceal compression artifacts and low-quality source detail.

    🎵 The Audio & HDR Engine

    Professional Audio

    • Audio-Only Mode [v3.0]: Instantly drops GPU load to 0% for music playback, showing embedded album art and dynamic visualizers.
    • Spatial Audio: Uses HRTF-based virtual surround to simulate a 7.1 cinema experience on standard stereo headphones.
    • Display-Aware Audio Devices: Configure Linux, Windows, or macOS display-to-device mappings in script-opts/auto_audio_device.conf. Linux and Windows console output includes the monitor product name alongside its connector/GDI identifier, unmapped displays preserve the current device by default, and CTRL+a toggles automatic switching.
    • Night Mode: Applies Dynamic Range Compression (DRC) to lower explosions and boost whispers for late-night viewing.
    • Passthrough/Bitstream: Send raw TrueHD/DTS-X to your AVR with a single click (A).

    True HDR & Dolby Vision

    Automatically detects your monitor's capabilities via Windows.

    • Windows HDR ON: Activates the HDR Display output path. The selected metadata-aware tone-mapping curve remains active for HDR10+/Dolby Vision highlight handling.
    • Windows HDR OFF: Switches to High-Quality Tone Mapping (Spline/BT.2390) for SDR monitors.
    • Dolby Vision: Plays correctly on all devices, automatically falling back to the HDR10 Base Layer if your display lacks DV support (fixes purple/green screen errors).
    • Calibration: Manually set Target Peak Brightness (e.g., 400 nits, 1000 nits) and Tone-Mapping algorithms via the menu.

    📺 UI & Smart Features

    • Glass UI (UOSC): A modern, transparent "Smoked Glass" interface that doesn't block the video.
    • Smart Skip Intro / Up Next: Interactive, context-aware cards.
      • 🟢 Green: Skip OP | 🔵 Blue: Skip ED | 🟣 Magenta: Skip Preview
      • Click to skip instantly. Pauses the timer if you pause the video.
    • Neon Glass Stats Overlay (I): Real-time monitoring of active shaders, Input vs Output resolution, HDR status, and Audio logic.
    • Master Persistence: The build remembers everything across restarts (Fidelity vs Performance preference, HD upscaler choice, Tone-mapping algorithm, etc.).

    🌊 Recommended Streaming Ecosystem

    This build is designed to be the "Engine" for high-quality streaming apps.

    AppBest ForWhy?
    StremioMovies, TV & AnimeThe ultimate hub. Supports 4K HDR, Dolby Vision, and real-time torrent streaming.
    Hayase / ShiruAnime OnlyDedicated Anime clients with Anilist/MAL sync. Tracks progress automatically.

    How to Set MPV as External Player:

    • Stremio: Settings → Player → Enable "Play in external player".
    • Hayase / Shiru: Settings → Player Settings → Select your mpv.exe.

    ⌨️ Master Controls & Shortcuts

    ShortcutFunction
    KShow Profile Info (Displays current Mode, Profile, and Active Shaders)
    IShow Tech Stats (Bitrate, Dropped Frames, Logic Status)
    AAudio Mode (Toggle between 7.1 Upmix and Passthrough/Bitstream)
    HHDR Mode (Manual Override: Force Passthrough vs Tone Mapping)
    VNvidia VSR (Toggle RTX Video Super Resolution - Windows Only)
    QMaster Upscaler Toggle (SD/HD Logic Switch: NNEDI3 ↔ FSRCNNX)
    CTRL + qSD Only: Toggle Clean ↔ Texture mode (Requires NNEDI3).
    CTRL + kToggle Adaptive Sharpen (ON/OFF).
    CTRL + gMaster Shader Killswitch. Disables all AI processing for raw playback.
    CTRL + pToggle Power Saving Mode manually.
    F5 / F6Window Screenshot / Clean Video-Frame Screenshot
    yCycle Sub Video Data (None / Aspect / All) - Fixes subtitle scaling issues.
    CTRL + f / CTRL + FBrowse Primary / Secondary Subtitle Lines and seek to a selected line.

    Anime Pipeline Overrides

    ShortcutModeDescription
    CTRL + lAUTODetects based on folder path & keywords (Default)
    CTRL + ;ONForce anime shaders for all content
    CTRL + 'OFFDisable anime shaders completely
    LAnime4K QualityToggle Anime4K FAST ↔ HQ
    CTRL + 1-6Anime4K ModesCycle between Modes A, B, C, AA, BB, CA

    💻 System Requirements & Installation

    Minimum (1080p Playback)

    • GPU: NVIDIA GTX 960 / AMD RX 560 or better (2GB+ VRAM)
    • CPU: Quad-core Intel/AMD CPU
    • RAM: 8GB

    Recommended (4K Upscaling + SVP)

    • GPU: NVIDIA RTX 3060 / AMD RX 6600 or better (6GB+ VRAM)
    • CPU: Modern 6-core CPU (Ryzen 5 3600 / Intel i5-10400 or newer)
    • RAM: 16GB

    Installation

    1. Install MPV: Download the latest 64-bit version of MPV (shinchiro builds recommended).
    2. Install SVP 4 Pro (Optional): Ensure SVP is installed if you want motion interpolation.
    3. Copy Files: Extract the contents of this build into your %APPDATA%/mpv/ folder (Windows) or ~/.config/mpv (Linux).
    4. Fonts: Install Source Sans Pro (included) to ensure the Stats overlay renders correctly.

    User overrides and remembered menu settings

    Settings changed in UOSC → Controls are saved outside the tracked defaults, so updating the build does not reset them. The HDR display mode, target peak, and tone-mapping choice use the same override layer.

    • User files must be named user-<custom-name>.conf; <custom-name> can be any non-empty name.
    • If no user file exists, the first remembered change creates user-settings.conf.
    • Multiple user files are loaded alphabetically. Later files override earlier files, and the last file is updated when a menu choice is saved.
    • Built-in script defaults and mpv.conf remain the fallback when a setting has no user override.

    Personal MPV configuration overrides

    To override any normal MPV option without editing the build's tracked mpv.conf, create exactly one file named mpv-<custom-name>.conf beside mpv.conf. For example, mpv-personal.conf containing fullscreen=no overrides the build's fullscreen=yes default.

    • The custom file is loaded after the shipped mpv.conf, so duplicate options in it take precedence.
    • Only the settings you want to change need to be added; do not copy the complete shipped configuration.
    • The filename works the same on Windows and Linux, and the file remains separate during build updates.
    • If multiple mpv-*.conf files are present, none are loaded and MPV displays a warning. Keep exactly one active custom file.
    • mpv-*.conf controls normal MPV options. The separate user-*.conf files above store remembered Anime Build menu settings.

    📸 Gallery, Visual Comparisons & Tech Verification

    🔹 UI & Smart Features

    Main MenuAdvanced Controls
    MenuControls
    OP DetectedED DetectedSkipped
    OPEDSkipped

    🔹 Anime Pipeline

    Live Action Mode (Anime OFF)Anime Mode (Anime4K ON)
    Anime OffAnime On
    Anime4K (Art Style)Fidelity (Purist)
    Anime4KFidelity

    🔹 Live Action Pipeline

    HD: NNEDI3 (Auto Default)HD: FSRCNNX (Manual HQ)
    HD NNEDI3HD FSRCNNX
    SD: Clean ModeSD: Texture Mode
    SD CleanSD Texture

    🔹 Nvidia VSR (RTX AI Upscaling)

    RTX VSR Active (Green OSD)
    RTX VSR

    🔹 Shader Verification (Proof of Logic)

    Anime Mode

    Auto (Default)Manual Off
    Info AutoInfo Off

    Live Action (HD)

    NNEDI3 ChainFSRCNNX Chain
    Info NNEDIInfo FSRCNNX

    Live Action (SD)

    Clean ChainTexture Chain
    Info CleanInfo Texture

    4K Content (Native)

    4K Native Pipeline
    Info 4K

    Nvidia VSR (Manual)

    VSR ActiveDetail View
    VSR Stats 1VSR Stats 2

    📝 Credits

    • Anime4K: bloc97
    • Anime4K-Ultra: Th-Underscore
    • UOSC Skin: tomasklaen
    • Thumbfast: po5
    • Up Next Script: @WaruiDevil (Telegram User)
    • Shaders: bloc97 (Anime4K), igv (FSRCNNX), bjin (KrigBilateral)
    • Equalizer: DonCanjas
    • mpv-youtube-download: cvzi
    • mpv-subtitle-lines: christoph-heinrich
    • Config & Logic: Customized and built by Chinna95P