Keyboard Shortcuts
Every app bundled with your Media Server can be driven from the keyboard. Shortcuts are grouped into named sets, and your sets are stored against your local account on that Media Server, so your shortcuts follow you into every Cardinal app it hosts, on every device you sign in from.
Opening the Shortcuts Settings
Open Settings from the account menu in the app header, then choose Keyboard Shortcuts. The default shortcut for opening Settings is Cmd/Ctrl + ,.
Built-in Shortcuts
These are the shortcuts in the Default set.
| Shortcut | Action |
|---|---|
Cmd/Ctrl + , | Open settings |
Cmd/Ctrl + B | Collapse or expand the navigation sidebar |
Cmd/Ctrl + / | Open or close the playback sidebar |
Cmd/Ctrl + P | Play or pause |
Cmd/Ctrl + Left arrow | Previous track |
Cmd/Ctrl + Right arrow | Next track |
Cmd/Ctrl + Shift + M | Mute or unmute |
Cmd/Ctrl + Up arrow | Volume up |
Cmd/Ctrl + Down arrow | Volume down |
The playback shortcuts act on the audio you are currently listening to. They do nothing in an app that is not playing anything.
How Shortcuts Are Written
Cmd/Ctrl means the Command key on macOS and the Control key everywhere else. A shortcut is stored once and resolves to whichever of the two applies on the machine you are using, so the same set works across your devices. Holding Control deliberately on a Mac is a different shortcut.
Keys are matched by their position on the keyboard rather than by the character they produce. On a non-QWERTY layout, a shortcut is fired by the key sitting where that key would be on a QWERTY keyboard.
Changing a Shortcut
Click the keys of any shortcut, then press the combination you want. It saves as soon as you press a key that is not a modifier, which lets you build a combination up one key at a time.
Press Escape or click elsewhere to leave the shortcut as it was.
Adding and Removing Shortcuts
Add shortcut creates a shortcut and immediately waits for you to press its keys. A shortcut with no keys cannot be saved, so leaving without pressing anything discards it.
The ✕ at the end of a row removes that shortcut.
An action can have more than one shortcut assigned to it. Add a second shortcut and choose the same action to give it an alternative combination.
Shortcut Sets
Shortcuts are grouped into named sets, and one set is active at a time. This works the same way as saved themes.
The Default Set
Your Media Server ships with a set called Default. It cannot be edited, and it is not stored on your account, so it is always available to return to. The first change you make while Default is selected creates a copy of it to hold that change, leaving Default itself untouched.
Selecting Default again restores the shipped shortcuts, however much you have changed or deleted.
Creating a Set
Duplicate copies the active set into a new one and selects it. Editing the Default set does the same thing automatically.
Renaming, Resetting and Deleting
Sets you created can be renamed, and Reset to defaults returns a set's shortcuts to the shipped ones without affecting its name. Delete removes a set and selects Default. None of these apply to Default itself.
Where Sets Are Stored
Sets are stored against your local account on your Media Server rather than in your browser, so they are shared by every Cardinal app that server hosts, on every device you sign in from. Signing in with a Cardinal Account is no different, since your sets attach to your account on that server.
Sets belong to the Media Server that holds them. If you sign into a second Media Server, even with the same Cardinal Account, you get the sets stored there.
Single-Key Shortcuts
Turning on Use single-key shortcuts without a modifier key lets shortcuts fire from a single keypress.
It applies only to shortcuts whose sole modifier is Cmd or Ctrl. Cmd/Ctrl + / becomes /, while Cmd/Ctrl + Shift + M is unchanged because it carries a second modifier.
The setting changes only which keys are listened for. Your shortcuts are stored as you assigned them, and turning it back off restores them.
Conflicting Shortcuts
Assigning one combination to two actions marks both rows with a warning. The shortcut still works, but only the first of the two actions will fire.
Single-key shortcuts can create a conflict that was not there before, since dropping Cmd or Ctrl can make two shortcuts identical. These are marked the same way.
Shortcuts Claimed by the Browser or Operating System
Cardinal takes a shortcut before the browser acts on it, so combinations the browser normally uses, such as Cmd/Ctrl + P for printing, run the Cardinal action instead.
Shortcuts claimed by the operating system or by the browser itself cannot be intercepted by any web page. On macOS, Cmd + , may open your browser's own preferences, and Cmd + M minimises the window. If a shortcut never reaches Cardinal, assign a different combination.
Was this article helpful?