mpv-scripts

Collection of small Lua scripts for mpv, organized into focused folders.

Folders

• profiles/ - automatic profile evaluation and profile tracking utilities. See profiles/README.md.
• startscreen/ - monitor detection, friendly display names, window placement and cycling. See startscreen/README.md.

Quick start

1. Copy this repository (or the desired folders) into your mpv scripts directory:

   • Windows: %APPDATA%/mpv/scripts/
   • Linux/macOS: ~/.config/mpv/scripts/

2. Start mpv (it will automatically load .lua files from the scripts folder).

Notes

• Some features depend on external tools on Windows (e.g. MultiMonitorTool.exe) for friendly monitor names and coordinates.
• Use startscreen/startscreen.conf to configure the preferred display, offsets, and cycle hotkey.

Contributing

PRs and issues welcome. Include mpv version, OS, and steps to reproduce.