Learn Omarchy by doing.

An interactive course that teaches Omarchy directly on your desktop. Press each shortcut, hear it explained, and watch a pixel guide point out what just happened.

Get Learn Omarchy

A short emulation of a real lesson. In the course, Hyprland confirms each result before moving on.

17lessons
101activities
2guides
0config changes

Meet your guides

They fly to the menu, workspace, or panel being discussed, narrate every step, and react as you press each key. Pick one on first launch. Switch anytime.

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

rocket-powered

Ohm-1

Precise, upbeat, and always pointing the way. Lands by rocket, hovers beside the keycaps, and celebrates every shortcut. Call him Ohm for short.

Ollie, a pixel owl with a pink scarf

calm and patient

Ollie

A wise little owl who glides between stops and explains things gently. Her hints make the next keypress feel obvious instead of mysterious.

  1. 01

    Choose a guide

    Start with Ohm-1 or Ollie, then tune narration, captions, text size, and motion.

  2. 02

    Follow along

    See the exact desktop area being discussed and open Details when you want more context.

  3. 03

    Press the keys

    Use the real shortcut, complete guided exercises, and lock it in with mixed practice.

Practice directly on your desktop

No flashcards. No fake keyboard. Learn Omarchy watches what you press and highlights what happens next.

Real shortcuts

Press the actual Omarchy combinations. Each keycap lights up as you hold it, and Hyprland verifies the result before the lesson moves on.

Super+Return

On-screen pointing

Your guide flies to the exact bar button, workspace, window, or panel while each idea is introduced. Highlights track the real surface.

Narrated captions

Spoken guidance with captions that reveal word by word as they are said. Larger text, reduced motion, and mute are one switch away.

Hints and replay

Skip, hint, Help, or replay any lesson. Practice mode hides the keycaps and quizzes you. Earned progress stays even if you try again later.

Safe by design

Help runs the same semantic commands as Omarchy's own bindings. Nothing edits your config, and nothing is installed without asking.

Printable cheatsheet

Open a complete shortcut reference from inside the course, then print it or save it as a PDF for the desk.

From first launch to daily flow

Seventeen focused lessons. Start with the essentials, then explore optional tools when you are ready. Optional activities never block core 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
  • Your first real sessionPut the essential shortcuts together

03 Optional deep dives

  • Window controlsGrouping, pinning, layouts, and gestures
  • 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

The welcome and notifications lessons complete the seventeen.

Install

One package. Both guides, all narration, and the desktop integration are included. Requires an up-to-date Omarchy desktop.

  1. 01

    Download the package

    From the latest GitHub release, grab the .pkg.tar.zst package. SHA256SUMS is there too if you want to verify.

    Open Releases →
  2. 02

    Install with pacman

    Install the package and its dependencies.

    install
    $ sudo pacman -U ./learn-omarchy-*.pkg.tar.zst
    Optional: verify the checksum first

    Confirms the download matches the release before installing.

    verify
    $ sha256sum --check --ignore-missing SHA256SUMS
  3. 03

    Launch Learn Omarchy

    Open it from the Apps menu, or run it from a terminal. Choose Ohm-1 or Ollie and start the welcome lesson.

    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