Home

uosc-controls-modifier (ucm)

Extends the uosc control bar so a single button slot can show several states and switch between them:

• Holding a modifier key (inputevent)
• Keys in input.conf
• Property observers — fields referencing [[property]] update on the fly
• Auto-profiles — e.g. a different set of buttons in fullscreen

Requirements

• MPV player
• uosc user interface
• inputevent — optional, but recommended

Installation

1. Copy the ucm/ folder into your mpv scripts folder. MPV loads it as the script named ucm.
2. Copy ucm.conf into script-opts (MPV only auto-reads script-opts/<script-name>.conf).

Getting started

1. Pick buttons in ucm.conf — it ships with 9 commented example buttons; uncomment the ones you want.
2. Reference them in uosc.conf with button:<name>.
3. Optionally, map states to modifier keys with state_map (needs inputevent) — otherwise the button just shows its default state.

Pages

• How it works — what a state is, why placeholders exist (read this first)
• Button configuration — conf syntax, fields, fill-up, coercion
• Global configuration — state_map, state_cycle_map, and the other script-level options
• Placeholders — [[property]], ?? / ?! / !!, ?(f), ?(p), ?(c), UCM_NIL
• Script messages — everything other scripts / input.conf can send, and the replies
• Examples — input.conf, other-script snippets, button injection
• Per-profile button layouts — different button sets per situation (fullscreen, anime, music)