Skip to content

user guide

Jump to bottom
casey langen edited this page Jul 14, 2017 · 32 revisions

important info

in the section below you will see some references to keys in the following format: M-x. this means you must hold your Meta key down and press the x button. what is the Meta key?

  • in windows ALT is the Meta key
  • on macos you should configure your terminal emulator to treat your left alt key as +Esc (preferred) or Meta. both iTerm and Terminal.app support this functionality.
  • in linux your mileage may vary, and you will may need to consult your docs. in general, however, i've found the left ALT seems to work most of the time.

keyboard shorcuts

the hotkeys listed below can generally be used at any time; however, if an input field is focused some may not work. you can enter command mode by pressing ESC, which will highlight the bottom command bar and accept all hotkeys. command mode may be deactivated by pressing ESC again.

you may also change hotkeys by editing ~/.musikcube/hotkeys.json and restarting the app. a hotkey tester is provided in the settings screen.

  • TAB select next window
  • SHIFT+TAB select previous window
  • ~ switch to console view
  • a switch to library view
  • s switch to settings view
  • i volume up 5%
  • k volume down 5%
  • m toggle volume mute
  • j previous track
  • l next track
  • u back 10 seconds
  • o forward 10 seconds
  • v show / hide visualizer
  • . toggle repeat mode (off/track/list)
  • , (un)shuffle play queue
  • CTRL+p pause/resume (globally)
  • CTRL+x stop (unload streams, free resources)
  • CTRL+d quit

and a couple hotkeys that are specific to the library view:

  • b show browse view
  • n show play queue
  • f show album/artist/genre search
  • t show track search
  • 1 browse by artist
  • 2 browse by album
  • 3 browse by genre
  • 4 browse by album artist
  • 5 browse by playlist
    • M-n create a new empty playlist
    • M-s save the currently selected playlist
    • DEL (BACKSPACE on macos) in the playlists pane: delete the selected playlist
    • M-r rename the selected playlist
    • M-UP (CTRL-UP on macos) move the selected track up
    • M-DOWN (CTRL-DOWN on macos) move the selected track down
    • DEL (BACKSPACE on macos) in the tracks pane: delete the selected track
  • x jump to playing artist/album/genre in browse view
  • M-ENTER show a context menu for the currently selected item (album, artist, genre, track)
  • SPACE pause/resume

you can manipulate the play play queue as follows:

  • M-s save current queue as a playlist
  • M-l load a previously saved playlist
  • M-x delete a previously saved playlist
  • M-r rename a playlist
  • M-UP (CTRL-UP on macos) move the selected track up
  • M-DOWN (CTRL-DOWN on macos) move the selected track down
  • DEL (BACKSPACE on macos) delete the selected track
Clone this wiki locally