Editing Keyboard Shortcuts

<sup>''!!! Work in progress, not ready for prime time, do not link from other pages yet !!!''</sup>

Not all PICO-8 hardware has a keyboard, but when it does, there are many keyboard shortcuts that one can use. Known shortcuts are listed here.

----

:'''Important:''' the lists below all start with the shortcuts for a '''QWERTY''' keyboard layout on a '''Windows''' build of PICO-8. Key bindings for other keyboard layouts or platform builds are only listed if they are known to be ''different'' from the Windows Build. 

:If your key isn't listed, or doesn't work right, try to use the Windows-style shortcut the way you would usually expect one to be done in your own OS. For instance, if you know Undo is Ctrl-Z on Windows, you'd want to try Cmd-Z on MacOS. Certain MacOS functions, but not all, permit the use of either the Ctrl or Cmd keys interchangeably. For instance, both Ctrl+C and Cmd+C will copy text on MacOS. As such, certain functions may have multiple redundant shortcuts listed under the MacOS column. As these are functionally equivalent, you can choose whichever shortcut works best for your workflow and/or preference.

:Also, if you are on a different regional layout, such as AZERTY or QWERTZ, try using the key that would be in the same ''physical'' position as the QWERTY key. And remember, there is a [[Keyconfig|<code>keyconfig</code>]] command you can use to change in-game button assignments.

:'''Readers with knowledge of other platforms are encouraged to fill in the blanks if they know of keys that differ from the Windows layout.''' Don't worry too much about following the tricky formatting in these tables, unless you want to. Feel free to just enter whatever helpful notes you have, even if they aren't put into the tables. Someone else can do the formatting later if needed. Thanks!

----

<!-- handy chars: ⌘Cmd ⇧Shift ⌥Opt ⌃↩⌤⌫⌦⌧⇥⇤␣⎋⇪⏏⇞⇟↖↘←→↑↓ -->
==Global use==

{| class="article-table" style="width: 100%;"
!scope="col" style="width: 34%;"|Function
!scope="col" style="width: 22%;"|Windows
!scope="col" style="width: 22%;"|Linux
!scope="col" style="width: 22%;"|MacOS
|-
|<u>Q</u>uit
|<kbd>Alt</kbd>+<kbd>F4</kbd>
|<kbd>Ctrl</kbd>+<kbd>Q</kbd>
|<kbd>⌘Cmd</kbd>+<kbd>Q</kbd>
|-
|<u>R</u>eload/<u>R</u>un/<u>R</u>estart
|<kbd>Ctrl</kbd>+<kbd>R</kbd>
|<kbd>Ctrl</kbd>+<kbd>R</kbd>
|<kbd>⌘Cmd</kbd>+<kbd>R</kbd>
|-
|Quick-<u>S</u>ave
|<kbd>Ctrl</kbd>+<kbd>S</kbd>
|<kbd>Ctrl</kbd>+<kbd>S</kbd>
|<kbd>⌘Cmd</kbd>+<kbd>S</kbd>
|-
|<u>M</u>ute/un<u>m</u>ute
|<kbd>Ctrl</kbd>+<kbd>M</kbd>
|<kbd>Ctrl</kbd>+<kbd>M</kbd>
|<kbd>^Ctrl</kbd>+<kbd>M</kbd>
|-
|Editor toggle
|<kbd>Esc</kbd>
|<kbd>Esc</kbd>
|<kbd>Esc</kbd>
|-
|Full screen toggle
|<kbd>Alt</kbd>+<kbd>Enter</kbd>
|<kbd>Alt</kbd>+<kbd>Enter</kbd>
|<kbd>⌘Cmd</kbd>+<kbd>F</kbd>
|-
|Save a screenshot to desktop
|<kbd>F1</kbd> / <kbd>F6</kbd><br /><kbd>Ctrl</kbd>+<kbd>6</kbd>
|
|<kbd>^Ctrl</kbd>+<kbd>6</kbd>
|-
|Capture cartridge label image
|<kbd>F2</kbd> / <kbd>F7</kbd><br /><kbd>Ctrl</kbd>+<kbd>7</kbd>
|
|<kbd>^Ctrl</kbd>+<kbd>7</kbd>
|-
|Start recording a video
|<kbd>F3</kbd> / <kbd>F8</kbd><br /><kbd>Ctrl</kbd>+<kbd>8</kbd>
|
|<kbd>^Ctrl</kbd>+<kbd>8</kbd>
|-
|Save GIF video to desktop
|<kbd>F4</kbd> / <kbd>F9</kbd><br /><kbd>Ctrl</kbd>+<kbd>9</kbd>
|
|<kbd>^Ctrl</kbd>+<kbd>9</kbd>
|-
|Toggle keyboard cursor
|<kbd>F5</kbd> / <kbd>F10</kbd><br /><kbd>Ctrl</kbd>+<kbd>0</kbd>
|
|<kbd>^Ctrl</kbd>+<kbd>0</kbd>
|-
|Toggle FPS display
|<kbd>Ctrl</kbd>+<kbd>1</kbd>
|
|<kbd>^Ctrl</kbd>+<kbd>1</kbd>
|-
|Previous editor
|<kbd>Alt</kbd>+<kbd>←</kbd>
|<kbd>Alt</kbd>+<kbd>←</kbd>
|<kbd>⌥Alt</kbd>+<kbd>←</kbd>
|-
|Next editor
|<kbd>Alt</kbd>+<kbd>→</kbd>
|<kbd>Alt</kbd>+<kbd>→</kbd>
|<kbd>⌥Alt</kbd>+<kbd>→</kbd>
|}

