Keyboard Setup commands

Started by Harbinger, July 04, 2009, 00:30:45

Previous topic - Next topic

Harbinger

Edit: This list is no longer up-to-date. Visit the Wiki instead.

This page will be part of the Upcoming help manual, but i wanted to post this for reference, and also to get feedback on the descriptions. I will assume the reader has some working experience using MPT before trying to develop his own shortcuts.
There are a couple i'm still not sure about, so if you have some insight, mention it here. I also skipped over the last set of shortcuts for plugins. (i'll get to those later).
Also, there are a couple of allusions to sections elsewhere. Ignore those -- i'll provide links in the manual for those later.

---------------------------------------------------------------------------

These are the descriptions of the keyboard shortcuts that can be customized in MPT.

NOTE: If your keyboard shortcut will not work, check that you did not leave another MPT notice window open (such as the one generated when you verify SFx assignments!). To check this quickly, look in Windows' taskbar (the one with the Start Menu and a listing of all open windows/apps).

Global keys

These keyboard shortcuts will work on all parts of ModPlugTracker, as long as it's the frontmost application.


File/New
Creates a new blank track. If one is already open, it is neither closed nor saved.

File/Open
Shows the dialog to open an existing readable tracking format. If one is already open, it is neither closed nor saved.

File/Close
Closes the current song. If it has not been saved, you are given the opportunity before the file is closed.

File/Save
Saves the file in its current name and format.

File/Save As
Allows you to save the file with a new name or in another folder.

File/Save as Wave
Exports the current track .wav file in the folder you choose. The current track is neither closed nor saved.

File/Save as MP3
Exports the current track .mp3 file in the folder you choose. The current track is neither closed nor saved.

File/Export to Midi
Exports the current track into the .mid format. See the section on MIDI files for a detailed explanation of how this file is exported. The current track is neither closed nor saved.

File/Export to IT/XM
Exports the current track to "pure" .it format, without MPT's .it alterations.

Previous Document
Goes to the previous tracking file that is open, all of which are visible in the Windows Menu.

Next Document
Goes to the next tracking file that is open, all of which are visible in the Windows Menu.

File/Import Midi Lib
Imports the MIDI Instrument Library of your choosing. If the file is valid, it will appear in the Folder Tree in its own heading.

File/Add Sound Bank
Imports a sound bank of your choosing. If the file is valid, it will appear in the Folder Tree in its own heading.

Play song/Pause song
Toggles the playback of the current track. The playback pointer is not reset when using this toggle; that is, it plays from where the pointer left off when it was last pressed.

Pause song
Only stops the playback of the current track but does not reset the playback pointer.

Stop Song
Stops the playback of the current track AND resets the pointer to the beginning of the song.

Play song from start
Resets the playback pointer to the very first event of the track, and begins playback from there.

Play song from cursor
Resets the pointer to the row where the editing cursor is set (even if the selected row is not in the currently displayed pattern), and begins playback from there. Playback will continue until the end of the track.

Play pattern from start
Resets the pointer to the first row of the current pattern (even if you are in a different section of MPT), and begins playback from there. It will stop at the end of the pattern (or loop within the pattern if Loop Pattern is enabled).

Play pattern from cursor
Resets the pointer to the row where the editing cursor is set in the current pattern (even if you are in a different section of MPT), and begins playback from there. It will stop at the end of the pattern (or loop within the pattern if Loop Pattern is enabled).

Estimate Song Length
Estimates the playback length of the entire track.

Show approx. real BPM
Estimates the beats per minute of the song, based on the Initial tempo and the number of ticks per row, plus the Tempo Mode in the Song Properties dialog.

Toggle Midi Record
Toggles the MIDI Record option.

Undo
Rescinds the last edit. Applies to all text and pattern data. However, while there are multiple Undo's for pattern edits, there is only one Undo for text edits (pressing Undo a second time re-applies the edited text). THERE IS NO UNDO FOR EDITS TO SAMPLE DATA.

