Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Ares-0/mpv-composition-guides
This script overlays basic composition guides on your mpv video.
https://github.com/Ares-0/mpv-composition-guides
Last synced: about 2 months ago
JSON representation
This script overlays basic composition guides on your mpv video.
- Host: GitHub
- URL: https://github.com/Ares-0/mpv-composition-guides
- Owner: Ares-0
- License: mit
- Created: 2020-06-30T22:46:14.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-04-02T22:33:58.000Z (over 1 year ago)
- Last Synced: 2024-06-30T14:48:10.869Z (3 months ago)
- Language: Lua
- Homepage:
- Size: 522 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mpv - composition guides - Overlay basic composition guides onto your video. (Other)
README
## MPV Composition Guides
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