==While running==

{| class="article-table" style="width: 100%;"
! scope="col" style="width: 34%;" |Function
! scope="col" style="width: 22%;" |Windows
! scope="col" style="width: 22%;" |Linux
! scope="col" style="width: 22%;" |MacOS
|-
|<u>P</u>ause menu
|<kbd>P</kbd> / <kbd>Enter</kbd>
|
|
|-
|<u>P</u>erformance Monitor
|<kbd>Ctrl</kbd>+<kbd>P</kbd>
|
|
|} 

See [[Btn|<code>btn()</code>]] for details on default controller/keyboard mappings, and [[Keyconfig|<code>keyconfig</code>]] for info on changing those mappings.

==Command Line==

{| class="article-table" style="width: 100%;"
! scope="col" style="width: 34%;" |Function
! scope="col" style="width: 22%;" |Windows
! scope="col" style="width: 22%;" |Linux
! scope="col" style="width: 22%;" |MacOS
|-
|<u>C</u>opy (entire line)
|<kbd>Ctrl</kbd>+<kbd>C</kbd>
|
|
|-
|Paste
|<kbd>Ctrl</kbd>+<kbd>V</kbd>
|
|
|-
|History
|<kbd>&#8239;↑&#8239;</kbd> / <kbd>&#8239;↓&#8239;</kbd>
|
|
|-
|<u>E</u>nd-of-line
|<kbd>End</kbd><br /><kbd>Ctrl</kbd>+<kbd>E</kbd>
|
|
|-
|Start-of-line
|<kbd>Home</kbd><br /><kbd>Ctrl</kbd>+<kbd>A</kbd>
|
|
|-
|<u>K</u>ill to end-of-line
|<kbd>Ctrl</kbd>+<kbd>K</kbd>
|
|
|-
|Kill to start-of-line
|<kbd>Ctrl</kbd>+<kbd>U</kbd>
|
|
|-
|Clear screen
|<kbd>Ctrl</kbd>+<kbd>L</kbd>
|
|
|}

==Text Editor==