Cut
Copies the selected data into the clipboard, then removes it from the field it occupies. Applies to text, pattern, and sample data.

Copy
Copies the selected data into the clipboard. Applies to text, pattern, and sample data.

Paste
Pastes the selected data at the location of the cursor, but Paste acts differently on the type of data. With text, clipboard contents are inserted at the point of the cursor, or, if text is already highlighted, replace the selected text. With pattern data, clipboard contents are pasted in the same row at the same column of the current (visible) Pattern where the cursor is located, overwriting any pattern data that falls within the paste area. With sample data, clipboard contents are pasted OVER THE ENTIRE SAMPLE, in essence replacing all of that sample's data with whatever sample data is stored in the clipboard.

Mix Paste
Clipboard contents are pasted in the same row at the same column of the current (visible) pattern where the cursor is located, EXCEPT where there is already any data in any corresponding field of the paste area.

Mix Paste (old IT Style)
Clipboard contents are pasted in the same row at the same column of the current (visible) pattern where the cursor is located, EXCEPT where there is already any pattern data that falls within the paste area. However, the note data is assumed to include the note name, the designated instrument, and the note FX (volume data field), so if any of these contain non-blank data, none of the note data in that row of that channel of the clipboard will be pasted over it. (But channel FX data is tested separately, and will be only pasted if the last column in that channel is blank.)

SelectAll
Selects all text data, pattern data, or sample data, depending on the location of the cursor or current selection.

Find
Opens the Find/Replace dialog, which allows you to search for and/or replace given pattern data. Find starts from the cursor location.

Find Next
Applies the current Find settings and searches for the next data that matches it, selecting the given data; however it does not set the cursor in that row. For Find to be used again, the cursor must be set in the current pattern, then Find Next searches the entire row (in each channel) before going to the next row.

View General
Opens the General Tab.

View Pattern
Opens the Pattern Tab.

View Samples
Opens the Samples Tab.

View Instruments
Opens the Instruments Tab.

View Comments
Opens the Comments Tab.

View Graph
Currently not functional.

Toggle Main View
Shows/hides Main toolbar.

Toggle Tree View
Shows/hides Folder Tree panel.

View Options
Opens the OpenMPT Setup dialog.

View Channel Manager
Opens the Channel Manager table.

View Plugin Manager
Opens the Plugin dialog.

Show song properties window
Opens the Song Properties dialog.

View MIDI Mapping
Opens the MIDI mapping dialog.

Help (to do)
Opens the Offline Help Manual (currently not functional)

Previous instrument
Changes the current instrument to the previous one in order.

Next instrument
Changes the current instrument to the next one in order.

Previous octave
Changes the current octave to the next lower octave.

Next octave
Changes the current octave to the next higher octave.

Previous order
Changes the current pattern to the previous one in the pattern order. If the pattern ID is the same the display will not change.

Next order
Changes the current pattern to the next one in the pattern order. If the pattern ID is the same the display will not change.

Pattern - General Context

These keyboard shortcuts will only work if the cursor focus is within one of the columns of the Pattern Editor, except where noted.

NOTE: When navigating (moving the cursor) to before the first row or after the last row in the pattern, the cursor "wraps" to the other side of the same pattern, if the "Cursor Wrap" option is enabled (in the Options section of the General tab of the MPT Setup dialog). If navigating beyond the first or last row when the "Continuous Scroll" option is enabled, the cursor will instead move to the previous/next pattern in the order list.


Navigate down by 1 row
Moves the cursor to the next row in the same column.

Navigate up by 1 row
Moves the cursor to the previous row in the same column.

Navigate down by spacing
Moves the cursor down (in the same column) by the number in the Row Spacing field.

Navigate up by spacing
Moves the cursor up (in the same column) by the number in the Row Spacing field.

Navigate left
Moves the cursor to the previous column in the same row, going to the previous channel's last column if moving from the first column of the current channel.

