You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This script overlays basic composition guides on your mpv video.
Installation
Scripts are usually placed in ~/.mpv/scripts/ (macOS/Linux) or %AppData%\mpv\scripts\ (Windows).
Put the entire downloaded folder in this directory. Do not rearrange individual files or directories.
The name of the directory is irrelevant, as long as ...\scripts\whatever\main.lua is preserved, it should work.
See: https://mpv.io/manual/master/#lua-scripting and https://github.com/mpv-player/mpv/wiki/User-Scripts
Usage
g cycle through the guides
G reset back to no guides
CTRL g cycle between 16:9 mode and 4:3 mode
Notes
Everything breaks when you're not full screen btw, and that's not really a fixable issue; that's just how MPV / this script works.
The 4:3 ones may look a tad wonky because of the scaling, but everything lines up appropriately
'Advanced'
To remove the feedback in the top left, in main.lua change variable verbose to false.
To change what key the script uses, in main.lua set the variable key to another character.
To disable automatic keybinding, in main.lua set the variable key to nil
To add hooks to input.conf, use the key-bindings comp_guide_cycle, comp_guide_clear, and comp_guide_43. For example: h script-binding comp_guide_cycle Alt+q script-binding comp_guide_clear Ctrl+m script-binding comp_guide_43
If you want to add more guides, add the filename and guide name to the arrays and leave a bgra formatted file in the "guides" folder.
Open an issue or bother MasterofAres#1755 on discord if something breaks
Images
About
This script overlays basic composition guides on your mpv video.