Skip to content

Keyboard & Mouse Input

The chapters on each editor describe its own shortcuts and mouse actions; this page collects the conventions that apply everywhere: what the modifier keys mean, how the mouse wheel behaves, and what a click, double-click or drag does.

Looking for a specific shortcut?

This page explains how input works in general. For a complete, searchable list of every keyboard shortcut, see the 19. Keyboard Shortcut Reference.

Prefer a quick reference?

Help > Input Guide opens a short guide that condenses this page and the pattern and instrument editor chapters into a few pages.

Shortcuts the browser keeps

A few shortcuts that browsers keep for themselves, such as the ones that open a new window or close the tab, may reach the browser rather than RhYMe; use the menus for those.

Two Ways to Work

Shortcuts depend on focus: the note keys enter notes when the pattern grid has focus but preview the instrument when the instrument editor has focus. Tooltips on toolbar buttons and menu items show each action's shortcut, so you learn them as you go.

Modifier Key Conventions

Shift (⇧), Command (⌘), Option (⌥) and Control (⌃) each have a consistent meaning across the application, whether combined with a key or a mouse action. Command does what Ctrl does on Windows and Linux, and Option what Alt does there, with the few exceptions the table names:

Modifier General meaning Examples
Shift (⇧) Extend a selection, or a secondary variant of the plain action ⇧click extends a selection to the clicked item; Shift with an arrow key extends the selection; Shift + Note Key flips the Auto-instrument toggle for that note (legato entry when the toggle is on); ⇧⌘↑ / ⇧⌘↓ transpose the selection by an octave
Command (⌘) The primary command modifier, an alternate action, or multi-selection ⌘C / ⌘V for copy/paste; ⌘double-click on a song slot plays that slot's pattern instead of the song; ⌘click in the sample list adds to the selection; ⌘click on a channel's mute button or oscilloscope solos that channel; ⇧⌘Left-click / ⇧⌘Right-click on a song slot sets the start / end of the temp loop range; ⌘↑ / ⌘↓ transpose the selection by a semitone, where Windows and Linux use Alt
Option (⌥) An alternate action, usually tied to values or channels ⌥Z / ⌥X / ⌥C mute channels A/B/C and ⌥⇧Z / ⌥⇧X / ⌥⇧C solo them; ⌥wheel over a value field adjusts that value; ⌥drag on a song slot drops a copy of it, as in the Finder. In a text field, Option with a letter, digit or symbol types the character it stands for (such as µ, € or ñ) instead of running a shortcut, and pressing Option on its own never opens the menu bar
Control (⌃) A few shortcuts whose Command version macOS keeps for itself, and the Insert key, which no Mac keyboard has ⌃, / ⌃. move to the previous/next song position, since macOS keeps ⌘, for an application's settings; ⌃⇥ / ⌃⇧⇥ move the focus to the next/previous control; ⌃` focuses the song editor; ⌃O does what Insert does on Windows and Linux, with ⌃⇧O and ⌃⌘O for Shift+Insert and Ctrl+Insert

In a list (the instruments, samples, wavetables, arpeggios and vibratos, the playlist and the song editor), the delete key ⌫ and ⌘⌫ delete the selected item, as Forward Delete (Fn⌫) does.

A few other shortcuts are on different keys than on Windows and Linux. macOS uses the Command version of two of them for something else: Replace Instrument is ⌥⌘F, since ⌘H hides RhYMe, Play Song ignoring the temporary loop is ⌥F5, since ⌘F5 turns VoiceOver on or off, and Play Pattern is ⌥Space, since ⌘Space opens Spotlight and ⌃Space switches the keyboard layout once more than one is set up. On a Mac ⌘↑ / ⌘↓ and ⇧⌘↑ / ⇧⌘↓ transpose, so Scroll Pattern View is ⌥⌘↑ / ⌥⌘↓ and Louder / Quieter is ⌥↑ / ⌥↓.

Modifiers combine predictably: adding Shift to an Option value adjustment takes bigger steps (⌥⇧wheel), adding Shift to a navigation key extends the selection, and adding Command swaps in a related action, such as ⌘double-click on a song slot playing the pattern instead of the song. The octave transpose, ⇧⌘↑ / ⇧⌘↓, adds Shift rather than Control, since macOS keeps ⌃↑ and ⌃↓ for itself.

