Media Control Mode

Media Control Mode gathers available media sessions into one panel. Use keyboard hints to control music, videos, and other media without switching to each player.

Note

Media controls require an unlocked Cursor Crane license or an active trial. While locked, the panel still shows media and playback progress, but keyboard and mouse controls are unavailable. Press Esc to close the panel.

Enter Media Control Mode

In Settings, open Media Control Mode and assign a command sequence or a dedicated keyboard shortcut to command.enterMediaControlMode. Trigger the command sequence from Command Mode, or use the shortcut to open the panel.

The panel shows the media title, artist or app name, artwork, and playback progress when the player provides them. If no media appears, start playback in an app that exposes its media session to macOS, then open the panel again.

Control Playback

Each available action has a hint. Type the hint shown beside the action to perform it for that media session. You can also click the controls.

Action	Behavior
Activate application	Bring the player app to the front and close Media Control Mode.
Previous / Next	Ask the player to switch to the previous or next track.
Play / Pause	Toggle playback.
Rewind / Forward	Move backward or forward by 15 seconds. Hold Option while triggering the action to move by 1 second.
Playback position	Open an input field to jump to a specific time or percentage.

Available media and supported actions depend on the player. For live media or media with an unknown duration, seeking and skipping by time are unavailable.

Jump to a Playback Position

Type the hint beside the playback position to edit it. The field initially contains the current position. Replace it with one of these formats:

Input	Position
90	90 seconds
12:12	12 minutes and 12 seconds
1:02:03	1 hour, 2 minutes, and 3 seconds
20% or .2	20% of the media duration

Time components can also be separated by punctuation or spaces, such as 12.12 or 12 12. The requested position must be within the media duration.

Press Enter to confirm, or Esc to cancel editing.

Navigate and Close the Panel

Input	Action
Down / Page Down	Show the next page of media sessions.
Up / Page Up	Show the previous page.
Delete	Remove the last character of a partially typed hint.
Esc	Cancel position editing, clear a partial hint, or close the panel when neither is active.

Settings

The Media Control Mode settings page contains the mode introduction and the command sequence and keyboard shortcut for entering the mode. It currently has no additional mode-specific settings.

Related Commands

CommandIdentifier	Action
command.enterMediaControlMode	Enter Media Control Mode.