π¬ mpv-anitheater v1.0 β Anime, K-Drama & Cinema Media Suite (Auto Translator, Dual-Subs, GLSL Shaders & 3D Spatial Audio)
mpv-anitheater is a high-performance, cross-platform media player suite engineered specifically for Anime, Asian dramas (K-Dramas), and Cinema lovers. It features built-in real-time subtitle translation into 16 languages, smart bilingual dual subtitles, 9 GPU-accelerated GLSL upscaling profiles (ArtCNN, FSRCNNX, SSimSuperRes, Anime4K, AMD CAS), studio-grade 3D spatial audio (Dolby Atmos, DTS:X, BS2B), an interactive 6-band graphic equalizer, Volume Boost, and a customized UOSC glass interface.
- β¨ Key Features (v1.0)
- π₯ How to Download MPV & Install This Build
- π¨ Video & GLSL Shader Profiles
- π§ Spatial Audio, Channel Modes, Volume Boost & Equalizer
- π¬ Subtitle Translation, Dual-Sub & Style Manager
- β¨οΈ Keyboard Shortcuts Reference
- π Repository Structure
- π§ Troubleshooting & FAQ
- Automatic & 1-Click Translation: Translates embedded (
.mkv,.mp4) or external (.ass,.srt,.vtt) subtitle tracks into 16 languages (Spanish, English, Japanese, Korean, French, German, Italian, Portuguese, Chinese, Russian, Arabic, Hindi, Turkish, Polish, Dutch, Swedish) with multi-threaded chunk concurrency. - Smart Bilingual / Dual-Sub Engine: Display two subtitle tracks simultaneously (Original Language on Top + Translated Target Language on Bottom).
- On-the-Fly Secondary Track Translation: If a video does not include subtitles in the language you want for the top track, select Translate on the fly for Top Subtitle to generate and display that language at the top (
secondary-sid) without replacing your primary bottom subtitle. - Full ASS Formatting Preservation: Protects complex
.assoverride tags ({\pos},\N,\h, vector drawings, and custom typesetting) during translation. - Smart Forced-Track Filtering: Automatically bypasses short "Signs & Songs" tracks to select and translate full dialogue tracks.
- π« "Off Custom" (Native Video Style Mode): Disables external style overrides (
sub-ass-override=no) with a single click to render embedded fansub or Blu-ray subtitles exactly as authored. - 5 Built-In Curated Presets:
- π¨ Hey Comic Signature (High-contrast legibility)
- πΈ Anime / Sharp Fansub (Crisp dark outline & elevated margin)
- π¬ Classic Cinema / Movies (Warm amber tone without visual fatigue)
- πΊ Series / Streaming Opaque Box (Translucent dark background box)
- β¨ K-Drama / Comfort Reading (Clean rounded sans-serif typography)
- Custom User Profiles: Tweak font size, text color (White, Cinema Yellow, Cyan, Green), border/opaque box style, font family, and vertical screen position in real time, then save your own named profiles (e.g., My Anime, Night Movies, Sitcoms) persisted in
sub_profiles.json.
- Automatic Content Classifier: Inspects track metadata, chapter titles, container signatures, aspect ratios, and frame rates to automatically apply the optimal video pipeline for Anime, Cinema, TV Series, or K-Dramas.
- 9 Selectable Shader Profiles: From battery-saving laptop modes (AMD Contrast Adaptive Sharpening, Modo Eco) to ultra-high-definition neural upscalers (ArtCNN C4F32, FSRCNNX, SSimSuperRes, KrigBilateral, Anime4K Fast Restore).
- Ambient Crop & Glow Engine: Crops ultrawide black bars (
autocrop) or adds a soft ambient light glow around letterboxed content, persisting seamlessly across playlist episodes.
- 8 Spatial Audio Modes: Standard Direct, Dolby Atmos Virtual Surround, Dolby Voice 3D Dialogue, DTS:X / Neural:X Spatial, Binaural Pro (BS2B Headphones), Expanded Stereo (Music/Live), Night Mode (Smart DRC), and HDMI/Optical Bitstream Passthrough.
- 7 Channel Layouts: Switch instantly between Auto-Safe, Mono (1.0), Stereo (2.0), Stereo 2.1 (LFE), Quadraphonic (4.0), Surround 5.1, and Surround 7.1.
- 5-Level Volume Boost (
+4 dBto+12 dB&Auto DRC): Compensates for quiet multi-channel movies or low-volume tracks using anti-clipping soft limiters (alimiter) and dynamic normalization (dynaudnorm), complete with live badge indicators (+4,+8,+12,DRC) on the control bar. - Interactive 6-Band Graphic Equalizer: Drag the visual fader knobs (
64 Hz,250 Hz,1 kHz,2.5 kHz,6 kHz,14 kHz) directly with your mouse, scroll with the mouse wheel, or choose from 6 acoustic presets.
- Color-Coded Chapter Ranges: Distinct Emerald Green markers for Openings (OP) and Vivid Purple markers for Endings (ED) on the timeline.
- 4 Intro/Ending Skip Modes: Choose between Manual (Tab Notification), Auto-Skip Opening & Ending, Auto-Skip Opening Only, or Disabled.
- Interactive A-B Segment Loop: Press
l(or use the control bar button) to set PointAand PointBwith golden markers and a cyan segment highlight directly on the timeline. - Visual Audio & Subtitle Delay Panels: Fine-tune audio or subtitle synchronization (
+0.50s,+0.10s,0.00s Reset,-0.10s,-0.50s) directly from the UI menus. - In-Player Language Priority Configurator (
alang/slang): Build your preferred audio and subtitle language arrival queues via click-to-order badges ([#1],[#2],[#3]) or free-text input without editing.conffiles manually.
This repository provides the complete, cross-platform configuration package (portable_config) alongside automated helper scripts for FFmpeg. Follow the steps below for your operating system.
- Go to the official Windows builds by shinchiro on SourceForge or GitHub:
- Recommended Link: mpv-winbuild-cmake Releases (GitHub) or SourceForge Mirror
- Download the latest
mpv-x86_64-v3-*.7z(for modern CPUs) ormpv-x86_64-*.7zarchive. - Extract the
.7zarchive into a folder of your choice (for example,C:\Program Files\mpv\orD:\Apps\mpv\) using 7-Zip or WinRAR.
- Download this repository (click Code β Download ZIP on GitHub, or clone it via Git).
- Copy the
portable_configfolder anddescargar-ffmpeg.batinto the same folder wherempv.exeis located:π Your MPV Folder/ βββ mpv.exe βββ descargar-ffmpeg.bat βββ π portable_config/ βββ mpv.conf βββ input.conf βββ π fonts/ βββ π script-opts/ βββ π scripts/ βββ π shaders/
- To translate subtitles embedded inside
.mkvor.mp4files, MPV needsffmpeg. - Double-click
descargar-ffmpeg.bat. It will check ifffmpegis already installed on your PC; if not, it will automatically download a lightweight officialffmpeg.exebinary and place it insideportable_config\.
- Double-click
mpv.exe(or runinstaller\mpv-install.batas Administrator inside your MPV folder to associate video files with MPV).
Open Terminal and run:
brew install --cask mpv
brew install ffmpeg(Alternatively, download the standalone mpv.app bundle from mpv.io/installation).
Copy the contents of the portable_config folder into ~/.config/mpv/:
# Clone the repository
git clone https://github.com/zubzertata/mpv-anitheater.git
cd mpv-anitheater
# Create the MPV config directory and copy all files
mkdir -p ~/.config/mpv
cp -r portable_config/* ~/.config/mpv/
# Ensure the ziggy helper binary has execution permissions
chmod +x ~/.config/mpv/scripts/uosc/bin/ziggy-darwinInstall mpv, ffmpeg, and curl using your distribution's package manager:
- Ubuntu / Debian / Linux Mint:
sudo apt update && sudo apt install mpv ffmpeg curl - Arch Linux / Manjaro:
sudo pacman -S mpv ffmpeg curl
- Fedora:
sudo dnf install mpv ffmpeg curl
Copy the contents of portable_config into ~/.config/mpv/:
git clone https://github.com/zubzertata/mpv-anitheater.git
cd mpv-anitheater
mkdir -p ~/.config/mpv
cp -r portable_config/* ~/.config/mpv/
# Ensure the ziggy helper binary has execution permissions
chmod +x ~/.config/mpv/scripts/uosc/bin/ziggy-linuxAccess these at any time via Right-Click β π¨ Perfil de Video or by pressing b:
| Profile | Active Shaders & Scalers | Best Used For | GPU Load |
|---|---|---|---|
| β¨ AutomΓ‘tico (Adaptativo) | Dynamic selection based on content | Everyday mixed playback (Anime, Movies, TV) | Adaptive |
| π Bajo Consumo | AMD_CAS.glsl + spline36 |
Laptops, integrated GPUs, cool & quiet operation | Very Low |
| βοΈ Intermedio / Equilibrado | SSimSuperRes.glsl + KrigBilateral.glsl |
1080p β 1440p/4K upscaling on mid-range GPUs | Medium |
| πΊ Series, K-Drama & TV | Deband + KrigBilateral.glsl + AMD_CAS.glsl |
Streaming episodes with dark-scene banding | LowβMed |
| πΈ Anime Ligero | Anime4K_Fast_Restore.glsl + KrigBilateral.glsl |
1080p Anime line restoration on modest GPUs | LowβMed |
| π₯ Anime Ultra | ArtCNN_C4F32.glsl + KrigBilateral.glsl + Deband |
Maximum neural line reconstruction for Anime | High |
| π¬ Cine & PelΓculas Ultra | FSRCNNX_x2_16-0-4-1.glsl + KrigBilateral.glsl |
Live-action movies, Blu-ray Remuxes & 4K downscaling | High |
| π EstΓ‘ndar Limpio | Pure spline64 + SSimDownscaler.glsl |
Reference-grade neutral scaling without sharpening | Low |
| β‘ Modo Eco Extremo | Hardware bilinear (0 shaders, deband=no) |
Maximum battery life on unplugged laptops | Minimal |
Access via Right-Click β ποΈ Ecualizador / Sonido Espacial or press E:
- Spatial Audio Profiles:
- π Standard (Direct): Bit-accurate original audio without spatial filters.
- π¬ Dolby Atmos / Virtual Surround: 120Β° 3D soundstage (
extrastereo+aecho) + LFE sub-bass boost + center dialogue clarity. - π£οΈ Dolby Voice (3D Vocal Clarity): Emphasizes 1 kHzβ3 kHz speech frequencies with gentle spatial width.
- π DTS:X / Neural:X Spatial: Wide Haas acoustic delay stage + TruBass harmonic punch + high-frequency detail.
- π§ Binaural Pro (BS2B): Bauer stereophonic-to-binaural crossfeed for fatigue-free headphone listening.
- π΅ Expanded Stereo (Music / Live): Phase widening + crystalizer treble definition for concerts and OSTs.
- π Night Mode (Smart DRC): Tames loud explosions while boosting whispered dialogue (
dynaudnorm). - π HDMI / Optical Passthrough: Pure bitstream passthrough (
ac3,eac3,dts,dtshd,truehd) to external AV receivers.
- Volume Boost (
Vkey or Control Bar Button):- π Off (0 dB) Β· π’ Soft (+4 dB) Β· π Medium (+8 dB) Β· π High (+12 dB) Β· π Auto DRC (Continuous Leveler).
Press T or c (or click the π¬ Subtitles icon on the control bar) to open the unified subtitle hub:
- β‘ Traducir subtΓtulo actual ahora: Translates the active subtitle track into your chosen target language and loads it automatically.
- π Modo BilingΓΌe (SubtΓtulo Superior):
- Enable 1-Click Smart Dual Sub to put the original track at the top of the screen and the translated track at the bottom.
- Choose any existing subtitle track from the file for the top position, or use Translate on the fly for Top Subtitle to translate any missing language directly into the top slot.
- π¨ Estilo y Perfiles de SubtΓtulos:
- Switch to π« Off Custom (Native Video Style) to preserve embedded ASS typesetting and fonts.
- Switch between the 5 built-in presets or customize font size, color, border/opaque box, font family, and vertical position, then save your own custom profiles.
| Shortcut | Action |
|---|---|
Right-Click / TAB |
Open Master Control Menu |
T / c |
Open Unified Subtitles, Dual-Sub & Translation Menu |
E |
Open Audio, Spatial Sound & 6-Band Equalizer Menu |
V |
Cycle Volume Boost (Off β +4 dB β +8 dB β +12 dB β Auto DRC) |
B |
Open Control Bar Customizer (Show/Hide buttons) |
b |
Cycle Video & Shader Profile |
e |
Toggle Extreme Eco Mode (Battery Saver) |
m |
Toggle Binaural Spatial Audio |
n |
Toggle Night Audio Mode (DRC) |
l / L |
Cycle A-B Segment Loop (Set A β Set B β Clear) / Clear Loop |
s / v |
Cycle subtitle track / Toggle subtitle visibility |
Ctrl + s |
Cycle secondary (top) subtitle track |
a |
Cycle audio track |
[ / ] |
Adjust subtitle delay (-0.10s / +0.10s) |
{ / } |
Adjust audio delay (-0.10s / +0.10s) |
Space |
Play / Pause |
f / Esc |
Toggle Fullscreen / Exit Fullscreen |
Shift + Right / Left |
Exact 1-second seek forward / backward |
Right / Left |
5-second keyframe seek forward / backward |
Up / Down / Wheel |
Increase / Decrease Volume (Β±2%) |
F5 |
Take clean video screenshot |
i |
Toggle technical playback statistics (stats) |
q |
Quit and save playback position (watch-later) |
βββ descargar-ffmpeg.bat # Automated FFmpeg downloader for Windows
βββ descargar-ffmpeg.sh # FFmpeg verification & install helper for Linux/macOS
βββ README.md # Documentation & SEO guide
βββ portable_config/ # Cross-platform MPV configuration root
βββ mpv.conf # Core hardware decoding, audio/video & subtitle defaults
βββ input.conf # Custom keyboard & mouse bindings
βββ fonts/ # Bundled UI icon fonts & subtitle typography
βββ script-opts/ # Persistent configuration files for Lua modules
β βββ autoload.conf
β βββ controller.conf
β βββ thumbfast.conf
β βββ traduccion.conf
β βββ uosc.conf
β βββ uosc_controls.conf
βββ scripts/
β βββ ambient-manager.lua # Dynamic Ambient Crop & letterbox glow manager
β βββ autocrop.lua # Automatic black-bar detection
β βββ autoload.lua # Automatic folder episode playlist loader
β βββ controller.lua # Video/Audio/EQ/Boost/Language priority engine
β βββ skip_intro.lua # Opening/Ending chapter detector & auto-skipper
β βββ thumbfast.lua # High-speed on-the-fly timeline thumbnail generator
β βββ window_border.lua # Native Windows 11 DWM rounded corners integration
β βββ traduccion/ # Multi-threaded subtitle extraction & translation engine
β β βββ main.lua
β β βββ parser.lua
β β βββ translator.lua
β β βββ backends/google.lua
β βββ uosc/ # Customized UOSC interface with EQ sliders & A-B timeline
βββ shaders/ # Curated GLSL GPU shaders
βββ AMD_CAS.glsl
βββ Anime4K_Fast_Restore.glsl
βββ ArtCNN_C4F32.glsl
βββ FSRCNNX_x2_16-0-4-1.glsl
βββ KrigBilateral.glsl
βββ SSimDownscaler.glsl
βββ SSimSuperRes.glsl
βββ adaptive-sharpen-modern-film.glsl
βββ ambient_baked_0.glsl
βββ ambient_baked_1.glsl
- Subtitles inside
.mkvfiles aren't translating automatically: Make sureffmpegis installed. On Windows, rundescargar-ffmpeg.batsoffmpeg.exeis placed insideportable_config/. On macOS/Linux, verifyffmpeg -versionworks in your terminal. - Embedded Anime fansub styles look different from the original release:
Open the Subtitles menu (
Torc) β π¨ Estilo y Perfiles de SubtΓtulos β select π« Off Custom (Estilo Nativo del Video). - High GPU usage on a laptop or integrated graphics:
Open the main menu (
Right-Click) β π¨ Perfil de Video β select π Bajo Consumo (AMD CAS + Spline36) or pressefor β‘ Modo Eco Extremo.
- MPV Player β Core multimedia engine.
- uosc & thumbfast β Base UI framework and thumbnailing engine, customized with interactive graphic EQ sliders, dynamic island notifications, and A-B loop timeline markers.
- Shader Authors: Artoriuz (
ArtCNN), igv (FSRCNNX,KrigBilateral,SSimSuperRes,SSimDownscaler), bloc97 (Anime4K), AMD (FidelityFX CAS).