MPV Anime Build v5.4

Performance. Audio Profiling. Pure Immersive Media.

Visual Comparisons

Anime: Art vs. Fidelity

Anime4K Mode Anime4K (Art)
Fidelity Mode Fidelity (Purist)

Anime Detection Logic

Anime On Anime Mode (Green)
Anime Off Live Action (Red)

Live Action HD (Upscalers)

FSRCNNX FSRCNNX (Manual)
NNEDI3 NNEDI3 (Auto)

Live Action SD (Restoration)

Texture Texture Mode
Clean Clean Mode

Anime Mode: Stylized vs. Faithful

This build offers two distinct ways to watch anime. Switch instantly using CTRL + ' (OFF) , CTRL + l (AUTO) and CTRL + ; (ON).

1. Anime4K Mode (ON)

The "Modern" Look

  • Philosophy: "Make it look like 4K."
  • Effect: Aggressively sharpens lines, thins heavy borders, and removes noise.
  • Result: Razor-sharp, highly stylized image. Great for older anime or making 720p look like modern 4K.

2. Reference Mode (OFF)

The "Faithful" Look

  • Philosophy: "Show exactly what the artist drew."
  • Effect: Uses professional scalers (NNEDI3 & FSRCNNX) to smooth lines naturally without altering the art style.
  • Result: Smooth, cinema-quality image preserving line weight, film grain, and background textures.

Resolution Handling Comparison

Resolution Anime4K Mode (ON) Reference Mode (OFF) Best Choice
SD (<576p)
(DVDs, Old Rips)
Restoration Focused
Aggressively removes compression artifacts. Attempts to "re-draw" jagged lines.
Detail Focused (NNEDI3-256)
Uses deep neural networks to reconstruct details while preserving retro texture.
ON for Blocky
OFF for Quality
HD (720p)
(TV Rips, Web)
Upscale Focused
Sharpening maximized to simulate 4K. Lines become thin and crisp.
Smoothness Focused (NNEDI3-64)
Prioritizes smooth, connected lines (anti-aliasing) over raw sharpness. No ringing.
ON for Crisp
OFF for Accurate
FHD (1080p)
(Blu-Ray)
Enhancement Focused
Adds "digital sheen" and enhances edge contrast.
Fidelity Focused (FSRCNNX)
Fixes color bleeding (KrigBilateral) and adds cinematic grain.
ON for Razor
OFF for Purist
4K (2160p)
(Modern Movies)
Pass-through
Light processing to avoid over-sharpening.
Native 1:1
Bit-perfect pixel mapping. No upscaling needed.
OFF Always

πŸ’‘ The "Purist" Workflow

Want Studio-Mastered Quality with Professional Scaling?

1. Press CTRL + ' to disable enhancements (Mode OFF).
2. Press Q to toggle scaling: NNEDI3 (Soft/Natural) or FSRCNNX (Sharp/Clean).

Want Absolute Raw Output?

Press CTRL + g to engage the Master Kill Switch.
This instantly disables ALL shaders (Upscalers, Deband, Sharpening) for a 1:1 bit-perfect render.
(Perfect for A/B testing. Your choice is saved automatically.)

Native Scalers Guide (Manual Controls for when Shaders Master Switch is OFF)

Scaler Sharpness Ringing Best Use Case
ewa_lanczossharp ⭐⭐⭐⭐ Low Best General Upscaler. The "Gold Standard". Sharp but clean.
spline64 ⭐⭐⭐⭐⭐ Medium Best Downscaler. (SVP Choice). Retains maximum 4K texture on 1080p.
lanczos ⭐⭐⭐⭐⭐ High Classic Sharp. Very crisp, but creates halos. For "crunchy" image lovers.
spline36 ⭐⭐⭐ Low Best Chroma Scaler. Perfect balance for color. High quality, zero artifacts.
mitchell ⭐ None Smooth. Soft scaler that hides compression. Good for downscaling.
bilinear πŸŒ‘ None Emergency Only. Blurry but fast. Use only if GPU overheats.

HDR Tone Mapping & Passthrough Tests

Test Format Source Type MPV Behavior Status
HDR10 HEVC 10-bit / PQ / BT.2020 Passthrough to Display (Auto-trigger) Pass
Dolby Vision P5 HEVC 10-bit / DoVi / Streaming Correct Tone Mapping (Fixes Purple Tint) Optimized
Dolby Vision P8 HEVC 10-bit / DoVi / Hybrid Dynamic Tone Mapping to HDR10 Pass
HLG VP9 / HLG / Broadcast Correct Gamma / Brightness Map Pass
MaxCLL/FALL Static Metadata Metadata Passed to GPU Driver Pass

