Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/CogentRedTester/mpv-changerefresh

A script to automatically change the refresh rate of the current display to match the playing video
https://github.com/CogentRedTester/mpv-changerefresh

display-switcher mpv-player mpv-script refresh-rates

Last synced: about 2 months ago
JSON representation

A script to automatically change the refresh rate of the current display to match the playing video

Awesome Lists containing this project

README 

        
# change-refresh



This script uses nircmd (windows only) to change the refresh rate of the display that the mpv window is currently open in

This was written because I could not get autospeedwin to work :(



The script uses a hotkey by default, but can be setup to run on startup.



## Behaviour

When the script is activated it will automatically detect the refresh rate of the current video and attempt to change the display

to the closes rate on the whitelist. The script will keep track of the original refresh rate of the monitor and revert when either the

correct keybind is pressed, or when mpv exits. The original rate needs to be included on the whitelist and follows

custom rate rules (i.e. if the monitor was originally 25Hz and the whitelist contains `25-50`, then it will revert to 50).



## Rate Whitelist

If the display does not support the specified resolution or refresh rate it will silently fail

If the video refresh rate does not match any on the whitelist it will pick the next highest.

If the video fps is higher than any on the whitelist it will pick the highest available

The whitelist is specified via the script-opt `rates`. Valid rates are separated via semicolons, do not include spaces and list in ascending order.

    

    changerefresh-rates="23;24;30;60"



### Custom Rates

You can also set a custom display rate for individual video rates using a hyphen:

    

    changerefresh-rates="23;24;25-50;30;60"

This will change the display to 23, 24, and 30 fps when playing videos in those same rates, but will change the display to 50 fps when

playing videos in 25 Hz



## Monitor Detection

The script automatically detects which monitor the mpv window is currently loaded on, and will save the original resolution and rate to revert to.

The original resolution is found by quickly switching to and from fullscreen mode, but if the resolution of the monitor never changes then this

automatic check can be disabled and the dimensions manually set in the config file.



Note that if the mpv window is lying across multiple displays it may not save the original refresh rate of the correct display



## UHD Mode

The script will always use the current dimensions of the monitor when switching refresh rates,

however I have an UHD mode (option is UHD_adaptive) hardcoded to use a resolution of 3840x2160p for videos with a height of > 1440 pixels.

This will cause the display to switch to UHD for UHD video, and back to the previous resolution for any other video. This is only useful if your computer

can handle playing UHD files directly, but not upscaling to UHD.



## Keybinds

The keybind to switch refresh rates is f10 by default, but this can be changed by setting different script bindings in input.conf.

The keybinds, and their behaviour are as follows:



    f10         match-refresh           detects the video fps and attempts to change the monitor refresh

    Ctrl+f10    revert-refresh          revert the display to the original refresh rate

                toggle-fps-type         switch between using the estimated and specified fps for the video

                set-default-refresh     set the current resolution/refresh as the default



## Script Messages

You can also send refresh change commands directly using script messages:

    

    script-message change-refresh [width] [height] [rate] [display]



Display stands for the display number (starting from 0) which is printed to the console when the display is changed.

Leaving out this argument will auto-detect the currently used monitor, like the usual behaviour.



These script messages completely bypass the whitelist and rate associations and are sent to nircmd directly, so make sure you send a valid integer.

They are also completely independant from the usual automatic reversion system, so you'll have to handle that yourself.



## Configuration

See `changerefresh.conf` for the full options list, this file can be placed into the script-opts folder inside the mpv config directory.