{| class="article-table" style="width: 100%;"
! scope="col" style="width: 34%;" |Function
! scope="col" style="width: 22%;" |Windows
! scope="col" style="width: 22%;" |Linux
! scope="col" style="width: 22%;" |MacOS
|-
|Cut
|<kbd>Ctrl</kbd>+<kbd>X</kbd>
|
|<kbd>⌘Cmd</kbd>+<kbd>X</kbd>
|-
|<u>C</u>opy
|<kbd>Ctrl</kbd>+<kbd>C</kbd>
|
|<kbd>⌘Cmd</kbd>+<kbd>C</kbd>
|-
|Paste
|<kbd>Ctrl</kbd>+<kbd>V</kbd>
|
|<kbd>⌘Cmd</kbd>+<kbd>V</kbd>
|-
|Select <u>A</u>ll
|<kbd>Ctrl</kbd>+<kbd>A</kbd>
|
|<kbd>⌘Cmd</kbd>+<kbd>A</kbd>
|-
|<u>K</u>atakana (Japanese) Font Entry Mode Toggle
|<kbd>Ctrl</kbd>+<kbd>K</kbd>
|
|<kbd>⌘Cmd</kbd>+<kbd>K</kbd>
|-
|Hiragana (<u>J</u>apanese) Font Entry Mode Toggle
|<kbd>Ctrl</kbd>+<kbd>J</kbd>
|
|<kbd>⌘Cmd</kbd>+<kbd>J</kbd>
|-
|<u>P</u>uny (Small Caps) Font Entry Mode Toggle
|<kbd>Ctrl</kbd>+<kbd>P</kbd>
|
|<kbd>⌘Cmd</kbd>+<kbd>P</kbd>
|-
|Glyph (Icons) Font Entry
|<kbd>Shift</kbd>+<kbd>ABC...XYZ</kbd>
|
|<kbd>Shift</kbd>+<kbd>ABC...XYZ</kbd>
|-
|Insert/overwrite toggle
|<kbd>Ins</kbd>
|
|
|-
|Add indented line and 'END'
|<kbd>Shift</kbd>+<kbd>Enter</kbd>
|
|
|-
|Start of line
|<kbd>Home</kbd><br /><kbd>Ctrl</kbd>+<kbd>W</kbd>
|
|
|-
|<u>E</u>nd of line
|<kbd>End</kbd><br /><kbd>Ctrl</kbd>+<kbd>E</kbd>
|
|
|-
|Start of document
|<kbd>Ctrl</kbd>+<kbd>Home</kbd><br /><kbd>Ctrl</kbd>+<kbd>&#8239;↑&#8239;</kbd>
|
|
|-
|End of document
|<kbd>Ctrl</kbd>+<kbd>End</kbd><br /><kbd>Ctrl</kbd>+<kbd>&#8239;↓&#8239;</kbd>
|
|
|-
|Previous word
|<kbd>Ctrl</kbd>+<kbd>←</kbd>
|
|
|-
|Next word
|<kbd>Ctrl</kbd>+<kbd>→</kbd>
|
|
|-
|Previous function
|<kbd>Alt</kbd>+<kbd>&#8239;↑&#8239;</kbd>
|
|
|-
|Next function
|<kbd>Alt</kbd>+<kbd>&#8239;↓&#8239;</kbd>
|
|
|-
|Indent selection
|<kbd>⇥Tab</kbd>
|
|
|-
|Un-indent selection
|<kbd>Shift</kbd>+<kbd>⇥Tab</kbd>
|
|
|-
|Undo
|<kbd>Ctrl</kbd>+<kbd>Z</kbd>
|
|
|-
|Redo
|<kbd>Ctrl</kbd>+<kbd>Y</kbd>
|
|
|-
|<u>F</u>ind text in current tab
|<kbd>Ctrl</kbd>+<kbd>F</kbd>
|
|
|-
|Find text a<u>G</u>ain
|<kbd>Ctrl</kbd>+<kbd>G</kbd>
|
|
|-
|Repeat search across tabs (<u>H</u>yper search)
|<kbd>Ctrl</kbd>+<kbd>H</kbd>
|
|
|-
|Go to <u>L</u>ine number
|<kbd>Ctrl</kbd>+<kbd>I</kbd><br /><kbd>Ctrl</kbd>+<kbd>L</kbd>
|
|
|-
|<u>D</u>uplicate current line
|<kbd>Ctrl</kbd>+<kbd>D</kbd>
|
|
|-
|Toggle comment <u>B</u>lock
|<kbd>Ctrl</kbd>+<kbd>B</kbd>
|
|<kbd>⌘Cmd</kbd>+<kbd>B</kbd>
|-
|Switch to next tab
|<kbd>Ctrl</kbd>+<kbd>⇥Tab</kbd>
|
|<kbd>^Ctrl</kbd>+<kbd>⇥Tab</kbd>
|-
|Switch to previous tab
|<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>⇥Tab</kbd>
|
|<kbd>^Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>⇥Tab</kbd>
|}