πŸ“‚ UOSC Open File Browser

v4.9 adds a dedicated Open File button to the UOSC controls bar. It opens UOSC's file-selection menu directly inside MPV for quick video and audio selection.

If your video folders contain poster, backdrop, thumbnail, or other image files, keep the browser focused on playable media with:

load_types=video,audio
show_hidden_files=no
image_types=

This prevents image assets from appearing in the Open File menu while keeping video/audio selection available.

🌊 Recommended Streaming Ecosystem

This build is the perfect "Engine" for high-quality streaming. We recommend these apps for the best 4K HDR and Anime Tracking experience.

🎬

Stremio

Best For: Movies, TV & 4K HDR

The ultimate hub. Supports real-time torrent streaming, Dolby Vision, and 4K HDR.
*Enable "Play in External Player" in settings.

🎌

Hayase / Shiru

Best For: Anime Only (Tracking)

Dedicated Anime clients that sync with Anilist/MAL automatically while you watch.
*Set Custom Player Path to your mpv.exe.

Interface Tour

Smart Skip Logic

Green OP Skip

Opening (OP) β€’ Green Indicator

Blue ED Skip

Ending (ED) β€’ Blue Indicator

Generic Intro Skip shown with the previous orange palette

Generic Intro β€’ Magenta Indicator (image shows the previous palette)

Skipped Feedback

Visual Feedback β€’ Instant Confirmation

Centralized Menus

Anime Build Options

Anime Build Options β€’ Quick Access Hub

Advanced Controls

Advanced Controls β€’ Deep Customization

Scaling Control Menu

Scaling Menu

Expanded Scalers β€’ Select Spline64, Lanczos, or EWA Lanczos instantly.

Logic & Statistics

Press CTRL+i or Press New 'Statistics' Button to view the new Statistics overlay. It now shows exactly which Fidelity mode is active, your Audio Upmix status, and Drop frames.

Stats Overlay

What's New (v3.0 - v5.4)

πŸ”Š

Cross-Platform Audio Switching

Configurable display-to-device audio mappings in auto_audio_device.conf for Linux, Windows, and macOS, featuring human-readable EDID and monitor-name identification.

πŸ”Ž

Searchable Subtitle Dialogue

Browse, filter, and jump to lines of dialogue across subtitle tracks with mpv-subtitle-lines, a contextual UOSC button, and CTRL+f shortcuts.

πŸ“Š

Refined Overlays & Unified Fonts

Accurate context-aware shader reporting in CTRL+i, expanded glass panel layout, unified Microsoft Sans Serif OSD fonts, and balanced interface font scaling.

πŸ”Œ

External Player, IPC & SVP Coexistence

External controllers keep their IPC endpoint while SVP and discovery-based integrations can attach through a shared per-process alias on Unix systems.

πŸ›‘οΈ

Protected Customized UOSC

The upstream UOSC self-updater is removed so it cannot overwrite Anime Build menus and integrations. Manual build checks now open the exact GitHub release page.

πŸ”

Automated Release Verification

Release ZIPs receive SHA-256-specific VirusTotal reports without replacing the handwritten release description.

🎬

Reliable Live-Action Overrides

Explicit Live-Action path and title markers once again override Anime folder and Japanese-audio signals in Auto mode, selecting the correct resolution-aware profile.

πŸ–ΌοΈ

Safer Thumbnail Decoding

Thumbfast now ships with software decoding enabled for its helper process, avoiding hardware-decoder compatibility problems during thumbnail generation.

🌐

Focused Stream Subtitles

yt-dlp subtitle requests now stay limited to English and original-English tracks, removing unintended Telugu language requests.

πŸ”‹

Reliable Eco Persistence

The complete Low-End profile stays active across file and metadata changes, while remembered preferences return safely when Power Saving ends.

πŸ’¬

Smarter Preferred Subtitles

Automatic selection skips commentary, preserves clean-track priority, and falls back to a complete SDH track when no usable clean subtitle existsβ€”even without preferred-language metadata.

🌈

Cross-Platform HDR Detection

Windows DisplayConfig and KDE Plasma KScreen detection are isolated by platform, while other Linux compositors use mpv's native colorspace negotiation.