Navigate right
Moves the cursor to the next column in the same row, going to the next channel's first column if moving from the last column of the current channel.

Navigate to next channel
Moves the cursor to the same column in the same row in the next channel.

Navigate to previous channel
Moves the cursor to the same column in the same row in the previous channel.

Jump down by measure
Moves the cursor down (in the same column) by the number in the Rows/measure field (of the Song Properties dialog).

Jump up by measure
Moves the cursor up (in the same column) by the number in the Rows/measure field (of the Song Properties dialog).

Jump down by beat
Moves the cursor down (in the same column) by the number in the Rows/beat field (of the Song Properties dialog).

Jump up by beat
Moves the cursor up (in the same column) by the number in the Rows/measure field (of the Song Properties dialog).

Snap down to measure
Moves the cursor down (in the same column) to the first row of the next measure, as determined by the number in the Rows/measure field (of the Song Properties dialog).

Snap up to measure
Moves the cursor up (in the same column) to the first row of the previous measure, as determined by the number in the Rows/measure field (of the Song Properties dialog).

Snap down to beat
Moves the cursor down (in the same column) to the first row of the next beat, as determined by the number in the Rows/beat field (of the Song Properties dialog).

Snap up to beat
Moves the cursor up (in the same column) to the first row of the previous beat, as determined by the number in the Rows/beat field (of the Song Properties dialog).

Go to first channel
Moves the cursor to the first column of the first channel in the same row.

Go to first row
Moves the cursor to the first row of the same channel in the same column.

Go to first row of first channel
Moves the cursor to the first column of the first channel in the first row.

Go to last channel
Moves the cursor to the last column of the last channel in the same row.

Go to last row
Moves the cursor to the last row of the same channel in the same column.

Go to last row of last channel
Moves the cursor to the last column of the last channel in the last row.

Previous pattern
Displays the previous pattern in the order list, moving the cursor to its equivalent position in it.

Next pattern
Displays the next pattern in the order list, moving the cursor to its equivalent position in it.

Selection key
The modifier key to be used to extend the selection when navigating with keyboard shortcuts.

Copy select key
The modifier key to be used to copy the selection when dragging with the mouse.

Select channel / Select all
Toggles the "select all" method, either all events in the current pattern of the current channel where the cursor is located, or all events in the pattern.

Copy and lose selection
Copies the selected events (replacing whatever was in the clipboard) and deleting the selected events from the pattern.

Clear row
Deletes all event data in the same row in the current channel.

Clear field
Deletes only the event data in the same row of the same column in the current channel.

Clear field (IT Style)
Deletes the note and instrument when the cursor is in the note column; note FX and channel FX remain.

Clear row and step
Deletes all event data in the same row in the current channel and moves the cursor by the number of rows in the Row Spacing field.

Clear field and step
Deletes only the event data in the same row of the same column in the current channel and moves the cursor by the number of rows in the Row Spacing field.

Clear field and step (IT Style)
Deletes the note and instrument when the cursor is in the note column (note FX and channel FX remain) and moves the cursor by the number of rows in the Row Spacing field.

Delete rows
Deletes the same number of rows as the selection, affecting the same number of channels where the selection extends; the data is moved up to replace the cleared data, and extra rows are added in the affected channels so that the row number remains the same.

Delete all rows
Deletes all event data in the selected channels

Insert Row
Moves event data in the current and following rows in the selected channel down one row. Event data in the last row of those channels is deleted.

Insert All Rows
Moves event data in the current and following rows in all channels down one row. Event data in the last row of all channels is deleted.

Mute current channel
Toggles the sound output (mute) for the channel where the cursor is located.

Solo current channel
Toggles the sound output (mute) for all channels except the one where the cursor is located.

Unmute all channels
Activates the sound output for all channels, regardless of Mute status.

(Un)mute chan on pat transition
Toggles the sound output (mute) for the channel where the cursor is located, but the change takes place when the current pattern is finished playing.

Transpose +1
Raises by one the note number of the currently selected notes. Only selected note data (first column) is affected.

