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, Ctrl, and Alt each have a consistent meaning across the application, whether combined with a key or a mouse action:

Modifier General meaning Examples
Shift Extend a selection, or a secondary variant of the plain action Shift+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)
Ctrl The primary command modifier, an alternate action, or multi-selection Ctrl+C / Ctrl+V for copy/paste; Ctrl+double-click on a song slot plays that slot's pattern instead of the song; Ctrl+click in the sample list adds to the selection; Ctrl+click on a channel's mute button or oscilloscope solos that channel; Ctrl+Shift+Left-click / Ctrl+Shift+Right-click on a song slot sets the start / end of the temp loop range
Alt An alternate action, usually tied to values or channels Alt+Z / Alt+X / Alt+C mute channels A/B/C and Alt+Shift+Z / Alt+Shift+X / Alt+Shift+C solo them; Alt+Up / Alt+Down transpose the selection by a semitone; Alt+wheel over a value field adjusts that value; Alt+drag on a song slot defines a temp loop range in one gesture

Modifiers combine predictably: adding Shift to an Alt value adjustment takes bigger steps (Alt+Shift+wheel), adding Shift to a navigation key extends the selection, and adding Ctrl swaps in a related action, such as Alt+Ctrl+Up / Alt+Ctrl+Down transposing by an octave instead of a semitone.

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
Ctrl+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
Alt+wheel over a value cell Increments or decrements the value under the pointer
Alt+Shift+wheel over a value cell Increments or decrements the value in larger steps
Ctrl+wheel over a waveform graph Zooms the instrument or sample waveform, centered at the pointer
Shift+wheel over a waveform graph Pans a zoomed waveform
Ctrl+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 Up and Down 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
Ctrl+click / Shift+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; Ctrl+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; Ctrl+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 Ctrl+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; Ctrl+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 Alt+drag for a temp loop range in the song editor, are described in their own chapters.