πŸ’Ύ

Remembered User Overrides

UOSC Controls and HDR selections persist in update-safe user-<custom-name>.conf files and are reapplied after automatic profiles.

βš™οΈ

Personal MPV Configuration

One update-safe mpv-<custom-name>.conf file can override normal options from the shipped mpv.conf on Windows and Linux.

🧩

Community Reliability Fixes

Resolved disabled track overrides, Linux peripheral batteries triggering Eco mode, and startup profile conditions receiving incomplete metadata.

🎨

Clear Anime FSRCNNX Names

The two adjacent Anime shaders now use explicit anime_mild and anime_aggressive filenames, with saved legacy paths migrated automatically.

🧩

Controller & Main Logic Optimization

Optimized anime_profile_controller.lua and main.lua to fix minor bugs, reduce unnecessary processing, and improve state handling.

πŸ“‚

Dedicated UOSC Open File Button

A new Open File control opens UOSC's native file-selection menu directly from the player for quick video and audio selection.

πŸ–ΌοΈ

Cleaner Media File Browser

Configure UOSC with load_types=video,audio, show_hidden_files=no, and image_types= to keep poster and artwork files out of the Open File menu.

πŸŽ›οΈ

UOSC Behavior Refinements

Several UOSC controls, menus, and interaction behaviors were refined for a more consistent MPV Anime Build workflow.

🎡

Track Selector Refinement

Updated track-selector.lua with v4.9 fixes and behavior refinements to improve track-selection reliability while preserving manual selection and override behavior.

🌈

Color-Coded Chapter Timeline

UOSC 5.13.0 highlights detected OP, ED, PV, and Intro chapters with the same transparent colors used by Skip Intro: OP green, ED blue, PV orange, and Intro magenta. The Intro/PV swap improves contrast between neighboring chapter ranges.

πŸ“₯

Working Stream Downloads

Added mpv-youtube-download and bound it to the UOSC Download button. Downloads go to ~/ytdl by default and can be changed in youtube-download.conf.

🎨

Soothing Resolution-Aware Sharpening

Adjusted Adaptive Sharpen and Anime Line-Thinner values across resolution tiers for smoother edges while preserving background texture and subject detail in Anime and Live-Action content.

🌊

New Audio-Only Visualizers

Expanded the Audio-Only profile with additional visualizer styles for a more varied music playback experience.

πŸͺŸ

Windows CMD Flash Fix

Updated mpvSockets.lua to prevent command-window flashes on Windows when socket commands are executed.

πŸŽ›οΈ

UOSC 5.13.0

Updated the integrated UOSC interface to version 5.13.0 while preserving the custom MPV Anime Build menus and controls.

πŸ’Ύ

Persistent Track Manual Override

Manual audio/subtitle changes are remembered per video for resume. Once restored, the override remains active across next/previous files for the current MPV session or playlist.

πŸ“œ

Watch History & Line-Thinner Suite

Added persistent playback history tracking up to 50 files with visual progress bars and 95% completion indicators, paired with resolution-aware line-thinning shaders and context-aware shortcut toggles (Ctrl+j).

πŸ“Š

Status Overlay Overhaul

Color-coded, neatly wrapped status display for active filters and shaders. Now uses native data parsing for zero-artifact output. Press 'k' for A/V Filter and Shaders Info

🎡

Audio-Only Control

New UOSC toggle for Audio-Only mode (Auto/Disable), alongside deep race-condition fixes for iGPU systems to ensure perfect media type detection.

✨

Anime4K Ultra Tier

Integrated the highly optimized Anime4K-Ultra shaders by Th-Underscore. Experience superior line thinning and pre-sharpen blur-pulls via a new 3-tier dynamic quality menu.

🧠

Next-Gen ArtCNN Shaders

Integrated Ani4Kv2 and AniSD neural network models into the Anime4K profiles for cutting-edge line-art reconstruction and artifact removal.

πŸ“Ί

3-Way HDR Switch

A robust new HDR controller: Choose between Auto, HDR Display (Passthrough), or SDR Display (Tone-Map) to bypass OS detection errors.

πŸ”€

Subtitle Styling UI

A dedicated Subtitle Styling menu within the UOSC Controls allows you to customize fonts, colors, and borders instantly without touching config files.

⚑

NVIDIA nvdec Optimization