Mouse Wheel Conventions

The mouse wheel behaves differently depending on where the pointer is and which modifier, if any, is held:

Wheel action Effect
Plain wheel over a grid Scrolls the pattern grid, instrument step grid, or a value table (arpeggio/vibrato) by a fixed number of rows per notch
Plain wheel over the pattern grid with Move Cursor with Wheel enabled Moves the cursor instead of scrolling the view, auto-scrolling to keep the cursor near the middle of the visible area
⌘wheel over a grid Changes that grid's font size (each grid remembers its own). The Reset Zoom button beside the grid's zoom buttons puts it back to the default
⌥wheel over a value cell Increments or decrements the value under the pointer
⌥⇧wheel over a value cell Increments or decrements the value in larger steps
⌘wheel over a waveform graph Zooms the instrument or sample waveform, centered at the pointer
⇧wheel over a waveform graph Pans a zoomed waveform
⌘wheel over the instrument's step graphs Changes the height of the graph rows
Wheel over a number stepper that has the keyboard Steps the value, as ↑ and ↓ do in it

Move Cursor with Wheel is a toggle in the pattern editor toolbar's View Options menu, remembered between sessions (see 6. Pattern Toolbar). It affects the pattern grid only.

How far one notch moves the pattern grid is set by Wheel scroll (rows) in General Settings, four rows unless you change it. The step grid and the value tables move one row per notch.

Click, Double-Click, and Drag Conventions

Action Typical effect
Left-click Selects an item and moves the cursor or selection to it
Hover a pattern cell Shows a tooltip: the instrument's name over a note or instrument cell, the effect's name, syntax and an explanation of the syntax over an effect cell
Hover a shortened name Shows the whole name in a tooltip where it ends in an ellipsis, for example in a list, a drop-down or the song's title. A name shown in full has no tooltip that repeats it
Click and drag Extends a selection over a range of cells, rows, or list items, or reorders items (song editor slots, the instrument, arpeggio, vibrato, sample and wavetable lists, the songs of a playlist, and the values of an arpeggio or vibrato table, dragged by their numbers)
Double-click Context-dependent — see below
Right-click Opens a context menu with actions relevant to what was clicked
⌘click / ⇧click in a list Adds to or extends a multi-selection (for example in the sample list)

Double-click mostly means "play the thing this item represents right now", and where there is nothing to play it opens the item for editing:

  • Song slot — double-clicking a slot in the song editor starts song playback from that slot; ⌘double-click starts pattern playback of that slot instead. See 7. Navigation and Editing
  • Event strip — clicking the strip under the song slots selects the pattern under the pointer, or plays from its start while the song plays; ⌘click moves the cursor to that spot, or playback while the song plays; double-clicking plays the song from the start of the pattern under the pointer, and ⌘double-click from that exact spot
  • Playlist song — double-clicking a song in a playlist plays it without opening it
  • Instrument, arpeggio, vibrato, or sample list item — double-clicking plays a preview of the selected item
  • Sample waveform — double-clicking the waveform graph plays the sample
  • Note in the pattern grid — double-clicking a note plays it with the instrument and volume in force at its row
  • Instrument number in the pattern grid — double-clicking it makes that instrument the current one and shows it in the instrument editor
  • Effect in the pattern grid — double-clicking an effect that sets an amount, such as a volume, opens the curve editor on it across the track
  • Instrument waveform step — double-clicking a stretch of the wave preview previews the one step you clicked in, on its own rather than the whole instrument; ⌘double-click repeats that step until you stop the preview
  • Instrument step grid and step graphs — double-clicking a cell that offers a list of values opens that list, and double-clicking a cell containing an amount, or a row of the step graphs, opens the curve editor on that value across the steps
  • Splitter beside the pattern editor — double-clicking it makes the pattern editor exactly as wide as the pattern grid, as far as the window allows. See Three-Column Layout

Dragging inside a grid or list extends a selection; dragging an item to another position (a song slot, an unused pattern, a sample) moves or inserts it there. Special drags, such as ⌥⌘drag for a temp loop range in the song editor, are described in their own chapters.