Note: This config is still in the experimental phase.
This repository is my personal configuration and collection of scripts and shaders for mpv. The configuration was made to work on Linux, but it should still work well on other operating systems.
A major feature of this configuration is the custom mpv_manager system designed to automatically keep all 3rd-party scripts, shaders, and utilities perfectly up to date.
- GitHub Actions: An automated workflow runs every Sunday at midnight to fetch upstream updates directly into this repository.
- Declarative Configuration: The script map is defined simply in
manager.json, allowing mapping of GitHub repositories and directories to local paths. - Modular Support: It seamlessly parses whole repositories or single standalone
.luascripts, extracting them to their exact necessary locations. - Local Runner: If you do not wish to use GitHub Actions, you can run the manager script manually inside mpv.
- Video (
vuality) - Configured for the highest possible video quality. - Audio (
audio) - Configured for the best possible audio fidelity. - Netflix Subtitles - Styled to look identical to Netflix subtitles.
- mpv_manager - Manages downloading and updating all scripts.
- load-subdirs - Automatically loads all
main.*and.conffiles from subdirectories.
- ModernZ - A modern UI replacement for the default OSC.
- Thumbfast - Generates high-performance thumbnails on the OSC timeline.
- Pause Indicator - Displays a sleek play/pause indicator on screen.
- Context Menu - A right-click context menu within mpv.
- Interactive Video - Support for interactive branching videos.
- Notify Skip - Advanced chapter and silence-based skipping for anime/TV intros.
- Smart Track Selector - Automatically selects the best audio and subtitle tracks.
- Profile Manager - Dynamically applies configurations and shader presets based on content.
- mpv-auto-chapters - Automatically generates chapters based on video silence and black frames.
- Reactive VF Bypass - Bypasses video filters efficiently when not needed.
- SVP Cleanup - Cleanup tools for SmoothVideo Project (SVP) integration.
- Recent - Keeps track of recently watched files.
- mpv-autosub - Automatically downloads missing subtitles using Subliminal.
- trakt-mpv - Automatic scrobbling of watch history to Trakt.tv.
- mpv-anilist-updater - Automatically updates your anime watch status on AniList.
Dynamic shader profiles are automatically applied using the Profile Manager.
- Anime4K - Real-time anime upscaling, denoising, and debanding.
- NLMeans & Denoise - Standard mpv noise reduction shaders.
- Tsubajashi Shaders - Collection of shaders from the Tsubajashi configuration.
A huge thank you to the original creators whose scripts, configurations, and shaders have been adapted and included in this repository:
- allecsc for the incredible Stremio-Kai suite (Notify Skip, Profile Manager, Smart Track Selector, etc.).
- Samillion for the ModernZ user interface.
- po5 for Thumbfast and mpv-auto-chapters.
- bloc97 for the amazing Anime4K shaders.
- Tsubajashi, thisisshihan, carmanaught, mosquito-byte, hacel, davidde, and AzuredBlue for their various utilities and playback enhancements.
See TODO.md for the list of planned improvements and bug fixes.