Skip to main content
Right after install. You need a Wayland compositor running. No compositor, no windows.
1

Launch the terminal

Renders on the CPU through the shared Otter render stack. The terminal grid does not need a GPU.
2

Start background daemons

Start these for now:
For a permanent setup, add them to compositor autostart. See Session setup.
3

Open the launcher

Bind this to a compositor hotkey for daily use:
Type to search apps. Try =2+3*4 (calculator), :heart (emoji), clip (clipboard), or file invoice / grep TODO (desktop search; needs otter-search running).
4

Take a screenshot

Click and drag a region. The image copies to your clipboard.
5

Try the auto-clicker

With the default config, pick a point with the crosshair, then let it click. Run toggle again to stop. See otter-clicker.
6

Create a sticky note

Bind a hotkey, for example Super+N.
7

Open the system monitor

Check CPU, memory, disk, and running processes. See otter-monitor.
8

Check the weather

Print current conditions:
For the status bar, add a weather widget in otter-bar and run:
See otter-weather and otter-bar.
Bind global hotkeys in your compositor. Wayland apps cannot grab system-wide shortcuts. Examples:Hyprland (~/.config/hypr/hyprland.conf):
Sway (~/.config/sway/config):
See Keybinds for the full reference.

​
What’s next

Session setup

Autostart the shell daemons your desktop needs.

Status bar

Set up widgets, tray, and the launcher button.

Settings

Bar, theme, and app settings in the GUI.

Configuration

Manual config files and hot-reload behavior.