The core Windows engine now explicitly prioritizes NVIDIA's highly efficient nvdec decoder for ultra-smooth rendering on RTX/GTX hardware.

πŸ”Š

Global Volume Control

Seamlessly adjust audio levels and trigger the modern glass UOSC volume UI by simply scrolling your mouse wheel anywhere on the video.

🧠

Resolution-Aware Anime4K

Anime4K is no longer a single global toggle. Your Quality and Mode preferences are now remembered independently for each resolution tier (SD up to 8K).

πŸŽ›οΈ

Interactive Denoise

A dedicated, hardware-safe hqdn3d control suite in the menu to instantly clean up heavy film grain or low-bitrate compression artifacts.

🌐

Smart Track Selector

Intelligently handles missing metadata by prioritizing "Dialogue" subtitle tracks and gracefully falling back to muxer defaults if needed.

🎡

Audio-Only Profile

Zero-overhead profile for music. Automatically disables heavy video shaders and features built-in support for visualizers and album art.

🌈

Ambient Crop Mode

A new immersive viewing mode that fills black bars with glowing ambient colors.

πŸ“Ί

PIP Mode

Seamlessly pop the video out into a Picture-in-Picture floating window for multitasking.

🎚️

Equalizer Controls

Instantly fine-tune your audio frequencies directly from the newly overhauled UI without leaving the player.

⚑

8K Optimized

Hardware-decoded 8K detection that automatically bypasses heavy upscalers to prevent GPU crashes and ensure smooth playback.

🎨

Menu & Logic Overhaul

Faster state transitions, lower startup overhead, and a completely reorganized UOSC Glass UI with new intuitive submenus.

Key Features

🎨

Neon Glass UI

A completely reworked UOSC theme with translucent menus, neon accents, and a centralized control hub.

🌈

True HDR Passthrough

Reworked detection logic sends raw metadata to your display when Windows HDR is active.

✨

Anime4K Pipeline

Upscale 1080p anime to 4K with restoration, or clean up old 480p DVDs.

πŸ”

Fidelity Mode

Don't like the "oil painting" look? Use FSRCNNX for anime. Pure scaling, no art alteration.

πŸ“Ί

Modern TV Mode

Live Action uses NNEDI3 and Adaptive Sharpen to mimic Sony/Samsung TV processing.

πŸ–±οΈ

Interactive Smart Cards

"Up Next" and "Skip Intro" overlays are clickable. Hover to activate, click to skip instantly.

🌍

Universal Stream Detection

Detects Anime Mode on Stremio & Web Links by scanning internal audio tracks for Japanese language.

πŸš€

Adaptive Nvidia VSR

Scaling is no longer fixed. The build detects your monitor and applies Adaptive Scaling (1.0x - 4.0x).

⚑

Power Guard

Detects Laptop Battery. Actively LOCKS heavy shaders to prevent drain and auto-switches to ECO Mode.

πŸ”€

Shader Swapper & Split Logic

Swap variants instantly. Separate memories for SD (Clean) & HD (Sharp) Live-Action content.

πŸŽ›οΈ

Pro Scaling Suite

Includes Spline64 and Lanczos to match SVP 4 Pro quality when downscaling 4K movies.

πŸ’Ύ

Universal Memory

The build remembers everything: Upscaler choice, Shader state, and HDR settings across restarts.

πŸŒ™

Night Mode

Dynamic Range Compression for audio. Lowers explosions, boosts dialogue. Perfect for night watching.

πŸ“Š

Motion & Stats Tech

Controls for Video Sync/Temporal Scalers, plus a smart Stats overlay that calculates true target resolution.

Included Shaders & Config Details

This MPV Custom Build is a pre-packaged solution that replaces manual configuration. It combines a highly tuned mpv.conf with the best open-source shaders available.

🎨 Active Shaders

  • β€’ Anime4K v4.7 (Upscale + Restore)
  • β€’ NNEDI3 (Neural Network Upscaling)
  • β€’ FSRCNNX (High-Fidelity Resizing)
  • β€’ SSimSuperRes (Correction)
  • β€’ KrigBilateral (Chroma Scaling)
  • β€’ Adaptive Sharpen (Modern TV Style)

βš™οΈ Config Features

  • β€’ UOSC Glass Interface
  • β€’ True HDR Metadata Passthrough
  • β€’ Zero-Copy Hardware Decoding
  • β€’ SVP 4 Pro Compatible
  • β€’ Laptop Battery Saver