mpv-config/README.md

mpv-config

My mpv config. Requires mpv v0.37+

Installation

Linux/Mac

1. Clone this repo into the mpv config location

git clone https://github.com/warigan/mpv-config ~/.config/mpv

2. Create symbolic link:

cd ~/.config/mpv
ln -s mpv_linux.conf mpv.conf

3. (Optional) To use autosubsync, choose synctools in script-opts/autosubsync.conf, install them on your system then specify their paths.

4. (Optional) To use autosub, it is recommended to configure login credentials in scripts/autosub.lua.

Windows

1. Clone this repo into the mpv config location

git clone https://github.com/warigan/mpv-config C:\users\$env:username\AppData\Roaming\mpv

2. Create symbolic link (might need admin privileges):

cd C:\users\$env:username\AppData\Roaming\mpv
New-Item -ItemType SymbolicLink -Path mpv.conf -Target .\mpv_windows.conf

3. (Optional) To use autosubsync, choose synctools in script-opts/autosubsync.conf, install them on your system then specify their paths.

4. (Optional) To use autosub, it is recommended to configure login credentials in scripts/autosub.lua.

Usage

Shader auto profiles

Anime4K

If the path of the currently playing file contains a directory named Anime (case insensitive) mpv will automatically load the anime shader profile which in turn will load the configured Anime4K profile.

The default (Anime4K: Mode A (HQ)) is my personal choice for my system (Ryzen 7 7800X3D, RX 6900 XT @ 165 Hz), if this is not ideal for you it can be changed in mpv.conf under [anime]. I recommend experimenting by enabling the statistics overlay (Shift+I) and enable one at a time with Ctrl+[0-9]. See the Anime4K docs for more information.

FSR

If the path of the currently playing file contains a directory named Movies, TV-Series, TV_Series or TVSeries (all case insensitive) then mpv will automatically load the live-action shader profile. By default this will in turn load the FidelityFX FSR shader.

Key bindings

Use Ctrl+[1-6] to manually select a Anime4K profile and Ctrl+9 for FSR. Ctrl+0 clears the shaders so no profile is active.

NOTE: Profile switching is not saved across sessions, so if you don't want to use the configured default you would have to change every time you open a video. I recommend you instead change the defaults in mpv.conf.

Subtitles

To auto-download subtitles for the currently playing video, press b. To auto-sync the currently selected subtitles with the audio, press n.

Third-Party

This project includes third party software from the projects listed below. All respective licenses are available under the third-party directory.

Fonts

• Material Design Iconic Font 2.2.0 by Sergey Kupletsky, licensed under CC BY-SA 4.0.
  • This font includes the official Material Design icons created and maintained by Google, licensed under Apache 2.0, alongside additional community-designed and brand icons for scalable vector graphics.
  • This font has not been modified from its original version.
  • The license text is available here.

Scripts

• autosubsync-mpv v0.33, licensed under MIT
• mpv-autosub, licensed under MIT
• ModernX 0.6.1
• thumbfast, licensed under MPL 2.0

Shaders

• Anime4K v4.0.1, licensed under MIT, with the exception of the following shaders which are instead licensed under Unlicense:

  • Anime4K_AutoDownscalePre_x2
  • Anime4K_AutoDownscalePre_x4

• FSR.glsl v1.0.2, licensed under MIT

Lua stubs

• emmylua-stubs, licensed under MIT