需安装附带的 Source Sans Pro 字体,否则 Stats 叠加层显示异常;自定义覆盖文件必须只保留一个 mpv-*.conf,多个同时存在会导致全部不加载;UOSC 上游自更新已被移除,需手动检查更新。
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
1. 安装 64 位 MPV(推荐 shinchiro 构建)
2. 将构建内容解压到 %APPDATA%/mpv/(Windows)或 ~/.config/mpv(Linux)README 未说明具体显存或 GPU 型号要求;RTX VSR 需 Nvidia RTX 显卡,SVP 为可选组件。
面向动画与真人视频的 MPV 播放配置,自动识别内容并切换 AI 放大与着色器管线
一套能自动识别动漫画面的 MPV 播放器配置,集成 Anime4K、ArtCNN 等超分着色器,按 SD/HD 和动漫/真人自动切换画质管线。
核心能力
- 按动画/真人内容自动切换 Anime4K、ArtCNN、FSRCNNX、NNEDI 着色器管线
- 内置 UOSC 定制界面,支持菜单调参、字幕搜索与状态叠加显示
- 跨平台按显示器映射音频设备,并显示可读的显示器型号
- 提供 HDR 直通与色调映射选项,支持 Windows 与 KDE 的 HDR 状态
- 支持 RTX VSR、SVP 共存与 Smart Skip 片头片尾跳过
容易踩的坑
- 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+queryrequests.
📚 Agent Documentation
- Customized UOSC Scope: Documented
scripts/uosc/lib/menus.luaas a high-risk customized UOSC file alongsidescripts/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
- 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_overshootandD_overshootstructures. - Calibrated Strength Curves: Responsibly lowered all
curve_heightsharpening 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
- 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-linesfor 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+ffor primary subtitle lines andCTRL+Ffor secondary subtitle lines.
🔊 Audio Devices
- Quiet Startup Detection:
auto-audio-device.luanow treats an emptydisplay-nameslist as MPV's normal pre-window startup state instead of printing a misleadingUnknown display return valuewarning. - 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
EnumDisplayDevicesWandWmiMonitorID. Console output can therefore identify displays asDP-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=autobehavior. - 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+aautomatic-switching toggle and publicset-audio-device/toggle-switchingscript bindings remain available.
📊 Status Overlay & OSD Fonts
- Accurate Context-Aware Shader Reporting: The
CTRL+istatistics 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
KA/V filter display, UOSC text, Smart Skip and Up Next cards, audio metadata, and the Anime Profile, HDR, Power, and VSR overla
- Searchable Subtitle Lines: Added
- 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>.conffile placed besidempv.conf. The file loads after the shipped configuration, allowing personal values such asfullscreen=noto 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-*.conffiles control normal MPV options, while the existinguser-*.conflayer continues to store remembered Anime Build menu settings.
🔌 External Players, IPC & SVP
- External IPC Preservation: Reworked
mpvSockets.luaso 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
mpvSocketsdirectory, 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.luaand 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 uoscmenu entry, script binding, and updater implementation. UOSC is customized for MPV Anime Build, so installing an upstream UOSC release in place could overwritemain.luaand 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
- Custom MPV Override File: Added automatic cross-platform loading for one
- 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.zipfrom 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>.conffiles and other runtime-generated user files. They are not included in the release archive and will continue to persist.The bundled
mpv.confandscript-opts/thumbfast.confcontain 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, andreal personmarkers 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=yestohwdec=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
teandtelrequests from yt-dlp arguments. - Authored and automatic stream subtitles now request
enanden-origonly.
🎨 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.mkvcase inside an Anime folder with Japanese audio selects the Live-Action context andFHD-Nativeprofile 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
- Reconnected
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
🎬 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.
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.luaas a customized/high-risk UOSC file alongsidescripts/uosc/main.luaso 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_overshootandD_overshootstructures. -
🔊 Cross-Platform Audio Device Switching (v5.4): Configurable display-to-device audio mappings in
script-opts/auto_audio_device.confsupporting 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-linesfor 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+fandCTRL+Fprovide 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/6for 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>.conffile can override normal options after the shippedmpv.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, andreal personpath/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>.conffiles, 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_mildandanime_aggressivefilenames, with automatic migration of saved legacy paths. -
🔋 Cross-Platform Power Guard (v4.9): Completely reworked
power_manager.luafor 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-qualityrendering foundation and changed Anime native scaling fromewa_lanczossharptospline64for 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-inhigh-qualityprofile. -
📸 Video-Only Screenshots (v4.9): Added
F6for clean video-frame screenshots alongside the existingF5window screenshot shortcut. -
🧩 Optimized Anime Profile Controller & Main UI Logic (v4.8): Optimized
anime_profile_controller.luaandmain.luato 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 emptyimage_typesvalue 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.luawith 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-downloadscript and connected it to the UOSC Download button. Stream downloads are saved to~/ytdlby default and can be redirected throughyoutube-download.conf. -
🪟 Windows CMD Flash Fix (v4.7): Updated
mpvSockets.luato 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
Ani4Kv2andAniSDrendering 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+7for Ani4Kv2 andCTRL+8for AniSD). -
⚡ NVIDIA Decoding Priority (v4.0): The Windows core engine now prioritizes
nvdechardware 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 yourhwdecsettings 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 containslive action,drama,real person, or lacks anime tags, it applies Live Action shaders. - 3D/Donghua: Automatically recognizes keywords like
donghua,3d_anime, andcartoon. - 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+Por 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.
| Mode | Engine | Best For | Philosophy |
|---|---|---|---|
| Performance (Default) | Anime4K | 720p / Old Anime | "Make it look like 4K." Aggressive upscaling, artifact removal, and "painting" effect. Razor-sharp. |
| Fidelity (Purist) | FSRCNNX | 1080p / 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, andCTRL+atoggles 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.
| App | Best For | Why? |
|---|---|---|
| Stremio | Movies, TV & Anime | The ultimate hub. Supports 4K HDR, Dolby Vision, and real-time torrent streaming. |
| Hayase / Shiru | Anime Only | Dedicated 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
| Shortcut | Function |
|---|---|
K | Show Profile Info (Displays current Mode, Profile, and Active Shaders) |
I | Show Tech Stats (Bitrate, Dropped Frames, Logic Status) |
A | Audio Mode (Toggle between 7.1 Upmix and Passthrough/Bitstream) |
H | HDR Mode (Manual Override: Force Passthrough vs Tone Mapping) |
V | Nvidia VSR (Toggle RTX Video Super Resolution - Windows Only) |
Q | Master Upscaler Toggle (SD/HD Logic Switch: NNEDI3 ↔ FSRCNNX) |
CTRL + q | SD Only: Toggle Clean ↔ Texture mode (Requires NNEDI3). |
CTRL + k | Toggle Adaptive Sharpen (ON/OFF). |
CTRL + g | Master Shader Killswitch. Disables all AI processing for raw playback. |
CTRL + p | Toggle Power Saving Mode manually. |
F5 / F6 | Window Screenshot / Clean Video-Frame Screenshot |
y | Cycle Sub Video Data (None / Aspect / All) - Fixes subtitle scaling issues. |
CTRL + f / CTRL + F | Browse Primary / Secondary Subtitle Lines and seek to a selected line. |
Anime Pipeline Overrides
| Shortcut | Mode | Description |
|---|---|---|
CTRL + l | AUTO | Detects based on folder path & keywords (Default) |
CTRL + ; | ON | Force anime shaders for all content |
CTRL + ' | OFF | Disable anime shaders completely |
L | Anime4K Quality | Toggle Anime4K FAST ↔ HQ |
CTRL + 1-6 | Anime4K Modes | Cycle 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
- Install MPV: Download the latest 64-bit version of MPV (shinchiro builds recommended).
- Install SVP 4 Pro (Optional): Ensure SVP is installed if you want motion interpolation.
- Copy Files: Extract the contents of this build into your
%APPDATA%/mpv/folder (Windows) or~/.config/mpv(Linux). - 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.confremain 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-*.conffiles are present, none are loaded and MPV displays a warning. Keep exactly one active custom file. mpv-*.confcontrols normal MPV options. The separateuser-*.conffiles above store remembered Anime Build menu settings.
📸 Gallery, Visual Comparisons & Tech Verification
🔹 UI & Smart Features
| Main Menu | Advanced Controls |
|---|---|
![]() | ![]() |
| OP Detected | ED Detected | Skipped |
|---|---|---|
![]() | ![]() | ![]() |
🔹 Anime Pipeline
| Live Action Mode (Anime OFF) | Anime Mode (Anime4K ON) |
|---|---|
![]() | ![]() |
| Anime4K (Art Style) | Fidelity (Purist) |
|---|---|
![]() | ![]() |
🔹 Live Action Pipeline
| HD: NNEDI3 (Auto Default) | HD: FSRCNNX (Manual HQ) |
|---|---|
![]() | ![]() |
| SD: Clean Mode | SD: Texture Mode |
|---|---|
![]() | ![]() |
🔹 Nvidia VSR (RTX AI Upscaling)
| RTX VSR Active (Green OSD) |
|---|
![]() |
🔹 Shader Verification (Proof of Logic)
Anime Mode
| Auto (Default) | Manual Off |
|---|---|
![]() | ![]() |
Live Action (HD)
| NNEDI3 Chain | FSRCNNX Chain |
|---|---|
![]() | ![]() |
Live Action (SD)
| Clean Chain | Texture Chain |
|---|---|
![]() | ![]() |
4K Content (Native)
| 4K Native Pipeline |
|---|
![]() |
Nvidia VSR (Manual)
| VSR Active | Detail View |
|---|---|
![]() | ![]() |
📝 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






