Transpose -1
Lowers by one the note number of the currently selected notes. Only selected note data (first column) is affected.

Transpose +12
Raises by one the octave number of the currently selected notes. Only selected note data (first column) is affected.

Transpose -12
Lowers by one the octave number of the currently selected notes. Only selected note data (first column) is affected.

Amplify selection
Opens a dialog to change the volume commands (note FX not channel FX) of the selected volume data. Only selected volume data (third column vxx) is affected.

Interpolate note
Transitions smoothly (using all available notes) between notes in the selection, filling in (and replacing if necessary) all rows with new note data. The first and last rows of the selection must contain note data.

Interpolate volume
Transitions smoothly between data amounts in the selection, filling in (and replacing if necessary) all rows with new note FX data. The first and last rows of the selection must contain note FX data, and they must be of the same type (volume, panning, etc). Note FX of different types are not replaced.

Interpolate effect
Transitions smoothly between data amounts in the selection, filling in (and replacing if necessary) all rows with new channel FX data. The first and last rows of the selection must contain channel FX data, and they must be for the same effect (Ixx, Zxx, etc.). Channel FX of different types are not replaced.

Open effect visualizer
Opens the Params Editor dialog.

Open pattern randomizer
Opens the Pattern Randomizer dialog. (available but not functional)

Go to row/channel/...
Opens the Go To dialog dialog.

Apply current instrument
Applies the current instrument to all rows in the selection that contains note data.

Grow selection
"Expands" the selection by doubling the number of the selected rows, and evenly spacing out the event data within it. The expansion will replace event data below it in the same channels as the selection.

Shrink selection
"Shrinks" the selection by deleting every other row of the selection. However, if only part of any row is selected, the data corresponding to the deleted selected data is also deleted.

Toggle follow song
Toggles the "Follow Song" function.

Quick copy
Copies only one field of data (where the cursor is located) to MPT's "Quick" clipboard; the standard clipboard is not erased. Each column has its own Quick clipboard.

Quick paste
Pastes the data in MPT's "Quick" clipboard to the location of the cursor. The data last saved in that column's clipboard will be pasted in the cursor's corresponding column.

Enable recording
Toggles the Event Record feature. When enabled, patterns may be edited.

Play row
Process and play only the events in the current row where the cursor is located.

Set row jump on note entry
The modifier key(s) that, when pressed with digits 0-8, will allow you to change the Row Spacing amount without using the mouse or moving the cursor focus out of the editor.

Switch to order list
Toggles the cursor focus between the pattern editor and the current pattern in the Pattern Order list.

Insert new pattern
Inserts a new blank pattern after the current pattern, displays it, and moves the cursor to the same position in it. Also functions when cursor focus is in the Order list.

Toggle channel's plugin editor
Opens the Plugin Manager dialog.

Show note properties
Opens the Note Properties dialog, where you can assign any event data to the current row of the current channel.

Show pattern properties window
Opens the Pattern Properties dialog.

Show macro configuration
Opens the Macro Setup dialog.

Toggle loop pattern
Toggles the Loop Pattern feature.

Show context (right-click) menu
Opens the context menu at the cursor location without using the mouse.

Show playback time at current row
Shows the estimated time within the track at the start of the current row.


Pattern – Note Column

These shortcuts will be recognized as note entries when the pattern editor has focus and the cursor is in the note column (the first column).

Base octave [note]
Enters a note in the octave indicated in the Octave field

Base octave +1 [note]
Enters a note in the next higher octave indicated in the Octave field

Base octave +2 [note]
Enters a note two octaves higher than the one indicated in the Octave field

Set octave [0 – 9]
Modifies the octave range of all selected notes.

Chord Modifier

Note cut
Enters a note cut command ( ^ ^ ) and applies the current instrument (replacing it if necessary)

Note off
Enters a note off command ( = = ) and applies the current instrument (replacing it if necessary)

