Luma Help
DE EN

Using Luma for Mac: window, menu bar, shortcuts

Mac & Luma Transfer, updated

Luma for Mac is built for mouse and keyboard: a sidebar, search at the top of the window, the queue as its own column and almost every command in the menu bar as well.

The window

Since Luma for Mac 1.2, you can do a lot right in the sidebar:

Dynamic playlists have their own section above the other playlists. To show all of them in one list, turn off Separate dynamic playlists under Settings › General. Right-click also lets you show or hide entries in the sidebar.

Search and select

The search field at the top (⌘F) finds songs, albums, artists and playlists at once. On an album or playlist page, the matching songs from that page come first.

Double-click a song to play it. Hold ⌘ or ⇧ to select several songs. A bar then appears with Play Next, Add to Playlist and Like. A right-click opens a menu for the whole selection, and Esc clears it.

Since Luma for Mac 1.1, ⌃⌥Space opens a search field over any app, even while Luma is in the background. Like the search field in the window, it finds songs, artists, albums and playlists.

Esc or a click outside closes the field. You change the shortcut under Settings › Playback › Quick Search: click the shortcut and press the new combination, together with ⌘, ⌥ or ⌃. If another app already uses it, Luma tells you there. The Quick search with a shortcut switch turns the feature off entirely.

The Luma icon in the menu bar shows what’s playing and what’s up next, without opening the window. Click the cover or title to bring Luma to the front. Since version 1.1 the menu bar player has a volume control of its own, and a click on the speaker icon mutes.

The Dock menu

Right-click the Luma icon in the Dock to control playback without opening the window: Play or Pause, Next Track and Previous Track, like the playing song, Shuffle and Repeat.

Media keys

macOS sends the play, next and previous keys to whichever app played something last, such as a browser tab with a video. With Settings › Playback › Always send media keys to Luma, the keys always control Luma as long as a track is loaded there.

Permission

This needs Luma to be allowed under System Settings › Privacy & Security › Accessibility. If it isn’t, Luma shows a button in its settings that takes you right there. If the permission doesn’t take effect immediately, restart Luma once.

Equalizer and sound

The equalizer has its own window: Playback › Equalizer… (⌥⌘E). Ten bands from 32 Hz to 16 kHz, presets such as Bass Boost, Treble, Vocal and Loudness, and a double-click sets a band back to 0 dB. Cross-fade and volume normalization are under Settings › Playback. How it all sounds is explained in Sound, equalizer & cross-fade.

Edit info

Right-click a song or album › Edit Info. ⇥ moves through the fields, ↩ saves, Esc cancels. To change a cover, simply drag an image from the Finder onto it. Luma suggests artists, album artists and genres from your library.

Discord status

With Settings › Playback › Show status in Discord, your friends on Discord see what you’re listening to. Hide title shows just “Listening to Luma”. For this, Luma only talks to the Discord app on your Mac and uploads nothing. It’s off by default.

Settings

Luma › Settings… (⌘,) opens a window of its own with four sections:

SectionWhat you set there
GeneralWhat opens at launch, custom home, sidebar entries, dynamic playlists separate or in one list, collections
PlaybackCross-fade, media keys, Discord status, words that shuffle skips, volume normalization, equalizer, quick search, Technical Details
AppearanceDock icon, appearance (system, light or dark), artists under titles, rounded or square covers, small or large cover in the mini player
LibraryMusic folders, rescan, overview, Luma Transfer, backup, export library

Every keyboard shortcut

ShortcutCommand
⌘OAdd music folder
⌘RRescan library
⌘FSearch library
⌃⌥SpaceQuick search from anywhere, even while Luma is in the background (can be changed)
⌘→ / ⌘←Next / previous track
⇧⌘→ / ⇧⌘←Skip forward / back 15 seconds
⇧⌘SShuffle on or off
⌥⌘EEqualizer
⌥⌘QShow or hide the queue
⌘1 to ⌘4Library, Search, Playlists, Statistics
⇧⌘IImport data (playlists, collections, likes, stats)
⇧⌘EExport data
⌘,Settings

Still have a question or found a mistake? Email hello@suenavus.com.