{"id":13835563,"url":"https://github.com/Zabooby/mpv-config","last_synced_at":"2025-07-10T08:30:45.141Z","repository":{"id":41082399,"uuid":"501542193","full_name":"Zabooby/mpv-config","owner":"Zabooby","description":"Personal mpv config files aiming to get the best quality and viewing experience","archived":false,"fork":false,"pushed_at":"2024-09-15T14:38:58.000Z","size":39940,"stargazers_count":258,"open_issues_count":1,"forks_count":13,"subscribers_count":17,"default_branch":"main","last_synced_at":"2024-09-15T15:53:34.477Z","etag":null,"topics":["config","configuration-files","glsl","glsl-shaders","gui","lua","media-player","mpv","mpv-config","mpv-player","mpv-scripts","shaders","video","video-player"],"latest_commit_sha":null,"homepage":"https://mpv.io","language":"GLSL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zabooby.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-09T07:06:24.000Z","updated_at":"2024-09-15T14:39:03.000Z","dependencies_parsed_at":"2024-09-15T15:59:47.637Z","dependency_job_id":null,"html_url":"https://github.com/Zabooby/mpv-config","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zabooby%2Fmpv-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zabooby%2Fmpv-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zabooby%2Fmpv-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zabooby%2Fmpv-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zabooby","download_url":"https://codeload.github.com/Zabooby/mpv-config/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225627409,"owners_count":17498980,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["config","configuration-files","glsl","glsl-shaders","gui","lua","media-player","mpv","mpv-config","mpv-player","mpv-scripts","shaders","video","video-player"],"created_at":"2024-08-04T14:01:05.305Z","updated_at":"2025-07-10T08:30:45.123Z","avatar_url":"https://github.com/Zabooby.png","language":"GLSL","readme":"# Personal mpv Configuration for Windows\n\n\u003cp align=\"center\"\u003e\u003cimg width=100% src=\"https://github.com/Zabooby/mpv-config/assets/78969986/3d95db6f-4ebd-4e84-94cc-c1825297f18e\" alt=\"mpv screenshot\"\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003cimg width=100% src=\"https://github.com/Zabooby/mpv-config/assets/78969986/e4dec0a5-fb4a-438e-96f0-4b87a0f59d34\" alt=\"mpv screenshot\"\u003e\u003c/p\u003e\n\n## Overview\nJust my personal config files for use in [mpv](https://mpv.io/), a free, open-source, \u0026 cross-platform media player, with a focus on quality and a practical yet comfortable viewing experience. Contains tuned profiles (for up/downscaling, live action \u0026 anime), custom key bindings, a GUI, as well as multiple scripts, shaders \u0026 filters, all serving different functions. Suitable for both high and low-end computers (with some tweaks).\n\nBefore installing, please take your time to read this whole README as common issues can be easily solved by simply reading carefully.\n\n## Scripts and Shaders\n- [uosc](https://github.com/darsain/uosc) - Adds a minimalist but highly customisable GUI.\n- [evafast](https://github.com/po5/evafast) - Fast-forwarding and seeking on a single key.\n- [thumbfast](https://github.com/po5/thumbfast) - High-performance on-the-fly thumbnailer.\n- [memo](https://github.com/po5/memo) - Saves watch history, and displays it in a nice menu, integrated with uosc.\n- [InputEvent](https://github.com/natural-harmonia-gropius/input-event) - Enhances input.conf with better, conflict-free, low-latency event mechanisms.\n- [autoload](https://github.com/mpv-player/mpv/blob/master/TOOLS/lua/autoload.lua) - Automatically load playlist entries before and after the currently playing file, by scanning the directory.\n- [autodeint](https://github.com/mpv-player/mpv/blob/master/TOOLS/lua/autodeint.lua) - Automatically insert the appropriate deinterlacing filter based on a short section of the current video, triggered by key bind. \n- [webtorrent-mpv-hook](https://github.com/mrxdst/webtorrent-mpv-hook) - Adds a hook that allows mpv to stream torrents. It provides an osd overlay to show info/progress.\n    - **This script requires some extra setup, follow the simple installation steps [here](https://github.com/mrxdst/webtorrent-mpv-hook#install)**.\n    - **Point to the same location specified in the File Structure section below, when installing the webtorrent.js file.**\n- - - \n- [nlmeans](https://github.com/AN3223/dotfiles/tree/master/.config/mpv/shaders) - Highly configurable and featureful denoiser.\n- [FSRCNNX-TensorFlow](https://github.com/igv/FSRCNN-TensorFlow) - Resource intensive prescaler based on layered convolutional networks.\n- [Anime4k](https://github.com/bloc97/Anime4K) - Shaders designed to scale and enhance anime. Includes shaders for line sharpening and upscaling.\n- [AMD FidelityFX Super Resolution EASU](https://gist.github.com/agyild/82219c545228d70c5604f865ce0b0ce5) (FSR without RCAS) - A spatial upscaler which provides consistent upscaling quality regardless of whether the frame is in movement.\n- [mpv-prescalers](https://github.com/bjin/mpv-prescalers) - RAVU (Rapid and Accurate Video Upscaling) is a set of prescalers with an overall performance consumption design slightly higher than the built-in ewa scaler, while providing much better results. \n- [SSimDownscaler, SSimSuperRes, KrigBilateral, Adaptive Sharpen](https://gist.github.com/igv) \n    - Adaptive Sharpen: Another sharpening shader.\n    - SSimDownscaler: Perceptually based downscaler.\n    - KrigBilateral: Chroma scaler that uses luma information for high quality upscaling.\n    - SSimSuperRes: Make corrections to the image upscaled by mpv built-in scaler (removes ringing artifacts and restores original  sharpness).\n   \n## Installation (on Windows)\n\n(Not tested on Linux and macOS but once mpv is installed, copying the contents of my `portable_config` into the [relevant](https://mpv.io/manual/master/#files) folders should be sufficient. Some settings in [mpv.conf](https://github.com/Zabooby/mpv-config/blob/main/portable_config/mpv.conf) may need to be changed due to compatibility issues. Check console for any errors.)\n\n* Download the latest 64bit (or 64bit-v3 for newer CPUs) mpv Windows build by shinchiro [here](https://mpv.io/installation/) or directly from [here](https://sourceforge.net/projects/mpv-player-windows/files) and extract its contents into a folder of your choice (mine is called mpv). This is now your mpv folder and can be placed wherever you want. \n* Run `mpv-install.bat`, which is located in the `installer` folder (see File Structure section), with administrator privileges by right-clicking and selecting run as administrator, after it's done, you'll get a prompt to open Control Panel and set mpv as the default player.\n* Download and extract the `portable_config` folder from this repo to the mpv folder you just made. \n* Add file paths, to 2 files in the [script-opts](https://github.com/Zabooby/mpv-config/tree/main/portable_config/script-opts) folder (detailed in the File Structure section), to match your preferences. \n* **Adjust relevant settings in [mpv.conf](https://github.com/Zabooby/mpv-config/blob/main/portable_config/mpv.conf) to fit your system, use the [manual](https://mpv.io/manual/master/) to find out what different options do or open an issue if you need any help.**\n* For mpv updates, right click updater.bat and run as administrator, then follow the instructions. There will be an option to install yt-dlp to be able to stream YouTube videos and any other websites supported by [yt-dlp,](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md) if you want. Once the initial run of updater.bat has completed a settings.xml file will be generated to save your preferences. \n* You're all set up. Go watch some videos!\n\nAfter following the steps above, your mpv folder should have the following structure:\n\n## File Structure (on Windows)\n\n```\nmpv\n|\n├── doc\n│   ├── manual.pdf                            \n│   └── mpbindings.png                    # Default key bindings if not overridden in input.conf\n│\n├── installer\n│   ├── mpv-icon.ico\n│   ├── mpv-install.bat                   # Run with administrator priviledges to install mpv\n│   ├── mpv-uninstall.bat                 # Run with administrator priviledges to uninstall mpv\n│   └── updater.ps1\n│\n├── portable_config                       # This is where my config is placed\n│   ├── cache                             # Created automatically  \n│   │   ├──  watch_later                  # Video timestamps saved here (created automatically)\n│   │\n│   ├── fonts\n│   │   ├── ClearSans-Bold.ttf\n│   │   ├── JetBrainsMono-Regular.ttf\n|   |   ├── uosc_icons.otf\n|   |   └── uosc_textures.ttf\n│   │\n│   ├── script-opts                       # Contains configuration files for scripts\n|   |   ├── console.conf\n|   |   ├── evafast.conf \n|   |   ├── memo.conf\n|   |   ├── memo-history.log              # Created automatically \n│   │   ├── thumbfast.conf                    \n│   │   ├── uosc.conf                     # Set desired default directory for uosc menu here\n│   │   └── webtorrent.conf               # Specify where to save downloaded files here\n│   │\n│   ├── scripts      \n│   │   ├── uosc              \n│   │       ├── bin \n|   |           ├── ziggy-darwin\n|   |           ├── ziggy-linux\n|   |           ├── ziggy-windows.exe\n│   │       ├── char_conv\n|   |           ├── zh.json\n│   │       ├── elements \n|   |           ├── BufferingIndicator.lua\n|   |           ├── Button.lua\n|   |           ├── Controls.lua\n|   |           ├── Curtain.lua\n|   |           ├── CycleButton.lua\n|   |           ├── Element.lua\n|   |           ├── Elements.lua\n|   |           ├── ManagedButton.lua\n|   |           ├── Menu.lua\n|   |           ├── PauseIndicator.lua\n|   |           ├── Speed.lua\n|   |           ├── Timeline.lua\n|   |           ├── TopBar.lua\n|   |           ├── Updater.lua\n|   |           ├── Volume.lua\n|   |           └── WindowBorder.lua\n|   |       ├── intl\n|   |           ├── de.lua\n|   |           ├── es.lua\n|   |           ├── fr.json\n|   |           ├── ro.json\n|   |           ├── ru.json\n|   |           ├── uk.json\n|   |           └── zh-hans.json\n|   |       ├── lib\n|   |           ├── ass.lua\n|   |           ├── buttons.lua\n|   |           ├── char_conv.lua\n|   |           ├── cursor.lua\n|   |           ├── intl.lua\n|   |           ├── menus.lua\n|   |           ├── std.lua\n|   |           ├── text.lua\n|   |           └── utils.lua\n|   |       └── main.lua\n│   │\n│   │   ├── autodeint.lua\n│   │   ├── autoload.lua \n│   │   ├── evafast.lua                   # Activated by holding right arrow key\n│   │   ├── inputevent.lua\n|   |   ├── memo.lua\n│   │   ├── thumbfast.lua                     \n│   │   └── webtorrent.js                 # Point here when setting up the webtorrent script\n│   │\n│   ├── shaders                          \n│   │   ├── A4K_Dark.glsl                         \n│   │   ├── A4K_Thin.glsl\n│   │   ├── A4K_Upscale_L.glsl\n│   │   ├── adasharp.glsl                     \n│   │   ├── adasharpA.glsl                # Adjusted for anime\n│   │   ├── CAS.glsl\n│   │   ├── CfL_P.glsl\n│   │   ├── F16.glsl\n│   │   ├── F16_LA.glsl\n│   │   ├── FSR_EASU.glsl       \n│   │   ├── nlmeans_HQ.glsl\n│   │   ├── nlmeans_L_HQ.glsl\n│   │   ├── NVSharpen.glsl\n│   │   ├── ravu_L_ar_r4.hook\n│   │   ├── ravu_Z_ar_r3.hook\n│   │   ├── ssimds.glsl\n│   │   └── ssimsr.glsl\n│   │\n|   ├── fonts.conf                        # Delete the duplicate made when installing mpv\n│   ├── input.conf                        # Customise uosc menu here\n│   ├── mpv.conf                          \n|   └── profiles.conf                     \n|   \n├── d3dcompiler_43.dll\n├── mpv.com\n├── mpv.exe                               # The mpv executable file\n├── settings.xml                          # Created after initial run of updater.bat\n├── updater.bat                           # Run with administrator priviledges to update mpv\n└── yt-dlp.exe                            \n```\n\n## Key Bindings\nCustom key bindings can be added/edited in the [input.conf](https://github.com/Zabooby/mpv-config/blob/main/portable_config/input.conf) file. Refer to the [manual](https://mpv.io/manual/master/) and [uosc](https://github.com/tomasklaen/uosc#commands) commands for making any changes. Default key bindings can be seen from the [input.conf](https://github.com/Zabooby/mpv-config/blob/main/portable_config/input.conf) file but most of the player functions can be used through the menu accessed by `Right Click` and the buttons above the timeline as seen in the images above.\n\n## Useful Links\n\n* [mpv wiki](https://github.com/mpv-player/mpv/wiki) - Official wiki with links to all user scripts/shaders, FAQ's, discussions and much more.\n    * [Awesome mpv](https://github.com/stax76/awesome-mpv) -  A curated list of the user resources in the wiki, listed in distinct sections for easier browsing.\n* [mpv manual](https://mpv.io/manual/master/) - Lists and explains all the settings and configuration options available including video/audio settings, scripting, and countless other customisations.\n* [To-do's](https://github.com/users/Zabooby/projects/1) - Just a list of things I'm currently testing, tracking or improving as well as major changes/improvements I've already implemented (click on items for more information).","funding_links":[],"categories":["Other","GLSL"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZabooby%2Fmpv-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZabooby%2Fmpv-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZabooby%2Fmpv-config/lists"}