==Sprite editor==

All tools:
{| class="article-table" style="width: 100%;"
! scope="col" style="width: 34%;" |Function
! scope="col" style="width: 22%;" |Windows
! scope="col" style="width: 22%;" |Linux
! scope="col" style="width: 22%;" |MacOS
|-
|Pan tool
|<kbd>Space</kbd>+<kbd>🖰&#8239;LClick+Drag</kbd>
|
|
|-
|<u>C</u>opy (see note below)
|<kbd>Ctrl</kbd>+<kbd>C</kbd>
|
|
|-
|Paste (at current sprite location)
|<kbd>Ctrl</kbd>+<kbd>V</kbd>
|
|
|-
|Undo/Redo (single-step)
|<kbd>Ctrl</kbd>+<kbd>Z</kbd>
|
|
|-
|Previous sprite
|<kbd>Q</kbd>
|
|
|-
|Next sprite
|<kbd>W</kbd>
|
|
|-
|Sprite above
|<kbd>Shift</kbd>+<kbd>Q</kbd>
|
|
|-
|Sprite below
|<kbd>Shift</kbd>+<kbd>W</kbd>
|
|
|-
|Previous color
|<kbd>1</kbd>
|
|
|-
|Next color
|<kbd>2</kbd>
|
|
|-
|Toggle full view
|<kbd>⇥Tab</kbd>
|
|
|-
|Replace color
|<kbd>Ctrl</kbd>+<kbd>🖰&#8239;LClick</kbd>
|
|
|-
|Shift by one pixel
|<kbd>←</kbd> / <kbd>→</kbd> / <kbd>&#8239;↑&#8239;</kbd> / <kbd>&#8239;↓&#8239;</kbd>
|
|
|-
|<u>F</u>lip <u>H</u>orizontal
|<kbd>F</kbd><br /><kbd>H</kbd>
|
|
|-
|Flip <u>V</u>ertical
|<kbd>V</kbd>
|
|
|-
|<u>R</u>otate 90° CCW
|<kbd>R</kbd>
|
|
|-
|Zoom
|<kbd>&lt;</kbd> / <kbd>&gt;</kbd><br /><kbd>🖰&#8239;Wheel</kbd>
|
|
|} 

Draw tool:
{| class="article-table" style="width: 100%;"
! scope="col" style="width: 34%;" |Function
! scope="col" style="width: 22%;" |Windows
! scope="col" style="width: 22%;" |Linux
! scope="col" style="width: 22%;" |MacOS
|-
|<u>C</u>opy
|<kbd>Ctrl</kbd>+<kbd>C</kbd>
|
|
|-
|Paste (at upper left)
|<kbd>Ctrl</kbd>+<kbd>V</kbd>
|
|
|-
|Replace color
|<kbd>Ctrl</kbd>+<kbd>🖰&#8239;LClick</kbd>
|
|
|-
|Color Picker
|<kbd>🖰&#8239;RClick</kbd>
|
|
|} 

