# ModernZ Controls Guide

![modernz_osc_controls](https://github.com/user-attachments/assets/deb52cf2-8288-4f40-9993-9b7cb3e863e0)

## Button Interactions

Below is a list that explains the OSC buttons function depending on how you interact with them.

> [!NOTE]
> Middle clicking performs the same function as `Shift+left mouse button`, allowing for one handed use

### Title

| Action            | Function                  |
| ----------------- | ------------------------- |
| Left mouse click  | Show `media-title` in OSD |
| Right mouse click | Show `filename` in OSD    |

### Seekbar

| Action                 | Function                           |
| ---------------------- | ---------------------------------- |
| Left mouse click       | Seek to position (using keyframes) |
| Shift+left mouse click | Seek to the exact position         |
| Right mouse click      | Seek to the head of chosen chapter |
| Scroll wheel           | Seek forward/backwards             |

### Play Time Codes

| Action            | Function                                     |
| ----------------- | -------------------------------------------- |
| Left mouse click  | Display remaining time instead of total time |
| Right mouse click | Display time in milliseconds                 |

### Play/Pause

| Action            | Function                   |
| ----------------- | -------------------------- |
| Left mouse click  | Toggle play/pause          |
| Right mouse click | Toggle enable/disable loop |

### Playlist Track Back/Forward

| Action                 | Function                |
| ---------------------- | ----------------------- |
| Left mouse click       | Play previous/next file |
| Right mouse click      | Show a simple playlist  |
| Shift+left mouse click | Show a simple playlist  |

### Skip Chapter Back/Forward

| Action                  | Function                              |
| ----------------------- | ------------------------------------- |
| Left mouse click        | Go to previous/next chapter           |
| Right mouse click       | Show an interactive chapters list     |
| Shift+left mouse click  | Jump forwards/backwards by 60 seconds |
| Shift+right mouse click | Show a simple chapters list           |

### Jump Back/Forward

| Action                 | Function                                                                |
| ---------------------- | ----------------------------------------------------------------------- |
| Left mouse click       | Jumps forwards/backwards by 10 seconds (or by `user_opts` `jumpamount`) |
| Right mouse click      | Jumps forwards/backwards by 1 minute                                    |
| Shift+left mouse click | Skips to the previous/next frame (and pauses)                           |

### Audio/Subtitle

| Action                 | Function                            |
| ---------------------- | ----------------------------------- |
| Left mouse click       | Show an interactive tracks list     |
| Right mouse click      | Cycle audio/subtitle track          |
| Shift+left mouse click | Show a simple tracks list           |
| Scroll wheel           | Cycle audio/subtitle tracks up/down |

### Playlist

| Action            | Function                     |
| ----------------- | ---------------------------- |
| Left mouse click  | Show an interactive playlist |
| Right mouse click | Show a simple playlist       |

### Volume

| Action           | Function              |
| ---------------- | --------------------- |
| Left mouse click | Toggle mute on/off    |
| Scroll wheel     | Change volume up/down |

### Screenshot

| Action           | Function          |
| ---------------- | ----------------- |
| Left mouse click | Take a screenshot |

### Pin

| Action            | Function                               |
| ----------------- | -------------------------------------- |
| Left mouse click  | Toggle pin and toggle window border    |
| Right mouse click | Toggle pin without changing the border |

### Loop

| Action            | Function             |
| ----------------- | -------------------- |
| Left mouse click  | Toggle loop on/off   |

### Speed Control

| Action                 | Function                                  |
| ---------------------- | ----------------------------------------- |
| Left mouse click       | Increase playing speed by increments of 1 |
| Right mouse click      | Reset playing speed to normal             |
| Scroll wheel           | Inc/decrease playing speed by 0.25        |

### Download

| Action            | Function                             |
| ----------------- | ------------------------------------ |
| Left mouse click  | Download the current video/image URL |

## Keybinds

| Function            | Input Command                                      | Description                                                              |
| ------------------- | -------------------------------------------------- | ------------------------------------------------------------------------ |
| Persistent Progress | `w script-binding modernz/progress-toggle`         | Toggle persistent progress bar                                           |
| Show OSC            | `x script-message-to modernz osc-show`             | Show OSC on command without needing to move mouse                        |
| OSC Visibility      | `y script-message-to modernz osc-visibility cycle` | OSC visibility mode. Accepts `never`, `auto`, `always` and `cycle`       |
| Logo on Idle        | `z script-message-to modernz osc-idlescreen cycle` | The visibility of the mpv logo on idle. Accepts `yes`, `no`, and `cycle` |