Note cut (don't remember instrument)
Enters a note cut command ( ^ ^ ), leaving the instrument field blank

Note off (don't remember instrument)
Enters a note off command ( = = ), leaving the instrument field blank


Pattern Editor – Instrument Column

These shortcut keys will be activated only when the pattern editor has focus and the cursor is in the instrument column (the second column).

Some users may wish to assign certain number keys to other functions (e.g. '8' to 'Play Row'), so making the numbers fully customizable helps manage this case. Note that MPT distinguishes between standard number keys and "numpad" keys.

Set instrument digit [0 -9]
Enters the digit into the rightmost place in the instrument field, moving the existing digit to the leftmost place.

Pattern Editor – Channel Effect Column

These work when the pattern editor has focus and the cursor is in the Channel FX column (the prefix of the fourth column). MPT distinguishes between standard number keys and "numpad" keys. Currently only some of the newer effects introduced in MPT are customizable.

FX MIDI macro slide
Enters the symbol for Macro slide between parameters (see the section on Macros for details)

FX pseudo-velocity (experimental)

FX parameter extension command

Pattern Editor – Effect Param

These work when the pattern editor has focus and the cursor is in the Channel FX parameter column (the last 2 places of the last column in the channel). MPT distinguishes between standard number keys and "numpad" keys.

Remember that unlike the other numeric columns, the Channel FX column is in hexadecimal, where counting is done from 0 to 15, with the letters A – F representing the numbers 10 – 15.

FX Param digit [0 -9]
Enters the digit into the rightmost place in the parameter field, moving the existing digit to the leftmost place.

FX Param digit [A – F]
Enters the letter into the rightmost place in the instrument field, moving the existing digit to the leftmost place.


Sample Editor

These shortcuts are recognized when the Samples Tab is visible. REMEMBER THAT THERE IS NO UNDO FOR SAMPLE EDITS.

Trim sample around loop points
If loop points are specified, all sample data outside of these start/end times are deleted

Silence sample selection
All of the sample data within the selected area is set to zero, effectively placing silence in that span.

Normalise Sample

Amplify Sample
Opens the Amplify dialog, allowing you to alter the volume of the sample and apply Fade In or Fade Out (from silence).

Reverse sample
Puts the selected sample data in reverse order, causing it to sound like it's being played backwards.

Delete sample selection
Deletes the sample data within the selection, moving the remaining data together.

Zoom Out
Decreases the data-to-display ratio, effectively zooming out to show less graphic detail of the sample data. The values "wrap" so when you Zoom Out to the lowest ratio, using the command again goes to the highest ratio.

Zoom In
Increases the data-to-display ratio, effectively zooming in to show more graphic detail of the sample data. The values "wrap" so when you Zoom In to the highest ratio, using the command again goes to the lowest ratio.

Load a Sample
Opens the Open File dialog to allow you to import a .wav file into the sample slot. (This command also works in the Instrument Tab, importing an instrument to the next Instrument slot.)

Save Sample
Opens the Save File dialog to allow you to save the .wav file into a folder of your choice. (This command also works in the Instrument Tab, saving the Instrument and its accompanying samples as an .iti file.)

New Sample
Creates a blank sample in the next unused slot. (This command also works in the Instrument Tab.)

Sam_Zen

Once again, a very nice job, Harbinger !
0.618033988

Saga Musix

This needs a little update.
General: Toggle overflow paste
Notes: Param Control, Param Control (Smooth), Note Fade, Note Fade (don't remember instrument)
Sample Editor: Remove DC Offset
» No support, bug reports, feature requests via private messages - they will not be answered. Use the forums and the issue tracker so that everyone can benefit from your post.

Saga Musix

Another one that's missing: Reset channel in pattern context.

EDIT: Even the commands from the .53 release are missing: Unsign sample, invert sample phase.
» No support, bug reports, feature requests via private messages - they will not be answered. Use the forums and the issue tracker so that everyone can benefit from your post.

Harbinger

I'll get to it eventually...