Stamp tool:
{| class="article-table" style="width: 100%;"
! scope="col" style="width: 34%;" |Function
! scope="col" style="width: 22%;" |Windows
! scope="col" style="width: 22%;" |Linux
! scope="col" style="width: 22%;" |MacOS
|-
|Stamp with color 0 transparent
|<kbd>LCtrl</kbd>+<kbd>🖰&#8239;LClick</kbd>
|
|
|} 

Select tool:
{| class="article-table" style="width: 100%;"
! scope="col" style="width: 34%;" |Function
! scope="col" style="width: 22%;" |Windows
! scope="col" style="width: 22%;" |Linux
! scope="col" style="width: 22%;" |MacOS
|-
|Select none
|<kbd>Enter</kbd>
|
|
|} 

Fill tool:

(n/a?)

Lower sprite sheet area:
{| class="article-table" style="width: 100%;"
! scope="col" style="width: 34%;" |Function
! scope="col" style="width: 22%;" |Windows
! scope="col" style="width: 22%;" |Linux
! scope="col" style="width: 22%;" |MacOS
|-
|Select multiple sprites<br />(for flip, shift, copy, rotate)
|<kbd>Shift</kbd>+<kbd>🖰&#8239;LClick+Drag</kbd>
|
|
|}

Note: When a sprite or range of sprites is copied to the clipboard, they may be pasted into other programs as a text-encoded representation. This representation can be uploaded in a BBS post and will show as the actual sprite. Similarly, a sprite encoded in text may be copied from outside of PICO-8 and pasted into the sprite editor.

==Map editor==
{| class="article-table"
!Function
!MacOS
|-
|Move a sprite to another sprite and changes all sprites on map equal to the sprite number to the new sprite number
|<kbd>Ctrl</kbd>+<kbd>X</kbd>
|}
==SFX editor==

==== Both views ====
{| class="article-table" style="width: 100%;"
! scope="col" style="width: 34%;" |Function
! scope="col" style="width: 22%;" |Windows
! scope="col" style="width: 22%;" |Linux
! scope="col" style="width: 22%;" |MacOS
|-
|Swap pitch/note views
|<kbd>Tab</kbd>
|<kbd>Tab</kbd>
|
|-
|Increase Speed
|<kbd>Period</kbd>
|<kbd>Period</kbd>
|
|-
|Decrease Speed
|<kbd>Comma</kbd>
|<kbd>Comma</kbd>
|
|-
|Increase Speed by 4
|<kbd>Shift</kbd> + <kbd>Period</kbd>
|<kbd>Shift</kbd> + <kbd>Period</kbd>
|
|-
|Decrease Speed by 4
|<kbd>Shift</kbd> + <kbd>Comma</kbd>
|<kbd>Shift</kbd> + <kbd>Comma</kbd>
|
|-
|Switch to Next Sound Effect
|<kbd>=</kbd>
|<kbd>=</kbd>
|
|-
|Switch to Previous Sound Effect
|<kbd>-</kbd>
|<kbd>-</kbd>
|
|-
|Switch to n+4 Sound Effect
|<kbd>Shift</kbd>+<kbd>=</kbd>
|
|
|-
|Switch to n-4 Sound Effect
|<kbd>Shift</kbd>+<kbd>-</kbd>
|
|
|-
|Change all notes to the selected instrument
|<kbd>Shift</kbd>+<kbd>🖰&#8239;LClick</kbd> on an instrument
|
|
|}

