mpv-scripts/README.md

MPV Scripts

Save Properties

Saves the properties specified by the user every time MPV is exited, and applies them when MPV is started.

Options

• properties: Comma-separated list of the properties to save. (Default="volume,sub-scale")

Screenshot to Farbfeld

Saves screenshots in Farbfeld format in MPV's default screenshot directory (XDG_PICTURES_DIR/mpv if not specified). It does that by converting a temporary PNG screenshot (add screenshot-png-compression=0 to your mpv.conf for maximum performance).

Options

• bzip2: Applies bzip2 compression to the screenshot (and saves it in .ff.bz2) if is set to 1, it doesn't (and saves the screenshot in .ff) otherwise. (Default=1)
• screenshot_subtitles: Keybinding for taking the screenshot in subtiltes mode (with subtitles and OSD). (Default=s)
• screenshot_video: Keybinding for taking the screenshot in video mode (no subtitles/OSD). (Default=s)
• screenshot_windows: Keybinding for taking the screenshot in window mode (window as it appears on screen). (Default=Ctrl+s)

Clock

Displays an OSD clock.

Options

• format: The time format. (Default=%_H:%M%S)
• ass_position: Position of the clock in ass format (1=left, 2=center, 3=right for the horizontal alignment, 0=bottom, 4=top, 8=middle for the vertical alignment; the sum is the position). (Default=7)
• show_clock_binding: Binding to show the clock for a short period of time. (Default=Ctrl+c)
• toggle_clock_binding: Binding to toggle the displaying of a permanent clock. (Default=Ctrl+C)

How to use

Put the .lua file in your ~/.config/mpv/scripts and the configuration file (optional) in an homonymous .config file in ~/.config/mpv/script-opts.