Skip to content

Menus

Every menu and what its items do. Help ▸ Search Menus… finds any of these by name.

File

Item Notes
New Project… Cmd+N — opens a new tab (browser) or window (desktop) at the Welcome screen, where you create the project; the current project stays open
Open Project… Cmd+O — .slp or .pkg.slp
Import ▸ Analysis HDF5 / NWB dataset / COCO dataset / DeepLabCut dataset / Multiple DeepLabCut datasets from folder Import & Export
Merge into Project… Merging Projects
Replace Videos… ▸ (per video) Re-point a video at a new file
Add Video from URL… Videos served over https://
Save Cmd+S
Save As… Cmd+Shift+S
Export ▸ JSON / Analysis CSV / Analysis HDF5 / NWB (ndx-pose) / Labels Package / Labeled Clip (Video) Import & Export. NWB is desktop only. Labels Package here downloads a .pkg.json (the labels as JSON plus a list of the referenced videos); for a .pkg.slp with embedded images, use Predict ▸ Export Labels Package…
Reveal Project in File Manager Desktop only
Open Preferences Directory… Desktop only
Clear Video Transcode Cache… Desktop only
Quit Cmd+Q

Edit

Item Notes
Undo / Redo Cmd+Z / Cmd+Shift+Z — the label names the action, e.g. Undo Add Instance
Copy Instance / Paste Instance Cmd+C / Cmd+V
Add Instance Cmd+I
Delete Instance Cmd+Backspace
Delete Predictions on Current Frame

Go

Item Notes
Go to Frame… / Select to Frame… Cmd+J / Cmd+Shift+J
Next / Previous Labeled Frame Alt+Right / Alt+Left
Navigate All Frames / Labeled Frames Only / Imaged Frames Only Sets what Right/Left step through
Next / Previous Suggestion Space / Shift+Space
Last Interacted Frame Cmd+A
Next / Previous User Labeled Frame Cmd+U / Cmd+Shift+U
Next Track Spawn Frame Cmd+E
Mark Frame / Go to Marked Frame Cmd+M / Cmd+Shift+M
Next / Previous Video Alt+Shift+Right / Alt+Shift+Left
Select Next Instance / Clear Selection ` / Esc

Navigation guide

View

Item Notes
Side Panel / Sidebar on Left / Allow Multiple Panels Layout
Fit View to Instances / to Selection Cmd+=
Default to Pan Mode P
Node Placement Mode N
Text Size ▸ Increase / Decrease / Reset to Default
Display ▸ Manual / Only selected (with hidden points) / All instances, visible points only / All visible + selected hidden points Occluded-node policy
Show Instances / Show Non-Visible Nodes / Show Node Names / Show Edges H / V / T / Cmd+Shift+Tab
Crosshair When Zoomed / Magnifier When Moving Nodes Precision aids
Edge Style ▸ Line / Wedge
Node Marker Size ▸ / Node Label Size ▸ / Trail Length ▸
Color Palette ▸ standard / five+ / alphabet
Apply Distinct Colors To ▸ Auto (Node / Track) / Tracks / Instances / Nodes / Edges
Color Predicted Instances / Show Track Scores
Create Local Scrub Proxies for Network Videos (Desktop) Desktop only; off by default. Builds a local copy of large network-drive videos for smoother scrubbing

View guide

Panels

One checkbox per panel, which shows or hides that panel's button in the sidebar strip — it doesn't open the panel. Reset to Defaults… restores the default order and visibility. See Panels.

Labels

Item Notes
Add Instance Cmd+I
Instance Placement Method ▸ Best / Template / Force Directed / Random / Copy Prior Frame / Copy Predictions Labeling
Show Hints During Labeling
Delete Instance Cmd+Backspace
Mark Frame as Negative
Accept All Predictions on Current Frame Cmd+Shift+A
Accept All Predictions Project-wide
Delete Predictions on Current Frame
Delete Predictions… Over a range
Delete Predictions from Area… Cmd+K
Delete All Predictions…

Predict

Item Notes
Training… Cmd+L — Training
Inference / Run Prediction… Inference
Export Labels Package… A self-contained .pkg.slp with frame images embedded — user-labeled frames, + suggestions, or all labeled frames. For training elsewhere
Export Model to ONNX/TensorRT… Desktop only — Inference
Import Predictions… Not yet implemented — it shows a notice. Load predictions with File ▸ Open Project… or File ▸ Merge into Project…
Evaluation Metrics for Trained Models… Accuracy metrics per model
Set Overlay Models… Pick the trained models whose outputs to overlay. The overlay runs sleap-nn locally, so it needs the desktop app
Visualize Model Outputs Checkbox — confidence maps, PAFs, class maps. Disabled until overlay models are set

Tracks

Item Notes
Transpose Instance Tracks Cmd+T
New Track Cmd+0
Set Instance Track ▸ (per track) Only when the project has tracks. Cmd+1 … Cmd+9 set tracks 1–9 directly
Copy / Paste Instance Track Cmd+Shift+C / Cmd+Shift+V
Propagate Track Labels Carry an identity forward
Delete Instance and Track Cmd+Shift+Backspace
Delete Track ▸ (per track) Only when the project has tracks
Delete Unused Tracks / Delete All Tracks
Seekbar Header ▸ None / Instance Count / Point Displacement / Primary Point Displacement / Tracking Score / Instance Score / Point Score / Number of predicted points / Min Centroid Proximity Navigation

Analyze

Item Notes
Instance Size Distribution… Guide
Label Quality Check… Guide

Start Tutorial

Not a menu — a button. Runs the guided walkthrough of the full labeling → training → correction → inference loop.

The tutorial builds its own project from a sample video. If you already have a project open, it offers to run in a new window so your project is left alone. In the desktop app it starts with a Step 0 that checks uv and sleap-nn are installed and warns you if training will run on the CPU. In the browser, Step 0 explains that models can't be trained there, and the tutorial ends after labeling.

Help

Item Notes
Search Menus… Find and run any menu command by name
Keyboard Shortcuts… Reference
Labeling Tips…
Documentation Opens this site, for the channel the app is on (app.sleap.ai/docs/<channel>/)
Report Issue Opens the issue tracker
Collect Diagnostics… Bundles environment info for a bug report
Releases Opens the releases page
About SLEAP Label Version and channel