==== Note view ====
''For each of the transpose shortcuts, you need to have notes selected.''
{| class="article-table" style="width: 100%;"
! scope="col" style="width: 34%;" |Function
! scope="col" style="width: 22%;" |Windows
! scope="col" style="width: 22%;" |Linux
! scope="col" style="width: 22%;" |MacOS
|-
|Select Multiple Notes
|<kbd>Shift</kbd>+<kbd>🖰&#8239;LClick</kbd> the notes (first click is left side, second click is right side)
|
|
|-
|Apply Effect to All Notes
|<kbd>Shift</kbd>+<kbd>🖰&#8239;LClick</kbd> an effect
|
|
|-
|Navigate down/up 4 notes
|<kbd>Ctrl</kbd>+<kbd>&#8239;↓&#8239;</kbd> or <kbd>Ctrl</kbd>+<kbd>&#8239;↑&#8239;</kbd>
|
|
|-
|Navigate to right/left column
|<kbd>Ctrl</kbd>+<kbd>→</kbd> or <kbd>Ctrl</kbd>+<kbd>←</kbd>
|
|
|-
|Transpose +1 (one semitone)
|<kbd>Shift</kbd>+<kbd>2</kbd>
|
|
|-
|Transpose +2
|<kbd>Shift</kbd>+<kbd>W</kbd>
|
|
|-
|Transpose +3
|<kbd>Shift</kbd>+<kbd>3</kbd>
|
|
|-
|Transpose +4
|<kbd>Shift</kbd>+<kbd>E</kbd>
|
|
|-
|Transpose +5
|<kbd>Shift</kbd>+<kbd>R</kbd>
|
|
|-
|Transpose +6
|<kbd>Shift</kbd>+<kbd>5</kbd>
|
|
|-
|Transpose +7
|<kbd>Shift</kbd>+<kbd>T</kbd>
|
|
|-
|Transpose +8
|<kbd>Shift</kbd>+<kbd>6</kbd>
|
|
|-
|Transpose +9
|<kbd>Shift</kbd>+<kbd>Y</kbd>
|
|
|-
|Transpose +10
|<kbd>Shift</kbd>+<kbd>7</kbd>
|
|
|-
|Transpose +11
|<kbd>Shift</kbd>+<kbd>U</kbd>
|
|
|-
|Transpose +12 (one octave)
|<kbd>Shift</kbd>+<kbd>i</kbd>
|
|
|-
|Transpose +13
|<kbd>Shift</kbd>+<kbd>9</kbd>
|
|
|-
|Transpose +14
|<kbd>Shift</kbd>+<kbd>O</kbd>
|
|
|-
|Transpose +15
|<kbd>Shift</kbd>+<kbd>0</kbd>
|
|
|-
|Transpose -12 (one octave)
|<kbd>Shift</kbd>+<kbd>Z</kbd>
|
|
|-
|Transpose -11
|<kbd>Shift</kbd>+<kbd>S</kbd>
|
|
|-
|Transpose -10
|<kbd>Shift</kbd>+<kbd>X</kbd>
|
|
|-
|Transpose -9
|<kbd>Shift</kbd>+<kbd>D</kbd>
|
|
|-
|Transpose -8
|<kbd>Shift</kbd>+<kbd>C</kbd>
|
|
|-
|Transpose -7
|<kbd>Shift</kbd>+<kbd>V</kbd>
|
|
|-
|Transpose -6
|<kbd>Shift</kbd>+<kbd>G</kbd>
|
|
|-
|Transpose -5
|<kbd>Shift</kbd>+<kbd>B</kbd>
|
|
|-
|Transpose -4
|<kbd>Shift</kbd>+<kbd>H</kbd>
|
|
|-
|Transpose -3
|<kbd>Shift</kbd>+<kbd>N</kbd>
|
|
|-
|Transpose -2
|<kbd>Shift</kbd>+<kbd>J</kbd>
|
|
|-
|Transpose -1
|<kbd>Shift</kbd>+<kbd>M</kbd>
|
|
|}

==Music editor==
(TODO)
[[Category:Research]]
Latest revision		Your text
Line 1:		Line 1:
−	<sup>''!!! Work in progress !!!''</sup>	+	<sup>''!!! Work in progress, not ready for prime time, do not link from other pages yet !!!''</sup>

	Not all PICO-8 hardware has a keyboard, but when it does, there are many keyboard shortcuts that one can use. Known shortcuts are listed here.		Not all PICO-8 hardware has a keyboard, but when it does, there are many keyboard shortcuts that one can use. Known shortcuts are listed here.