# Transpose

Tools ▸ Transpose… moves notes up or down by a semitone or an octave. Its four
buttons apply straight away, so two semitones is two presses of SEMITONE UP,
and the window can stay open beside the pattern while you work.

The dialog follows MED's own: a scope, an instrument filter, the four amounts,
and a choice for notes that fall out of range. MED's shortcut for it, Ctrl+T,
opens a new tab in a browser, so the menu shows none. OctaMED's Transpose
window also has Change Notes and Change Instrument panels; in Mediante that job
is [Find & Replace](find-replace.md).

## Affect

- **Marked range (or the cursor cell)**: the range when one is marked,
  otherwise just the cell under the cursor.
- **Current track**: the cursor's track, from the top of the block to the
  bottom.
- **Current block**: every track of the block you are on.
- **Whole song — every block**: every block in the song.

The line under the buttons says what the next press will act on.

## Instruments

Every note, or only the notes played with the current instrument, the one
selected for entry.

## Out-of-range notes

A note is out of range when the pitch you would hear, the note plus its
instrument's own transpose, would leave the range MED can play. So a note can
sit high in the grid and still be in range if its instrument transposes it
down. MED's help says the same: transpose works within the range of notes the
instruments can play.

- **Change octave** folds the note back by whole octaves until it is in range,
  so it keeps its pitch class.
- **Leave unchanged** leaves the note where it was.
- **Delete** removes the note and its instrument number. The cell's command
  stays.

Only real notes move. Hold symbols and the special notes (DEF, 11k, 22k, 44k
and STP) are left alone. The status bar reports how many notes moved, and how
many were deleted or left unchanged.

## The buttons, and undo

OCTAVE UP and OCTAVE DOWN move by 12 semitones, SEMITONE UP and SEMITONE DOWN
by one.

Every press is one undo step, except a whole-song transpose, which takes one
step for each block it changed; the status bar says how many.

The same four steps are on the keyboard, **Ctrl+Shift+↑ / ↓** for a semitone
and with **Alt** added for an octave, and on the pattern's right-click menu.
Those always act on the marked range or the cursor cell, on every instrument,
and leave out-of-range notes unchanged.