Learn Omarchy by doing.

Learn Omarchy on your desktop. Press real shortcuts, hear each step, and watch a pixel guide point to the result.

Get Learn Omarchy

A sample lesson. The course waits for Hyprland to confirm each result.

16lessons
93activities
2guides
0config changes

Meet your guides

Pick Ohm-1 or Ollie. They narrate each step, react to your keys, and point to the menu, workspace, or panel in use.

Ohm-1, a pixel robot with a CRT head and boot flames

rocket-powered

Ohm-1

Precise and upbeat, Ohm rockets between targets and celebrates every shortcut.

Ollie, a pixel owl with a pink scarf

calm and patient

Ollie

Calm and patient, Ollie glides between steps and offers gentle hints.

Practice directly on your desktop

Press real shortcuts and see what they change. Learn Omarchy follows along on your desktop.

Real shortcuts

Keycaps light up as you press each combination. Hyprland verifies the result before the lesson continues.

Super+Return

On-screen pointing

Your guide flies to the bar button, workspace, window, or panel being explained.

Narrated captions

Hear each step and read along. Larger text, reduced motion, and mute are built in.

Hints and replay

Use a hint, replay a lesson, or hide the keycaps for a challenge. Earned progress stays yours.

Safe by design

Nothing edits your config, and nothing is installed without asking.

Printable cheatsheet

Open the full shortcut reference, print it, or save it as a PDF.

Shortcut Arcade: Turn practice into play

Build recall with three quick games. Use hints anytime, keep earned points, and revisit shortcuts that need practice.

Start here · No timer

Window Rescue

Complete a six-step desktop mission at your own pace. Hints are always available, and no real windows are moved.

60 seconds

Shortcut Sprint

Recall as many shortcuts as you can in one minute. Replay the same deck to race your best pace.

Falling cards

Keyfall

Use each shortcut before its card reaches the bottom. Choose the pace, take hints, and retry missed skills.

From first launch to daily flow

Sixteen focused lessons, from core shortcuts to optional tools. Extras never block completion.

01 Core foundations

  • Omarchy tourBar, workspaces, and the Omarchy menu
  • Menus and appsFind, launch, search, and close applications
  • Everyday appsTerminal, browser, and file manager
  • WindowsFocus, resize, float, swap, and fullscreen
  • WorkspacesMove windows and use the scratchpad

02 Productive workflows

  • Clipboard and ComposeHistory and sequential character input
  • CaptureScreenshots, previews, and screen recording
  • Apps and upkeepApplication discovery and maintenance
  • Setup and systemHardware, display, system, and lock

03 Optional deep dives

  • Window controlsSafe pop-out and resize practice on a disposable terminal
  • Desktop controlsAudio, network, calendar, themes, and more
  • Productivity extrasEmoji, reminders, and local dictation
  • Useful toolsActivity, calculations, and disk usage
  • Create and shareLocal media and sharing workflows

Together, these sections cover all sixteen lessons.

Install

One Omarchy package includes both guides, all narration, and every lesson.

  1. 01

    Update Omarchy and install

    Run these commands in a terminal. Omarchy installs Learn Omarchy and its required dependencies.

    install
    $ omarchy update
$ omarchy pkg add learn-omarchy
  2. 02

    Launch Learn Omarchy

    Open Apps with the shortcut, type Learn Omarchy, and press Enter.

    Super+Space
    Or launch it from a terminal
    launch
    $ learn-omarchy
Build from a GitHub checkout instead

Use this only if you cannot download the package and have a trusted checkout.

from source
$ sudo pacman -S --needed base-devel git nodejs
$ git clone https://github.com/DanWahlin/learn-omarchy.git
$ cd learn-omarchy
$ node tools/prepare-checkout-package.mjs --output release-work/local
$ cd release-work/local
$ makepkg --syncdeps --install