Keyboard Shortcuts

Tachyonn is built to be driven from the keyboard while you present. Here's the complete reference.

Navigation

Shortcut	Action
→ / ↓	Next animation step, or next slide
Space	Next animation step, or next slide
Enter	Next animation step, or next slide
← / ↑	Previous animation step, or previous slide
Backspace	Previous animation step, or previous slide
Page Down	Next animation step, or next slide (remote clickers)
Page Up	Previous animation step, or previous slide (remote clickers)
Shift + → / Shift + ↓ / Shift + Page Down	Jump to the next section (#)
Shift + ← / Shift + ↑ / Shift + Page Up	Jump to the previous section (#)
O	Toggle the 2D overview (sections as columns)
T	Toggle the table of contents — jump to any section
G	Go to slide — type a slide number (or a ::id) and press Enter
F	Toggle fullscreen
Escape	Close the presentation

All four arrows move linearly through the deck: →/↓ go forward, ←/↑
go back. Add Shift to jump between sections instead. The forward and back keys
are animation-aware: if the current slide still has reveals waiting, they
advance/rewind the animation first, and only change slide once everything is
shown.

Page Down / Page Up are aliases of forward/back — including with Shift,
which jumps section to section just like Shift + arrow. Most USB and Bluetooth
presentation remotes send exactly those two keys, so a clicker drives Tachyonn
with no configuration at all.

Presenter mode

Shortcut	Action
Cmd/Ctrl + P	Open the presenter window
Cmd/Ctrl + Shift + F	Toggle fullscreen on the presentation window
Cmd/Ctrl + Shift + D	Re-apply your saved display arrangement

Presenter mode opens a second window showing the current slide as a thumbnail, the next state, your speaker notes, and a running timer — everything you want facing you while the audience sees only the slides. (Next state, not next slide: while the current slide still has clicks pending, the panel previews that same slide one click ahead.)

Two screens: which window goes where

The Telas button in the presenter's toolbar lists every monitor Tachyonn can see and lets you say which one hosts the presentation and which one hosts the presenter. Tick Apresentação em tela cheia to have the presentation window go fullscreen — the real macOS fullscreen, the same one the green button gives you.

The choice is saved in <app-data>/displays.json and re-applied every time you open the presenter window, so a recurring lecture setup (projector + laptop) only has to be configured once. Monitors are matched by name, not by index, so unplugging and replugging the projector doesn't scramble the arrangement. If something did move — you connected the projector after opening the deck, say — Cmd/Ctrl + Shift + D (also View → Arrange Displays) puts everything back.

Jumping between sections

The Shift + arrow shortcuts deserve a special mention. Shift + → finds the next slide created by a # heading and jumps straight to it, skipping every slide in between. Shift + ← does the same in reverse. Shift + Page Down / Shift + Page Up do exactly the same thing, for remotes whose buttons can be paired with a modifier.

In a long talk this is invaluable: when someone asks a question about an earlier part, you can hop back to that chapter in one keystroke instead of pressing ← twenty times.

The table of contents (T)

Shift + arrow walks the sections one by one; T shows them all at once. It opens a modal listing every # section of the deck — the one you're in highlighted, the destination slide number on the right — and each entry is a link that takes you straight there.

Pick with ↑/↓ and Enter, or just click. Esc (or T again) closes it without moving. It works from either window: opened in the presenter, the jump moves the audience's screen too.

Sections marked toc: false stay out of the list, exactly as they stay out of the index shown on section dividers — so appendix and backup material doesn't clutter the way to what you actually want.

T is ignored while you're typing in a field, and inside drawing mode it keeps its usual meaning (the text tool).

Go to slide (G)

When you know exactly where you want to land, G is faster than any list: it opens a small box at the bottom of the screen, you type the slide number — the same number the footer shows — and Enter jumps there. Esc closes it without moving.

It also accepts a slide's ::id, so a slide written as ## Results ::results is reachable by typing results. Anything that doesn't resolve to a real slide is flagged in the box and Enter simply does nothing.

Like the table of contents, it works from either window: used in the presenter, the jump moves the audience's screen too.

Whiteboard and drawing

While presenting, a small toolbar gives you live annotation tools:

Tool	Effect
Pen	Free-hand drawing
Highlighter	Semi-transparent marker
Shapes	Lines, rectangles, ellipses
Eraser	Remove individual strokes
Clear	Wipe all drawings on the current slide
Whiteboard	Slide a blank panel over the slide to draw on

Anything you draw is mirrored to the audience's screen when you're sharing over the network, so a diagram you sketch live shows up everywhere at once.