ModernZ Controls Guide

April 17, 2026 ยท View on GitHub

modernz-buttons

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

ActionFunction
Left mouse clickShow current track details
Right mouse clickShow menu with watch history

Seekbar

ActionFunction
Left mouse clickSeek to position (using keyframes)
Middle mouse clickSeek to the exact position
Shift+left mouse clickSeek to the exact position
Right mouse clickSeek to the head of chosen chapter
Scroll wheelSeek forward/backwards

Time Codes

ActionFunction
Left mouse clickDisplay remaining time instead of current time
Right mouse clickDisplay time in milliseconds

Play/Pause

ActionFunction
Left mouse clickToggle play/pause
Right mouse clickToggle enable/disable file loop
Middle mouse clickToggle enable/disable playlist loop
Shift+left mouse clickToggle enable/disable playlist loop

Track Back/Forward

ActionFunction
Left mouse clickPlay previous/next file
Right mouse clickShow a playlist menu
Shift+left mouse clickShow a simple playlist
Middle mouse clickShow a simple playlist

Skip Chapter Back/Forward

ActionFunction
Left mouse clickGo to previous/next chapter
Right mouse clickShow an interactive chapters list
Shift+left mouse clickShow a simple chapters list

Jump Back/Forward

ActionFunction
Left mouse clickJumps forwards/backwards by 10 seconds (or by user_opts jumpamount)
Right mouse clickJumps forwards/backwards by 1 minute
Shift+left mouse clickSkips to the previous/next frame (and pauses)
Middle mouse clickSkips to the previous/next frame (and pauses)

Audio/Subtitle

ActionFunction
Left mouse clickShow an interactive tracks list
Right mouse clickCycle audio/subtitle track
Shift+left mouse clickCycle audio/subtitle track down
Scroll wheelCycle audio/subtitle tracks up/down

Playlist

ActionFunction
Left mouse clickShow an interactive playlist
Right mouse clickShow an interactive menu

Volume

ActionFunction
Left mouse clickToggle mute on/off
Right mouse clickShow audio device select menu
Scroll wheelChange volume up/down

Statistics

ActionFunction
Left mouse clickDisplay statistics of current file

Screenshot

ActionFunction
Left mouse clickTake a screenshot

Pin

ActionFunction
Left mouse clickToggle ontop

Loop

ActionFunction
Left mouse clickToggle current file loop on/off
Right mouse clickToggle playlist loop on/off

Shuffle

ActionFunction
Left mouse clickToggle playlist shuffle on/off

Speed

ActionFunction
Left mouse clickIncrease playing speed by increments of 1
Right mouse clickReset playing speed to normal
Scroll wheelInc/decrease playing speed by 0.25

Download

ActionFunction
Left mouse clickDownload the current video/image URL

Cache

ActionFunction
Left mouse clickDisplay cache information of current file