diff --git a/manual/02-getting-started.md b/manual/02-getting-started.md index 8d3d9a8f..86ca7aa9 100644 --- a/manual/02-getting-started.md +++ b/manual/02-getting-started.md @@ -1,6 +1,6 @@ # Getting Started -Omarchy is installed using an ISO. You can choose between a full-disk install, which takes over the entire drive, or a free-space install, which puts Omarchy in the unallocated space on a drive — that's how you dual boot alongside Windows or another OS (see [dual-boot install](51-dual-boot-install.md) — note that you'll need to turn off BitLocker in Windows first). Either way, the installation defaults to full encryption, and the full-disk option will wipe the selected drive, so be sure to take a backup before using an existing one! +Omarchy is installed using an ISO. You can choose between a full-disk install, which takes over the entire drive, or a free-space install, which puts Omarchy in the unallocated space on a drive — that's how you dual boot alongside Windows or another OS (see [dual-boot install](50-dual-boot-install.md) — note that you'll need to turn off BitLocker in Windows first). Either way, the installation defaults to full encryption, and the full-disk option will wipe the selected drive, so be sure to take a backup before using an existing one! [Download the Omarchy ISO](https://omarchy.org/) first, put it on a USB stick (use [balenaEtcher](https://etcher.balena.io/) on Mac/Windows or [caligula](https://github.com/ifd3f/caligula) on Linux), and boot off the stick. @@ -8,11 +8,11 @@ _You must turn off Secure Boot and/or TPM in the BIOS. You have to turn these of Then answer the configuration questions, and confirm them like this: - ![omarchy-install.png](https://learn.omacom.io/u/omarchy-install-k5Iksv.png) + ![install-config](images/install-config.webp) Then select a drive for your installation, and sit back and watch the installation show go. It can be done in under a minute on the fastest modern machines, but it shouldn't take more than 5 minutes even on an older computer. - ![omarchy-installed.png](https://learn.omacom.io/u/omarchy-installed-NR1wu1.png) + ![install-done](images/install-done.webp) Now you're ready to Omarchy! @@ -22,11 +22,11 @@ The full-disk encryption won't allow you to enter the password from a Bluetooth ### Installing for another owner -If you're setting up a machine for someone else — a family member, a new employee, a buyer — you shouldn't be answering the personal questions on their behalf. Hit `Ctrl + C` on the very first screen of the installer (the keyboard selection), and Omarchy will offer to prepare the machine for another owner instead. The system installs right away, but all the personal setup — keyboard layout, username, password — is deferred until the machine boots for the first time. The drive is still encrypted by default, and the password the new owner picks on that first boot becomes the encryption password too. (A machine you've already been using can be handed over without a reinstall too — see [resetting the computer](49-security.md).) +If you're setting up a machine for someone else — a family member, a new employee, a buyer — you shouldn't be answering the personal questions on their behalf. Hit `Ctrl + C` on the very first screen of the installer (the keyboard selection), and Omarchy will offer to prepare the machine for another owner instead. The system installs right away, but all the personal setup — keyboard layout, username, password — is deferred until the machine boots for the first time. The drive is still encrypted by default, and the password the new owner picks on that first boot becomes the encryption password too. (A machine you've already been using can be handed over without a reinstall too — see [resetting the computer](48-security.md).) ### Unattended installs -The ISO can also install completely on its own — no keyboard, no wizard — when it's handed its configuration on a second drive. That's the way to treat Omarchy as a base image for VMs and fleet machines. See [unattended installs](52-unattended-installs.md). +The ISO can also install completely on its own — no keyboard, no wizard — when it's handed its configuration on a second drive. That's the way to treat Omarchy as a base image for VMs and fleet machines. See [unattended installs](51-unattended-installs.md). ### No-encryption installations diff --git a/manual/03-coming-from-mac-or-windows.md b/manual/03-coming-from-mac-or-windows.md index 31fe7748..cb36d6e4 100644 --- a/manual/03-coming-from-mac-or-windows.md +++ b/manual/03-coming-from-mac-or-windows.md @@ -34,7 +34,7 @@ Windows folks: your Win + V clipboard history lives on `Super + Ctrl + V`, and i | AirDrop | LocalSend, via `Super + Ctrl + S` — see [GUIs](22-guis.md) | | Cmd + Shift + 4 / Win + Shift + S | `Print Screen` — see [screenshots & recording](12-screenshots-recording.md) | | Notification Center | Notification history on `Super + Shift + Alt + ,` | -| Time Machine (for the system) | Automatic [system snapshots](48-system-snapshots.md) on every update | +| Time Machine (for the system) | Automatic [system snapshots](47-system-snapshots.md) on every update | | App Store / downloading an installer | _Install_ in the menu, or `omarchy pkg add` — see [other packages](29-other-packages.md) | | System Settings / Control Panel | _Setup_ in the menu, which edits plain config files — see [dotfiles](31-dotfiles.md) | @@ -50,7 +50,7 @@ And when you close a window, the app actually quits. There's no macOS limbo wher ### On Mac hardware -Omarchy runs well on Intel Macs — see [Mac support](45-mac-support.md). And the keyboard is kind to you: Omarchy doesn't remap anything, and Linux treats the Command key as Super, so Super sits right where Cmd always was. Your thumb won't notice the move. +Omarchy runs well on Intel Macs — see [Mac support](44-mac-support.md). And the keyboard is kind to you: Omarchy doesn't remap anything, and Linux treats the Command key as Super, so Super sits right where Cmd always was. Your thumb won't notice the move. ### Give it two weeks diff --git a/manual/04-navigation.md b/manual/04-navigation.md index 20663431..7c898d97 100644 --- a/manual/04-navigation.md +++ b/manual/04-navigation.md @@ -4,17 +4,17 @@ Everything in Omarchy happens via the keyboard — _EVERYTHING!_ When the system But the Omarchy menu is not even intended to be the main way to operate the system most of the time. We can get faster than that! All the most important applications are bound directly to individual hotkeys. You start the terminal with `Super + Return` and a browser with `Super + Shift + Return`. Try doing one after the other, and you'll see the magic of Hyprland's tiling in action: - ![browser+terminal.png](https://manual.omakub.org/u/browser-terminal-yCV75f.png) + ![navigation-browser-terminal](images/navigation-browser-terminal.webp) You can then hit `Super + J` to stack them on top of each other instead of side by side: - ![stacked.png](https://learn.omacom.io/u/stacked-sswEJE.png) + ![navigation-stacked](images/navigation-stacked.webp) Hit `Super + J` again to return them to their side-by-side positions. Then try `Super + Shift + Arrow Right` while on the browser to swap the windows. Now try `Super + Ctrl + T` to start the Activity monitor. That'll appears as a floating window. You can tile it using `Super + T` (and hit that again to make it floating again). Now press `Super + Shift + F` to open the files manager. You'll have a neat four-way setup: - ![fourway-tiling.png](https://learn.omacom.io/u/fourway-tiling-SHbfzO.png) + ![navigation-fourway-tiling](images/navigation-fourway-tiling.webp) You navigate between the window you want to be active with `Super + Arrow`. This will switch focus and move the cursor to the center of the new application. @@ -30,11 +30,11 @@ You can also go full screen with `Super + F` or even just full-width (keeping th Omarchy's default layout is called dwindle. It keeps all the windows you open on a single workspace visible at all time, even if it has to shrink them down. - ![dwindle-layout.png](https://learn.omacom.io/u/dwindle-layout-BNU9qb.png) + ![navigation-dwindle-layout](images/navigation-dwindle-layout.webp) But you can also choose to turn a workspace into the scrolling layout where windows are lined up side-by-side, beyond the visible edge of the display. You turn a single workspace into this layout via `Super + L`. - ![niri-layout.png](https://learn.omacom.io/u/niri-layout-LvV25i.png) + ![navigation-scrolling-layout](images/navigation-scrolling-layout.webp) The choice is per workspace, and it sticks. So you can keep workspace 1 on dwindle for browsing and workspace 2 on scrolling for code, and they'll come back that way after a restart. (The same toggle is under _Trigger > Toggle > Workspace Layout_ in the Omarchy menu). @@ -58,7 +58,7 @@ You can move a window out of the grouping with `Super + Alt + G` or disassemble You can pop a window out of its workspace allocation with `Super + O`. That'll pin it as a floating window that follows you on whatever workspace you go to. Great for video players and the like. - ![popped-window.jpg](https://learn.omacom.io/u/popped-window-L8N3dk.jpg) + ![navigation-popped-window](images/navigation-popped-window.webp) ### Scratchpad workspace diff --git a/manual/06-themes.md b/manual/06-themes.md index afe33b20..4d62dce8 100644 --- a/manual/06-themes.md +++ b/manual/06-themes.md @@ -6,122 +6,122 @@ Each theme styles the desktop, terminal, neovim, activity screen (btop), Chromiu Themes have a set of background images that you can pick between using `Super + Ctrl + Space`. -You can find even more themes on [the extra themes page](43-extra-themes.md) or even [make your own theme](44-making-your-own-theme.md). +You can install extra community themes via _Install > Style > Theme_ in the Omarchy menu, or even [make your own theme](43-making-your-own-theme.md). - ![tokyo-night.png](https://learn.omacom.io/u/tokyo-night-yN9jzd.png) + ![tokyo-night](../themes/tokyo-night/preview.png) _Tokyo Night_ - ![catppuccin.png](https://learn.omacom.io/u/catppuccin-DEGjke.png) + ![catppuccin](../themes/catppuccin/preview.png) _Catppuccin_ - ![preview.png](https://learn.omacom.io/u/preview-LFlhHZ.png) + ![lumon](../themes/lumon/preview.png) _Lumon_ - ![preview.png](https://learn.omacom.io/u/preview-bAfGjN.png) + ![ethereal](../themes/ethereal/preview.png) _Ethereal_ - ![everforest.png](https://learn.omacom.io/u/everforest-VTw7rC.png) + ![everforest](../themes/everforest/preview.png) _Everforest_ - ![gruvbox.png](https://learn.omacom.io/u/gruvbox-zTUJ1I.png) + ![gruvbox](../themes/gruvbox/preview.png) _Gruvbox_ - ![preview.png](https://learn.omacom.io/u/preview-9laZfK.png) + ![miasma](../themes/miasma/preview.png) _Miasma_ - ![hackerman-6k-tc.png](https://learn.omacom.io/u/hackerman-6k-tc-9s09Op.png) + ![hackerman](../themes/hackerman/preview.png) _Hackerman_ - ![osaka-jade.jpg](https://learn.omacom.io/u/osaka-jade-15wLcY.jpg) + ![osaka-jade](../themes/osaka-jade/preview.png) _Osaka Jade_ - ![kanagawa.png](https://learn.omacom.io/u/kanagawa-qNhehU.png) + ![kanagawa](../themes/kanagawa/preview.png) _Kanagawa_ - ![nord.png](https://learn.omacom.io/u/nord-Rd2Y6y.png) + ![nord](../themes/nord/preview.png) _Nord_ - ![2025-07-15-193947_hyprshot.png](https://learn.omacom.io/u/2025-07-15-193947_hyprshot-b4lj4R.png) + ![matte-black](../themes/matte-black/preview.png) _Matte Black_ - ![preview.png](https://learn.omacom.io/u/preview-sQ8537.png) + ![vantablack](../themes/vantablack/preview.png) _Vantablack_ - ![ristretto-theme.png](https://learn.omacom.io/u/ristretto-theme-c99Sux.png) + ![ristretto](../themes/ristretto/preview.png) _Ristretto_ - ![preview.png](https://learn.omacom.io/u/preview-Owc1Dr.png) + ![retro-82](../themes/retro-82/preview.png) _Retro 82_ - ![flexoki-theme.png](https://learn.omacom.io/u/flexoki-theme-YaATok.png) + ![flexoki-light](../themes/flexoki-light/preview.png) _Flexoki Light_ - ![omarchy-rose-pine.png](https://learn.omacom.io/u/omarchy-rose-pine-MUH6hH.png) + ![rose-pine](../themes/rose-pine/preview.png) _Rose Pine_ - ![catppuccin-latte-theme.png](https://learn.omacom.io/u/catppuccin-latte-theme-1-jrWCjt.png) + ![catppuccin-latte](../themes/catppuccin-latte/preview.png) _Catppuccin Latte_ - ![preview.png](https://learn.omacom.io/u/preview-Vkqw3x.png) + ![white](../themes/white/preview.png) _White_ ### Unlocks Themes can also have a custom unlock design, which is used for the boot decryption process. You can select one of these under _Style > Unlock_. They look like this: - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-f99Qj5.png) + ![catppuccin](../themes/catppuccin/preview-unlock.png) _Catppuccin_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-YKXUd2.png) + ![catppuccin-latte](../themes/catppuccin-latte/preview-unlock.png) _Catppuccin Latte_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-bGBH8Q.png) + ![ethereal](../themes/ethereal/preview-unlock.png) _Ethereal_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-FlHgXd.png) + ![everforest](../themes/everforest/preview-unlock.png) _Everforest_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-BhGaEN.png) + ![flexoki-light](../themes/flexoki-light/preview-unlock.png) _Flexoki Light_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-olzWHR.png) + ![gruvbox](../themes/gruvbox/preview-unlock.png) _Gruvbox_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-Tuon1J.png) + ![hackerman](../themes/hackerman/preview-unlock.png) _Hackerman_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-gocOzZ.png) + ![kanagawa](../themes/kanagawa/preview-unlock.png) _Kanagawa_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-6q3QpH.png) + ![lumon](../themes/lumon/preview-unlock.png) _Lumon_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-nl4qCr.png) + ![matte-black](../themes/matte-black/preview-unlock.png) _Matte Black_ -![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-1eSMmK.png) +![miasma](../themes/miasma/preview-unlock.png) _Miasma_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-GTK6ej.png) + ![nord](../themes/nord/preview-unlock.png) _Nord_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-fYJ662.png) + ![osaka-jade](../themes/osaka-jade/preview-unlock.png) _Osaka Jade_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-To0aVk.png) + ![retro-82](../themes/retro-82/preview-unlock.png) _Retro 82_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-VRxFRi.png) + ![ristretto](../themes/ristretto/preview-unlock.png) _Ristretto_ -![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-H96PoE.png) +![rose-pine](../themes/rose-pine/preview-unlock.png) _Rose Pine_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-EuHzFS.png) + ![tokyo-night](../themes/tokyo-night/preview-unlock.png) _Tokyo Night_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-GDGhfQ.png) + ![vantablack](../themes/vantablack/preview-unlock.png) _Vantablack_ - ![preview-unlock.png](https://learn.omacom.io/u/preview-unlock-5kJYE8.png) + ![white](../themes/white/preview-unlock.png) _White_ diff --git a/manual/08-unified-clipboard-history.md b/manual/08-unified-clipboard-history.md index 4ec57dc6..d7a24d47 100644 --- a/manual/08-unified-clipboard-history.md +++ b/manual/08-unified-clipboard-history.md @@ -17,8 +17,8 @@ _Note that most agent harnesses will use `Ctrl + V` for pasting images, but `Sup The clipboard history is provided by the Omarchy shell and works for both text and images. You trigger it by `Super + Ctrl + V`, select your entry with return, and then that'll be placed on the clipboard ready to paste on `Super + V`. - ![clipbord-history.png](https://learn.omacom.io/u/clipbord-history-soxtYp.png) + ![clipboard-history](images/clipboard-history.webp) You can also search the history just by starting to type: - ![clipboard-history-search.png](https://learn.omacom.io/u/clipboard-history-search-S0PjCI.png) + ![clipboard-history-search](images/clipboard-history-search.webp) diff --git a/manual/09-reminders.md b/manual/09-reminders.md index 155b2169..1cfef126 100644 --- a/manual/09-reminders.md +++ b/manual/09-reminders.md @@ -2,4 +2,4 @@ Omarchy has a built-in way to set simple reminders based on a countdown timer and with a message. You can do this via `Super + Ctrl + R`, seeing all the ones set via `Super + Ctrl + Alt + R`, and clearing all via `Super + Ctrl + Shift + R`. Everything also accessible via _Trigger > Reminder_. You can also use the cli with `omarchy reminder 7 'Tea ready'`. - ![screenrecording-2026-05-08_14-35-22-720p.gif](https://learn.omacom.io/u/screenrecording-2026-05-08_14-35-22-720p-3g9dVE.gif) + ![reminders](images/reminders.webp) diff --git a/manual/10-notices.md b/manual/10-notices.md index 480e7aed..eafd25ad 100644 --- a/manual/10-notices.md +++ b/manual/10-notices.md @@ -6,13 +6,13 @@ You can quickly access the date and time, battery status, and current weather us `Super + Ctrl + Alt + T` - ![datetime-notice.png](https://learn.omacom.io/u/datetime-notice-dnB5VT.png) + ![notice-datetime](images/notice-datetime.webp) ### Weather `Super + Ctrl + Alt + W` - ![weather-notice.png](https://learn.omacom.io/u/weather-notice-MV7Jj1.png) + ![notice-weather](images/notice-weather.webp) The location is detected from your IP address, which is usually close enough, but not always. You can pin it down with `omarchy weather location --set Malibu`, or be exact about it by adding coordinates: `omarchy weather location --set Malibu 34.0259,-118.7798`. Run `omarchy weather location` on its own to see where it thinks you are, and `--clear` to go back to auto-detection. @@ -20,4 +20,4 @@ The location is detected from your IP address, which is usually close enough, bu `Super + Ctrl + Alt + B` - ![battery-notice.png](https://learn.omacom.io/u/battery-notice-jyKv9S.png) + ![notice-battery](images/notice-battery.webp) diff --git a/manual/11-text-extraction-dictation.md b/manual/11-text-extraction-dictation.md index ee96e39b..2d222a67 100644 --- a/manual/11-text-extraction-dictation.md +++ b/manual/11-text-extraction-dictation.md @@ -6,7 +6,7 @@ Hit `Super + Ctrl + PrtScr` to select a region on the screen for text extraction This is very helpful for grabbing addresses out of image footers or phone numbers embedded in website headlines. - ![text-extraction.png](https://learn.omacom.io/u/text-extraction-1x3Oe3.png) + ![text-extraction](images/text-extraction.webp) ### Dictation diff --git a/manual/12-screenshots-recording.md b/manual/12-screenshots-recording.md index 9f963ff8..9c476231 100644 --- a/manual/12-screenshots-recording.md +++ b/manual/12-screenshots-recording.md @@ -17,7 +17,7 @@ Hit `Print Screen` and the screen freezes so nothing shifts under you while you The result goes two places at once: a PNG in your pictures directory, and the clipboard, so you can paste it straight into a chat window with `Super + V`. A notification pops up with a thumbnail. Click it (or hit `Super + Alt + ,` to invoke the last notification) and the shot opens in Tensaku, the annotation editor, where you can draw arrows and boxes on it before you send it. -Files land in `~/Pictures` by default, named `screenshot-2026-08-13_14-22-05.png`. If you'd rather keep them in their own folder, set `OMARCHY_SCREENSHOT_DIR` — see [the FAQ](47-faq.md) for where to put session environment variables. Omarchy creates the directory for you if it isn't there. You can swap the editor too with `OMARCHY_SCREENSHOT_EDITOR`. +Files land in `~/Pictures` by default, named `screenshot-2026-08-13_14-22-05.png`. If you'd rather keep them in their own folder, set `OMARCHY_SCREENSHOT_DIR` — see [the FAQ](46-faq.md) for where to put session environment variables. Omarchy creates the directory for you if it isn't there. You can swap the editor too with `OMARCHY_SCREENSHOT_EDITOR`. From the terminal, `omarchy screenshot` takes the same shot, and you can be explicit about it: `omarchy capture screenshot region` for freeform only, `windows` to snap to window and monitor rectangles, or `fullscreen` to skip the picker entirely and grab the focused monitor. A second argument of `copy` puts the shot only on the clipboard, and `save` only on disk. diff --git a/manual/15-terminal.md b/manual/15-terminal.md index 07278099..8b937e7e 100644 --- a/manual/15-terminal.md +++ b/manual/15-terminal.md @@ -22,18 +22,18 @@ Because Tmux is programmable, we can use functions to create layouts. Omarchy sh So `tdl c` would start this (or just `ic`): - ![tmux-tdl-x.png](https://learn.omacom.io/u/tmux-tdl-x-dxhZe9.png) + ![tmux-tdl](images/tmux-tdl.webp) You can also start a second agent with `tdl c cx` (opencode + claude) (or just `icx`): - ![tmux-tdl2-x.png](https://learn.omacom.io/u/tmux-tdl2-x-5FoPqh.png) + ![tmux-tdl2](images/tmux-tdl2.webp) There's also `tds`, which starts a four-way square with the editor top left, a live diff watcher top right, a terminal bottom left, and opencode bottom right. You can also start this layout configuration for every subdirectory in the current directory using `tdlm [agent]`, then navigate using `alt + 1/2/3/4/5/...`: - ![tdlm-x.png](https://learn.omacom.io/u/tdlm-x-RPg6sr.png) + ![tmux-tdlm](images/tmux-tdlm.webp) Finally, you can start a swarm of agents using `tsl [panes] [command]`. So `tsl 4 c` will give you a four-way grid of opencode agents: - ![tsl-x.png](https://learn.omacom.io/u/tsl-x-SFzDeo.png) + ![tmux-tsl](images/tmux-tsl.webp) diff --git a/manual/22-guis.md b/manual/22-guis.md index 8845bb4f..f5dfa8e8 100644 --- a/manual/22-guis.md +++ b/manual/22-guis.md @@ -32,7 +32,7 @@ You start Pinta via the application launcher (`Super + Space`). ## Aether -[Aether](https://github.com/bjarneo/aether) is a theming application that can extract colors from a background image and turn them into a complete, cohesive theme. It's the easiest way to [make your own theme](44-making-your-own-theme.md). +[Aether](https://github.com/bjarneo/aether) is a theming application that can extract colors from a background image and turn them into a complete, cohesive theme. It's the easiest way to [make your own theme](43-making-your-own-theme.md). You start Aether via the application launcher (`Super + Space`). @@ -51,7 +51,7 @@ The same thing works from the terminal with `omarchy share clipboard`, `omarchy You can also send straight from the file manager: right-click any selection in Nautilus and pick _Send via LocalSend_. -Omarchy's firewall is closed by default except for LocalSend's port, so this works out of the box on a fresh install. See [security](49-security.md). +Omarchy's firewall is closed by default except for LocalSend's port, so this works out of the box on a fresh install. See [security](48-security.md). ## LibreOffice diff --git a/manual/23-browsers.md b/manual/23-browsers.md index aced842d..03548c7a 100644 --- a/manual/23-browsers.md +++ b/manual/23-browsers.md @@ -22,7 +22,7 @@ The Chromium-family browsers (Chromium itself, Chrome, Edge, and Brave) come wit **Copy URL** puts the current tab's address on your clipboard with `Alt + Shift + L`. That's faster than clicking into the address bar and copying, and because it goes through the system clipboard rather than the browser's, you get an Omarchy notification confirming it and the URL is immediately available in [clipboard history](08-unified-clipboard-history.md) and every other app. There's a toolbar button too, if you prefer clicking. -**Download Video** grabs the video playing on the page you're looking at with `Alt + Shift + D`. It hands the URL to [yt-dlp](https://github.com/yt-dlp/yt-dlp), so it works on far more than YouTube, and the download lands in `~/Videos`. Progress shows up in the same on-screen display that volume and brightness use, updating in place rather than stacking up notifications. Set `OMARCHY_YTDLP_DIR` if you'd rather the files went somewhere else — see the [FAQ](47-faq.md) for where to put environment variables. +**Download Video** grabs the video playing on the page you're looking at with `Alt + Shift + D`. It hands the URL to [yt-dlp](https://github.com/yt-dlp/yt-dlp), so it works on far more than YouTube, and the download lands in `~/Videos`. Progress shows up in the same on-screen display that volume and brightness use, updating in place rather than stacking up notifications. Set `OMARCHY_YTDLP_DIR` if you'd rather the files went somewhere else — see the [FAQ](46-faq.md) for where to put environment variables. Both extensions talk to Omarchy through a small native messaging host, which gets installed for you along with the browser. That's the piece that lets a web page's video end up in your home directory and a URL end up in your clipboard manager, which a normal extension can't do on its own. diff --git a/manual/26-gaming.md b/manual/26-gaming.md index 15975eac..12b50198 100644 --- a/manual/26-gaming.md +++ b/manual/26-gaming.md @@ -14,7 +14,7 @@ After you've installed it, you'll be able to launch Steam with `Super + Space`. Note that Steam can take 10-20 seconds to start up, and it's not going to provide any visual feedback that it's loading. - ![steam.png](https://learn.omacom.io/u/steam-tC5srj.png) + ![gaming-steam](images/gaming-steam.webp) ## RetroArch @@ -30,7 +30,7 @@ To get going: You can also give a favorite game its own entry in the app launcher with _Install > Gaming > RetroArch Game Launcher_, which lets you pick a core and a ROM, and jump straight into the game from `Super + Space`. - ![retroarch.jpg](https://learn.omacom.io/u/retroarch-wd6cuZ.jpg) + ![gaming-retroarch](images/gaming-retroarch.webp) ## Xbox Cloud Gaming @@ -38,13 +38,13 @@ Install the Xbox Cloud Gaming web app by selecting _Install > Gaming > Xbox Clou If you already have Xbox Game Pass, this is a solid way to play Fortnite and other titles you can't run natively on Linux. - ![xbox-cloud.jpg](https://learn.omacom.io/u/xbox-cloud-vEuyin.jpg) + ![gaming-xbox-cloud](images/gaming-xbox-cloud.webp) ## NVIDIA GeForce Now Install the cloud-gaming service [NVIDIA GeForce NOW](https://www.nvidia.com/en-us/geforce-now/) by selecting _Install > Gaming > NVIDIA GeForce NOW_ from the Omarchy menu (`Super + Space`). Another great way to play titles that aren't available natively on Linux. - ![screenshot-2026-05-05_09-00-11-medium.jpg](https://learn.omacom.io/u/screenshot-2026-05-05_09-00-11-medium-tSjM9x.jpg) + ![gaming-geforce-now](images/gaming-geforce-now.webp) ## Minecraft @@ -52,7 +52,7 @@ Install Minecraft by selecting _Install > Gaming > Minecraft_ from the Omarchy m Like Steam, note that it can take a while after logging in or starting up for the next screen to appear, and you're not going to get any feedback while you're waiting. - ![screenshot-2026-05-05_09-02-39-medium.jpg](https://learn.omacom.io/u/screenshot-2026-05-05_09-02-39-medium-Vapoct.jpg) + ![gaming-minecraft](images/gaming-minecraft.webp) ## Xbox Controllers @@ -70,7 +70,7 @@ You can also turn an Omarchy machine into the host by running `omarchy install s Install [Battle.net](https://eu.shop.battle.net/en-us) by selecting _Install > Gaming > Battle.net_ from the Omarchy menu (`Super + Space`). This gives you titles like Diablo, Starcraft, and World of Warcraft as a standalone install running under GE-Proton — no Steam, Lutris, or Heroic needed. - ![starcraft.png](https://learn.omacom.io/u/starcraft-WU9zw7.png) + ![gaming-starcraft](images/gaming-starcraft.webp) ## Lutris (Windows games) diff --git a/manual/28-windows-vm.md b/manual/28-windows-vm.md index f2a7ff46..c7b534c6 100644 --- a/manual/28-windows-vm.md +++ b/manual/28-windows-vm.md @@ -6,7 +6,7 @@ Your machine needs KVM virtualization for this, which most do — but it's somet The installer asks how much RAM, how many CPU cores, and how much disk to hand over (64GB or more is the sensible floor), then for a Windows username and password. Leave those blank and you get `docker` / `admin`. The download takes a while — 10-15 minutes is normal — and you can follow the progress in the browser at `http://127.0.0.1:8006`. - ![windows.png](https://learn.omacom.io/u/windows-bhXSXL.png) + ![windows-vm](images/windows-vm.webp) ## Using it diff --git a/manual/30-updates.md b/manual/30-updates.md index 70391d6e..246138c3 100644 --- a/manual/30-updates.md +++ b/manual/30-updates.md @@ -6,7 +6,7 @@ Omarchy itself is installed as regular pacman packages from the [Omarchy Package When new releases are made, a circle arrow icon will appear to the right of your clock. Click it and the update process will start. -![screenshot-2025-09-28_19-06-08.png](https://learn.omacom.io/u/screenshot-2025-09-28_19-06-08-yZI06N.png) +![update-available](images/update-available.webp) ### Four channels @@ -32,6 +32,6 @@ If you're already familiar with Arch, you might be tempted to just run `pacman - If you ever have a problem after doing an update, you can rollback your system to the snapshot taken before the update. Just restart and pick the snapshot in the boot loading menu from before you started the update. -![omarchy-bootloader.png](https://learn.omacom.io/u/omarchy-bootloader-EVTCUU.png) +![bootloader](images/bootloader.webp) If somehow your configuration files have been corrupted, you can also perform an Omarchy reinstall using `omarchy reinstall` in the terminal. This will reinstall all the default Omarchy packages, put you on stable and downgrade any packages that are too new, and reset all the configuration files. Note that all your user config changes to the Omarchy defaults will be overwritten doing this! diff --git a/manual/35-networking.md b/manual/35-networking.md index 96755129..1c4b063c 100644 --- a/manual/35-networking.md +++ b/manual/35-networking.md @@ -30,7 +30,7 @@ _Trigger > Speed Test > Network Speed Test_ measures your actual up and down spe The firewall is on by default and blocks all incoming traffic, with one exception: port 53317, so [LocalSend](22-guis.md) works out of the box. -SSH is off until you turn it on with _Setup > Security > SSHD_, which starts the daemon, opens port 22 rate-limited against brute force, and authorizes a key. Docker is locked down too, so containers can't accidentally expose themselves to the world. See [security](49-security.md) for the whole story. +SSH is off until you turn it on with _Setup > Security > SSHD_, which starts the daemon, opens port 22 rate-limited against brute force, and authorizes a key. Docker is locked down too, so containers can't accidentally expose themselves to the world. See [security](48-security.md) for the whole story. ## Tailscale @@ -42,4 +42,4 @@ Installing it also adds a web app for the Tailscale admin console. ## When it stops working -Before rebooting, try restarting the offending piece on its own. _Update > Hardware_ has Wi-Fi, Bluetooth, Audio, and Trackpad, and reloading one of those clears up most "it worked five minutes ago" situations. See [troubleshooting](46-troubleshooting.md). +Before rebooting, try restarting the offending piece on its own. _Update > Hardware_ has Wi-Fi, Bluetooth, Audio, and Trackpad, and reloading one of those clears up most "it worked five minutes ago" situations. See [troubleshooting](45-troubleshooting.md). diff --git a/manual/38-fonts.md b/manual/38-fonts.md index 4e4016f3..1b947a79 100644 --- a/manual/38-fonts.md +++ b/manual/38-fonts.md @@ -2,7 +2,7 @@ Omarchy uses JetBrainsMono Nerd Font as both the terminal and system font by default. - ![jetbrainsmono.jpg](https://learn.omacom.io/u/jetbrainsmono-lhatXs.jpg) + ![fonts-jetbrainsmono](images/fonts-jetbrainsmono.webp) You can change this through the _Style > Font_ menu in the Omarchy menu (`Super + Space`). That sets the monospace font everywhere: the terminal, the bar, and anything else that asks for it. diff --git a/manual/40-prompt.md b/manual/40-prompt.md index 4be1b5f7..dc111bd0 100644 --- a/manual/40-prompt.md +++ b/manual/40-prompt.md @@ -2,6 +2,6 @@ Omarchy ships with a minimal [Starship](https://starship.rs/) prompt by default. That's how I like to keep my prompt. I don't need to know the user, because it's always me, and I don't need to know the time, because it's always at the top. - ![omarchy-prompt.png](https://learn.omacom.io/u/omarchy-prompt-J4UHpS.png) + ![prompt](images/prompt.webp) If you want more information or style, you can change the [Starship.rs](https://starship.rs/) configuration in `~/.config/starship.toml`. There's a lot you can do. Just don't go overboard (or do go overboard, do whatever you want, it's your computer!) diff --git a/manual/41-branding.md b/manual/41-branding.md index 59c0da4f..6121d3da 100644 --- a/manual/41-branding.md +++ b/manual/41-branding.md @@ -12,13 +12,13 @@ omarchy plymouth preview '#1d2021' '#ebdbb2' logo.png preview.png Then apply the setup with `omarchy plymouth set '#1d2021' '#ebdbb2' logo.png`, which will also give the SDDM login screen the same colors and logo. If you want to revert, you can use `omarchy plymouth reset`. - ![shopify-plymouth.jpeg](https://learn.omacom.io/u/shopify-plymouth-AjqlgW.jpeg) + ![branding-plymouth-shopify](images/branding-plymouth-shopify.webp) ### Screensaver You can change the logo used for the screensaver under _Style > Screensaver_. It's an ASCII logo, so you can edit the text directly, but you can also hand it a png or svg image, and we'll convert that to ASCII. It looks pretty cool. - ![screensaver.gif](https://learn.omacom.io/u/screensaver-xDOE2Y.gif) + ![branding-screensaver](images/branding-screensaver.webp) There are three entries in that menu: @@ -30,7 +30,7 @@ There are three entries in that menu: The same three options are under _Style > About_ for the _About_ screen you get from the Omarchy menu, and they work identically — the file is `~/.config/omarchy/branding/about.txt`, and the About window pops up after each change. The About art is converted to a smaller size than the screensaver's, since it has to fit in a window rather than fill your display. - ![about.png](https://learn.omacom.io/u/about-wi4tkl.png) + ![branding-about](images/branding-about.webp) ### Converting images yourself diff --git a/manual/43-extra-themes.md b/manual/43-extra-themes.md deleted file mode 100644 index fa462aca..00000000 --- a/manual/43-extra-themes.md +++ /dev/null @@ -1,345 +0,0 @@ -# Extra themes - -You can install any of these themes by copying the GitHub URL and selecting `Install > Style > Theme` via the Omarchy menu (`Super + Space`). If you want to remove it again, just use `Remove > Theme` and select it there. - - ![aetheria.png](https://learn.omacom.io/u/aetheria-jaDcHN.png) -[Aetheria](https://github.com/JJDizz1L/aetheria) - - ![amberbyte.png](https://learn.omacom.io/u/amberbyte-gevf2N.png) -[Amberbyte](https://github.com/tahfizhabib/omarchy-amberbyte-theme) - - ![arc-blueberry.png](https://learn.omacom.io/u/arc-blueberry-e64rOP.png) -[Arc Blueberry](https://github.com/vale-c/omarchy-arc-blueberry) - - ![archwave.png](https://learn.omacom.io/u/archwave-ogNCX2.png) -[Archwave](https://github.com/davidguttman/archwave) - - ![ash-theme.png](https://learn.omacom.io/u/ash-theme-DnGpEy.png) -[Ash](https://github.com/bjarneo/omarchy-ash-theme) - - ![artzen.png](https://learn.omacom.io/u/artzen-ddIz8i.png) -[Artzen](https://github.com/tahfizhabib/omarchy-artzen-theme) - - ![aura-theme.png](https://learn.omacom.io/u/aura-theme-LfFuUo.png) -[Aura](https://github.com/bjarneo/omarchy-aura-theme) - - ![all-hallows-eve-theme.webp](https://learn.omacom.io/u/all-hallows-eve-theme-XQuTDB.webp) -[All Hallow's Eve](https://github.com/guilhermetk/omarchy-all-hallows-eve-theme) - - ![atelier.png](https://learn.omacom.io/u/atelier-L2xcft.png) -[Atelier](https://github.com/atif-1402/omarchy-atelier-theme) - - ![ayaka.png](https://learn.omacom.io/u/ayaka-FcJ4UP.png) -[Ayaka](https://github.com/abhijeet-swami/omarchy-ayaka-theme) - - ![azure-glow-theme.png](https://learn.omacom.io/u/azure-glow-theme-vLp53z.png) -[Azure Glow](https://github.com/Hydradevx/omarchy-azure-glow-theme) - - ![batman.png](https://learn.omacom.io/u/batman-ec0yWD.png) -[Batman](https://github.com/OldJobobo/omarchy-batman-theme) - - ![batou.png](https://learn.omacom.io/u/batou-pCugc6.png) -[Batou](https://github.com/HANCORE-linux/omarchy-batou-theme) - - ![bauhaus.png](https://learn.omacom.io/u/bauhaus-ZDRJnD.png) -[Bauhaus](https://github.com/somerocketeer/omarchy-bauhaus-theme) - - ![biscuit.png](https://learn.omacom.io/u/biscuit-5ZFemm.png) -[Biscuit de Mar Dark](https://github.com/OldJobobo/omarchy-biscuit-de-mar-dark-theme) - - ![black-arch.png](https://learn.omacom.io/u/black-arch-gveh1G.png) -[Black Arch](https://github.com/ankur311sudo/black_arch) - -![black-gold.png](https://learn.omacom.io/u/black-gold-qUepi7.png) -[Black Gold](https://github.com/HANCORE-linux/omarchy-blackgold-theme) - - ![black-turq.png](https://learn.omacom.io/u/black-turq-YQQZhg.png) -[Black Turq](https://github.com/HANCORE-linux/omarchy-blackturq-theme) - - ![bluedotrb.png](https://learn.omacom.io/u/bluedotrb-D9Cqtr.png) -[bluedotrb](https://github.com/dotsilva/omarchy-bluedotrb-theme) - - ![blueridge-theme.png](https://learn.omacom.io/u/blueridge-theme-fkB0tl.png) -[Blue Ridge Dark](https://github.com/hipsterusername/omarchy-blueridge-dark-theme) - - ![catppuccin-mocha-dark.png](https://learn.omacom.io/u/catppuccin-mocha-dark-mNVF5H.png) -[Catppuccin Mocha Dark](https://github.com/Luquatic/omarchy-catppuccin-dark) - - ![citrus-cynapse.png](https://learn.omacom.io/u/citrus-cynapse-9rtDDg.png) -[Citrus Cynapse](https://github.com/Grey-007/citrus-cynapse) - - ![city-783.png](https://learn.omacom.io/u/city-783-7xHciV.png) -[City-783](https://github.com/OldJobobo/omarchy-city-783-theme) - - ![cobalt2.png](https://learn.omacom.io/u/cobalt2-RGgNWQ.png) -[Cobalt2](https://github.com/hoblin/omarchy-cobalt2-theme) - - ![cpunk.png](https://learn.omacom.io/u/cpunk-hcNDrl.png) -[CpUnk](https://github.com/stannorbvb-cmd/cpunk) - - ![darcula.png](https://learn.omacom.io/u/darcula-boUMqL.png) -[Darcula](https://github.com/noahljungberg/omarchy-darcula-theme) - - ![demon.png](https://learn.omacom.io/u/demon-b0AEYS.png) -[Demon](https://github.com/HANCORE-linux/omarchy-demon-theme) - - ![dotrb.png](https://learn.omacom.io/u/dotrb-Ev8dB3.png) -[Dotrb](https://github.com/dotsilva/omarchy-dotrb-theme) - - ![dos-moos.png](https://learn.omacom.io/u/dos-moos-GGqdkw.png) -[Dos Moos](https://github.com/HANCORE-linux/omarchy-dos-moos-theme) - - ![drac.png](https://learn.omacom.io/u/drac-jUSHEO.png) -[Drac](https://github.com/ShehabShaef/omarchy-drac-theme) - - ![dracula-theme.png](https://learn.omacom.io/u/dracula-theme-Rq2gWj.png) -[Dracula](https://github.com/catlee/omarchy-dracula-theme) - - ![eldritch.png](https://learn.omacom.io/u/eldritch-6rfAov.png) -[Eldritch](https://github.com/eldritch-theme/omarchy) - - ![event-horizon.png](https://learn.omacom.io/u/event-horizon-c8ryZU.png) -[Event Horizon](https://github.com/OldJobobo/omarchy-event-horizon-theme) - - ![evergarden.png](https://learn.omacom.io/u/evergarden-euPINv.png) -[Evergarden](https://github.com/celsobenedetti/omarchy-evergarden) - - ![felix-theme.png](https://learn.omacom.io/u/felix-theme-vk8Fgx.png) -[Felix](https://github.com/TyRichards/omarchy-felix-theme) - - ![fireside.png](https://learn.omacom.io/u/fireside-3NyKEj.png) -[Fireside](https://github.com/bjarneo/omarchy-fireside-theme) - - ![flat-dracula.png](https://learn.omacom.io/u/flat-dracula-UDlJ2T.png) -[Flat Dracula](https://github.com/OldJobobo/omarchy-flat-dracula-theme) - - ![flexoki-dark-theme.png](https://learn.omacom.io/u/flexoki-dark-theme-meZCr4.png) -[Flexoki Dark](https://github.com/euandeas/omarchy-flexoki-dark-theme) - - ![forest-green.png](https://learn.omacom.io/u/forest-green-hYkgXb.png) -[Forest Green](https://github.com/abhijeet-swami/omarchy-forest-green-theme) - - ![frost.png](https://learn.omacom.io/u/frost-zu4B6C.png) -[Frost](https://github.com/bjarneo/omarchy-frost-theme) - - ![futurism-theme.png](https://learn.omacom.io/u/futurism-theme-2w6HZI.png) -[Futurism](https://github.com/bjarneo/omarchy-futurism-theme) - - ![ghost-pastel.png](https://learn.omacom.io/u/ghost-pastel-ZgK0Ne.png) -[Ghost Pastel](https://github.com/row-huh/omarchy-ghost-pastel-theme) - -![goldrush.png](https://learn.omacom.io/u/goldrush-bzSWXn.png) -[Gold Rush](https://github.com/tahayvr/omarchy-gold-rush-theme) - - ![Golden-brown.png](https://learn.omacom.io/u/golden-brown-LcSn39.png) -[Golden Brown](https://github.com/atif-1402/omarchy-golden-brown-theme) - - ![thegreek.png](https://learn.omacom.io/u/thegreek-rPS5HB.png) -[The Greek](https://github.com/HANCORE-linux/omarchy-thegreek-theme) - - ![greek-noir.png](https://learn.omacom.io/u/greek-noir-u9xqyi.png) -[Greek Noir](https://github.com/HANCORE-linux/omarchy-greek-noir-theme) - -![omarchy-lush-green.png](https://learn.omacom.io/u/omarchy-lush-green-fZgXeQ.png) -[Green Garden](https://github.com/kalk-ak/omarchy-green-garden-theme) - - ![gruvu.png](https://learn.omacom.io/u/gruvu-wYS1LM.png) -[Gruvu](https://github.com/ankur311sudo/gruvu) - - ![harbor.png](https://learn.omacom.io/u/harbor-FYmTgs.png) -[Harbor](https://github.com/HANCORE-linux/omarchy-harbor-theme) - - ![harbor-dark.png](https://learn.omacom.io/u/harbor-dark-tLwJe3.png) -[Harbor Dark](https://github.com/HANCORE-linux/omarchy-harbordark-theme) - - ![hinterlands.png](https://learn.omacom.io/u/hinterlands-nh7aFP.png) -[Hinterlands](https://github.com/OldJobobo/omarchy-hinterlands-theme) - - ![infernium.png](https://learn.omacom.io/u/infernium-jTFC59.png) -[Infernium](https://github.com/RiO7MAKK3R/omarchy-infernium-dark-theme) - - ![inky-pink.png](https://learn.omacom.io/u/inky-pink-VoKwwC.png) -[Inky Pinky](https://github.com/HANCORE-linux/omarchy-inkypinky-theme) - - ![last-horizon.png](https://learn.omacom.io/u/last-horizon-YLrE41.png) -[Last Horizon](https://github.com/HANCORE-linux/omarchy-lasthorizon-theme) - - ![mapquest.png](https://learn.omacom.io/u/mapquest-WsJvyQ.png) -[Map Quest](https://github.com/ItsABigIgloo/omarchy-mapquest-theme) - - ![mars-theme.png](https://learn.omacom.io/u/mars-theme-r03GXm.png) -[Mars](https://github.com/steve-lohmeyer/omarchy-mars-theme) - - ![mechanoonna.png](https://learn.omacom.io/u/mechanoonna-DNCESY.png) -[Mechanoonna](https://github.com/HANCORE-linux/omarchy-mechanoonna-theme) - - ![miasma.png](https://learn.omacom.io/u/miasma-FCluYv.png) -[Miasma](https://github.com/OldJobobo/omarchy-miasma-theme) - -![midnight-theme.png](https://learn.omacom.io/u/midnight-theme-I5HKym.png) -[Midnight](https://github.com/JaxonWright/omarchy-midnight-theme) - - ![milkymatcha-theme.png](https://learn.omacom.io/u/milkymatcha-theme-JFT2X2.png) -[Milky Matcha](https://github.com/hipsterusername/omarchy-milkmatcha-light-theme) - - ![monochrome-theme.png](https://learn.omacom.io/u/monochrome-theme-GwATD6.png) -[Monochrome](https://github.com/Swarnim114/omarchy-monochrome-theme) - - ![monokai.png](https://learn.omacom.io/u/monokai-UoJwdC.png) -[Monokai](https://github.com/bjarneo/omarchy-monokai-theme) - - ![moodpeak.png](https://learn.omacom.io/u/moodpeak-CCiNoe.png) -[Moodpeak](https://github.com/HANCORE-linux/omarchy-moodpeak-theme) - - ![nagai-poolside.png](https://learn.omacom.io/u/nagai-poolside-twaJTF.png) -[Nagai Poolside](https://github.com/somerocketeer/omarchy-nagai-poolside-theme) - - ![neo-sploosh.png](https://learn.omacom.io/u/neo-sploosh-JWbVVa.png) -[Neo Sploosh](https://github.com/monoooki/omarchy-neo-sploosh-theme) - - ![neovoid.png](https://learn.omacom.io/u/neovoid-fVklHO.png) -[Neovoid](https://github.com/RiO7MAKK3R/omarchy-neovoid-theme) - - ![nes-theme.png](https://learn.omacom.io/u/nes-theme-1Z6uqG.png) -[NES](https://github.com/bjarneo/omarchy-nes-theme) - - ![omacarchy.png](https://learn.omacom.io/u/omacarchy-QPQF1d.png) -[Omacarchy](https://github.com/RiO7MAKK3R/omarchy-omacarchy-theme) - - ![one-dark-pro.png](https://learn.omacom.io/u/one-dark-pro-lm5SO2.png) -[One Dark Pro](https://github.com/sc0ttman/omarchy-one-dark-pro-theme) - - ![oxocarbon.png](https://learn.omacom.io/u/oxocarbon-3C2AtT.png) -[Oxo Carbon](https://github.com/HANCORE-linux/omarchy-oxocarbon-theme) - - ![pandora.png](https://learn.omacom.io/u/pandora-WwROvb.png) -[Pandora](https://github.com/imbypass/omarchy-pandora-theme) - - ![pina.png](https://learn.omacom.io/u/pina-0TNGvx.png) -[Pina](https://github.com/bjarneo/omarchy-pina-theme) - - ![pink-blood.png](https://learn.omacom.io/u/pink-blood-Fh9voH.png) -[Pink Blood](https://github.com/ITSZXY/pink-blood-omarchy-theme) - - ![pulsar-theme.png](https://learn.omacom.io/u/pulsar-theme-DMUX7U.png) -[Pulsar](https://github.com/bjarneo/omarchy-pulsar-theme) - - ![purple-moon.png](https://learn.omacom.io/u/purple-moon-S9IiCU.png) -[Purple Moon](https://github.com/Grey-007/purple-moon) - - ![purplewave.png](https://learn.omacom.io/u/purplewave-ZGiAbQ.png) -[Purplewave](https://github.com/dotsilva/omarchy-purplewave-theme) - - ![rainynight.png](https://learn.omacom.io/u/rainynight-auQymU.png) -[Rainy Night](https://github.com/atif-1402/omarchy-rainynight-theme) - - ![red-monarch.png](https://learn.omacom.io/u/red-monarch-VYuVL2.png) -[Red Monarch](https://github.com/kamatealif/omarchy-red-monarch-theme) - - ![retro-82.png](https://learn.omacom.io/u/retro-82-pegjCg.png) -[Retro 82](https://github.com/OldJobobo/omarchy-retro-82-theme) - - ![retropc-theme.png](https://learn.omacom.io/u/retropc-theme-a24vKN.png) -[RetroPC](https://github.com/rondilley/omarchy-retropc-theme) - - ![ristretto-light.png](https://learn.omacom.io/u/ristretto-light-IcJFUF.png) -[Ristretto Light](https://github.com/brokkoli71/omarchy-ristretto-light-theme) - - ![robzee84.png](https://learn.omacom.io/u/robzee84-N1hj0E.png) -[RobZee84](https://github.com/robzolkos/omarchy-robzee84-theme) - - ![rose-pine-dark.webp](https://learn.omacom.io/u/rose-pine-dark-pIMUcV.webp) -[Rose Pine Dark](https://github.com/guilhermetk/omarchy-rose-pine-dark) - - ![rose-of-dune.png](https://learn.omacom.io/u/rose-of-dune-bX5Vhf.png) -[Rose of Dune](https://github.com/HANCORE-linux/omarchy-roseofdune-theme) - - ![ryu.png](https://learn.omacom.io/u/ryu-9OnK9B.png) -[Ryu](https://github.com/HANCORE-linux/omarchy-ryu-theme) - - ![sakura.png](https://learn.omacom.io/u/sakura-njsB9m.png) -[Sakura](https://github.com/bjarneo/omarchy-sakura-theme) - - ![sakura-mochi.png](https://learn.omacom.io/u/sakura-mochi-Um17iV.png) -[Sakura Mochi](https://github.com/OldJobobo/omarchy-sakura-mochi-theme) - - ![saga.png](https://learn.omacom.io/u/saga-4taZZI.png) -[Saga](https://github.com/HANCORE-linux/omarchy-saga-theme) - - ![sapphire.png](https://learn.omacom.io/u/sapphire-tocQNg.png) -[Sapphire](https://github.com/HANCORE-linux/omarchy-sapphire-theme) - - ![shades-of-jade.png](https://learn.omacom.io/u/shades-of-jade-uSYodf.png) -[Shades of Jade](https://github.com/HANCORE-linux/omarchy-shadesofjade-theme) - - ![space-monkey-theme.jpg](https://learn.omacom.io/u/space-monkey-theme-UGmUHp.jpg) -[Space Monkey](https://github.com/TyRichards/omarchy-space-monkey-theme/) - - ![snow-theme.png](https://learn.omacom.io/u/snow-theme-MDtvlu.png) -[Snow](https://github.com/bjarneo/omarchy-snow-theme) - - ![snow-black.png](https://learn.omacom.io/u/snow-black-LXbCcU.png) -[Snow Black](https://github.com/ankur311sudo/snow_black) - - ![solarized-theme.png](https://learn.omacom.io/u/solarized-theme-9OhQ7Y.png) -[Solarized](https://github.com/Gazler/omarchy-solarized-theme) - - ![solarized-light2.png](https://learn.omacom.io/u/solarized-light2-OTGWbc.png) -[Solarized Light](https://github.com/dfrico/omarchy-solarized-light-theme) - - ![solarized-osaka-theme.png](https://learn.omacom.io/u/solarized-osaka-theme-9pnXgG.png) -[Solarized Osaka](https://github.com/motorsss/omarchy-solarizedosaka-theme) - - ![solitude.png](https://learn.omacom.io/u/solitude-gJpmBW.png) -[Solitude](https://github.com/HANCORE-linux/omarchy-solitude-theme) - - ![sunset.png](https://learn.omacom.io/u/sunset-PsLG4m.png) -[Sunset](https://github.com/rondilley/omarchy-sunset-theme) - - ![sunsetdrive.png](https://learn.omacom.io/u/sunsetdrive-UV9Gss.png) -[Sunset Drive](https://github.com/tahayvr/omarchy-sunset-drive-theme) - - ![super-game-bro-theme.png](https://learn.omacom.io/u/super-game-bro-theme-2DNtSt.png) -[Super Game Bro](https://github.com/TyRichards/omarchy-super-game-bro-theme) - -![synthwave-theme.png](https://learn.omacom.io/u/synthwave-theme-7yHWFA.png) -[Synthwave '84](https://github.com/omacom-io/omarchy-synthwave84-theme/) - - ![Temerald.png](https://learn.omacom.io/u/temerald-aTOeZ9.png) -[Temerald](https://github.com/Ahmad-Mtr/omarchy-temerald-theme) - - ![tokyo-night-oled.png](https://learn.omacom.io/u/tokyo-night-oled-nTsHOs.png) -[Tokyo Night OLED](https://github.com/Justin-De-Sio/omarchy-tokyoled-theme) - - ![tycho.png](https://learn.omacom.io/u/tycho-vTGePC.png) -[Tycho](https://github.com/leonardobetti/omarchy-tycho) - - ![waffle-cat.png](https://learn.omacom.io/u/waffle-cat-SSnrsG.png) -[Waffle Cat](https://github.com/OldJobobo/omarchy-waffle-cat-theme) - -![waveform-theme.png](https://learn.omacom.io/u/waveform-theme-ZiWq97.png) -[Waveform Dark](https://github.com/hipsterusername/omarchy-waveform-dark-theme) - - ![whitegold.png](https://learn.omacom.io/u/whitegold-HGrllY.png) -[White Gold](https://github.com/HANCORE-linux/omarchy-whitegold-theme) - - ![windows-dark-mode.png](https://learn.omacom.io/u/windows-dark-mode-5MIFmi.png) -[Windows Dark Mode](https://github.com/oldjobobo/omarchy-windows-dark-mode-theme) - - ![van-gogh.png](https://learn.omacom.io/u/van-gogh-bwoogF.png) -[Van Gogh](https://github.com/Nirmal314/omarchy-van-gogh-theme) - - ![velvet-night.png](https://learn.omacom.io/u/velvet-night-tGkahY.png) -[Velvet Night](https://github.com/HANCORE-linux/omarchy-velvetnight-theme) - - ![venice.png](https://learn.omacom.io/u/venice-5IEmB6.png) -[Venice from Above](https://github.com/mattbbia/venice-from-above-omarchy) - - ![vesper.png](https://learn.omacom.io/u/vesper-1tdScF.png) -[Vesper](https://github.com/thmoee/omarchy-vesper-theme) - - ![vhs80.png](https://learn.omacom.io/u/vhs80-8MnZ4x.png) -[VHS 80](https://github.com/tahayvr/omarchy-vhs80-theme) - - ![void.png](https://learn.omacom.io/u/void-Q9aUIc.png) -[Void](https://github.com/vyrx-dev/omarchy-void-theme) diff --git a/manual/44-making-your-own-theme.md b/manual/43-making-your-own-theme.md similarity index 95% rename from manual/44-making-your-own-theme.md rename to manual/43-making-your-own-theme.md index 113d48f0..e3e902a7 100644 --- a/manual/44-making-your-own-theme.md +++ b/manual/43-making-your-own-theme.md @@ -28,4 +28,4 @@ There's a fully commented `alacritty.toml.tpl.sample` in that folder to copy fro If you want to distribute your theme so others can use it, you need to put it on a public git server, like GitHub. Then people can install it using _Install > Style > Theme_ in the Omarchy menu using that URL. It's recommended that you follow the naming convention of `omarchy-[themename]-theme`, as the theme will show correctly as just `[themename]` in the theme selection menu after installation. -You can have your theme added to [the extra themes page](43-extra-themes.md) by pinging @tahayvr on [the #omarchy Discord](https://discord.gg/tXFUdasqhY). +You can have your theme added to the extra themes list by pinging @tahayvr on [the #omarchy Discord](https://discord.gg/tXFUdasqhY). diff --git a/manual/45-mac-support.md b/manual/44-mac-support.md similarity index 97% rename from manual/45-mac-support.md rename to manual/44-mac-support.md index 7b56ac6c..e86fdd06 100644 --- a/manual/45-mac-support.md +++ b/manual/44-mac-support.md @@ -6,7 +6,7 @@ Please note that installing on an M-series Mac is not directly supported at this In a simple test, we were able to achieve 36% performance gains on a 2019 MacBook Pro just by installing Omarchy. - ![G0-1NXRWQAAn_IH.jpeg](https://learn.omacom.io/u/g0-1nxrwqaan_ih-nOdzdG.jpeg) + ![macbook-omarchy](images/macbook-omarchy.webp) ### Installing Omarchy on Mac diff --git a/manual/46-troubleshooting.md b/manual/45-troubleshooting.md similarity index 95% rename from manual/46-troubleshooting.md rename to manual/45-troubleshooting.md index 8419efe9..b308e69f 100644 --- a/manual/46-troubleshooting.md +++ b/manual/45-troubleshooting.md @@ -2,7 +2,7 @@ ### I broke my system with an update! -First try to [rollback your system](48-system-snapshots.md) the version before your recent update. If that doesn't work, use `omarchy-debug` to share with your problem on #omarchy-help in the Discord. And if all that fails, you can reinstall the defaults configs and packages using `omarchy-reinstall`. +First try to [rollback your system](47-system-snapshots.md) the version before your recent update. If that doesn't work, use `omarchy-debug` to share with your problem on #omarchy-help in the Discord. And if all that fails, you can reinstall the defaults configs and packages using `omarchy-reinstall`. ### Why are some apps so large on my display? @@ -44,6 +44,6 @@ This can happen for 2 reasons: In order for the rich approval prompt to appear, Settings > Advanced > Use Hardware Acceleration must be turned on. _Note: This requires a reboot to begin working._ - ![1pw-hw-accel.png](https://learn.omacom.io/u/1pw-hw-accel-w6VzWp.png) + ![troubleshooting-1password](images/troubleshooting-1password.webp) Or if you haven't launched 1Password since booting up, the prompt will not appear. diff --git a/manual/47-faq.md b/manual/46-faq.md similarity index 98% rename from manual/47-faq.md rename to manual/46-faq.md index b8114558..65e1f2e7 100644 --- a/manual/47-faq.md +++ b/manual/46-faq.md @@ -76,4 +76,4 @@ Or run _Remove > Preinstalls_ to sweep out all the preinstalled extras — web a --- -For errors and broken bits, see [the Troubleshooting section](46-troubleshooting.md). +For errors and broken bits, see [the Troubleshooting section](45-troubleshooting.md). diff --git a/manual/48-system-snapshots.md b/manual/47-system-snapshots.md similarity index 91% rename from manual/48-system-snapshots.md rename to manual/47-system-snapshots.md index c0a9ae4a..02f592f1 100644 --- a/manual/48-system-snapshots.md +++ b/manual/47-system-snapshots.md @@ -6,11 +6,11 @@ To boot and restore a snapshot, you select it from the Limine boot loader. (If y From that screen, choose the snapshot you'd like to boot into based on the date and version. The version of Omarchy at the time of the snapshot can be seen at the bottom left corner. - ![omarchy-bootloader.png](https://learn.omacom.io/u/omarchy-bootloader-Qz7kQ1.png) + ![snapshots-bootloader](images/snapshots-bootloader.webp) When you arrive inside, a notification will popup notifying you that you're in a bootable snapshot and if you click it, will start the restoration process. Alternatively, you can utilize `omarchy-snapshot restore`. - ![omarchy-restore-snapshot.png](https://learn.omacom.io/u/omarchy-restore-snapshot-2TrMhj.png) + ![snapshots-restore](images/snapshots-restore.webp) This will restore your root filesystem, but not your `/home`. So it works for reverting a broken system update, but not for recovering lost personal files. diff --git a/manual/49-security.md b/manual/48-security.md similarity index 100% rename from manual/49-security.md rename to manual/48-security.md diff --git a/manual/50-omarchy-on.md b/manual/49-omarchy-on.md similarity index 100% rename from manual/50-omarchy-on.md rename to manual/49-omarchy-on.md diff --git a/manual/51-dual-boot-install.md b/manual/50-dual-boot-install.md similarity index 73% rename from manual/51-dual-boot-install.md rename to manual/50-dual-boot-install.md index bca9a9a6..a17072c3 100644 --- a/manual/51-dual-boot-install.md +++ b/manual/50-dual-boot-install.md @@ -8,28 +8,28 @@ This installation method still comes with LUKS encryption for the partition by d To install alongside Windows, type `disk management` in the start menu and select the option for **Create and format hard disk partitions**. - ![screenshot-2026-06-06_13-37-28.png](https://learn.omacom.io/u/screenshot-2026-06-06_13-37-28-mjjTRj.png) + ![dual-boot-1](images/dual-boot-1.webp) Find the appropriate partition, right click, and choose **Shrink Volume**. -![screenshot-2026-06-06_13-37-50.png](https://learn.omacom.io/u/screenshot-2026-06-06_13-37-50-xqulDe.png) +![dual-boot-2](images/dual-boot-2.webp) Input the amount you'd like to shrink the volume by. Note that this will be the size of your future Omarchy install inclusive of the boot partition. - ![screenshot-2026-06-06_13-38-23.png](https://learn.omacom.io/u/screenshot-2026-06-06_13-38-23-bsMeTK.png) + ![dual-boot-3](images/dual-boot-3.webp) When you're finished, you should see something like this where the 50GB section is where we'll install Omarchy in this example. - ![screenshot-2026-06-06_13-38-36.png](https://learn.omacom.io/u/screenshot-2026-06-06_13-38-36-LjrgYW.png) + ![dual-boot-4](images/dual-boot-4.webp) ## Installing Omarchy The install process for Omarchy is effectively the same as normal. After you select your disk, you'll be given the option of **Free space install**. Select that option to prevent wiping the full disk. - ![screenshot-2026-08-12_20-21-05.png](https://learn.omacom.io/u/screenshot-2026-08-12_20-21-05-MiHt03.png) + ![dual-boot-5](images/dual-boot-5.webp) Confirm that everything looks good and wait for the install to finish like normal. This is also where you could elect to install unencrypted (not recommended) just like on a full-drive install. - ![screenshot-2026-08-12_20-33-49.png](https://learn.omacom.io/u/screenshot-2026-08-12_20-33-49-UX0gZl.png) + ![dual-boot-6](images/dual-boot-6.webp) ## Adding Other Installs to the Bootloader @@ -41,4 +41,4 @@ In order to do that, run `limine-scan` and follow the prompts to add whichever i It's important to note that this install method is not compatible with Bitlocker as it encrypts the entire drive, not just the partition. If you encounter an error stating that Bitlocker is enabled, boot to Windows, go to **Settings -> Privacy & Security -> Device encryption** and toggle Bitlocker off. It may take some time to decrypt the drive. - ![screenshot-2026-08-12_20-28-27.png](https://learn.omacom.io/u/screenshot-2026-08-12_20-28-27-jdscbY.png) + ![dual-boot-7](images/dual-boot-7.webp) diff --git a/manual/52-unattended-installs.md b/manual/51-unattended-installs.md similarity index 100% rename from manual/52-unattended-installs.md rename to manual/51-unattended-installs.md diff --git a/manual/images/bootloader.webp b/manual/images/bootloader.webp new file mode 100644 index 00000000..90762a2b Binary files /dev/null and b/manual/images/bootloader.webp differ diff --git a/manual/images/branding-about.webp b/manual/images/branding-about.webp new file mode 100644 index 00000000..5d9cded0 Binary files /dev/null and b/manual/images/branding-about.webp differ diff --git a/manual/images/branding-plymouth-shopify.webp b/manual/images/branding-plymouth-shopify.webp new file mode 100644 index 00000000..ad282b0f Binary files /dev/null and b/manual/images/branding-plymouth-shopify.webp differ diff --git a/manual/images/branding-screensaver.webp b/manual/images/branding-screensaver.webp new file mode 100644 index 00000000..f4ee4269 Binary files /dev/null and b/manual/images/branding-screensaver.webp differ diff --git a/manual/images/clipboard-history-search.webp b/manual/images/clipboard-history-search.webp new file mode 100644 index 00000000..d4c7af99 Binary files /dev/null and b/manual/images/clipboard-history-search.webp differ diff --git a/manual/images/clipboard-history.webp b/manual/images/clipboard-history.webp new file mode 100644 index 00000000..12fdf75a Binary files /dev/null and b/manual/images/clipboard-history.webp differ diff --git a/manual/images/dual-boot-1.webp b/manual/images/dual-boot-1.webp new file mode 100644 index 00000000..7a1d1c79 Binary files /dev/null and b/manual/images/dual-boot-1.webp differ diff --git a/manual/images/dual-boot-2.webp b/manual/images/dual-boot-2.webp new file mode 100644 index 00000000..dae8b68e Binary files /dev/null and b/manual/images/dual-boot-2.webp differ diff --git a/manual/images/dual-boot-3.webp b/manual/images/dual-boot-3.webp new file mode 100644 index 00000000..42a9f91c Binary files /dev/null and b/manual/images/dual-boot-3.webp differ diff --git a/manual/images/dual-boot-4.webp b/manual/images/dual-boot-4.webp new file mode 100644 index 00000000..c1639900 Binary files /dev/null and b/manual/images/dual-boot-4.webp differ diff --git a/manual/images/dual-boot-5.webp b/manual/images/dual-boot-5.webp new file mode 100644 index 00000000..89562b02 Binary files /dev/null and b/manual/images/dual-boot-5.webp differ diff --git a/manual/images/dual-boot-6.webp b/manual/images/dual-boot-6.webp new file mode 100644 index 00000000..ecbd5e7f Binary files /dev/null and b/manual/images/dual-boot-6.webp differ diff --git a/manual/images/dual-boot-7.webp b/manual/images/dual-boot-7.webp new file mode 100644 index 00000000..74adbe84 Binary files /dev/null and b/manual/images/dual-boot-7.webp differ diff --git a/manual/images/fonts-jetbrainsmono.webp b/manual/images/fonts-jetbrainsmono.webp new file mode 100644 index 00000000..49f59152 Binary files /dev/null and b/manual/images/fonts-jetbrainsmono.webp differ diff --git a/manual/images/gaming-geforce-now.webp b/manual/images/gaming-geforce-now.webp new file mode 100644 index 00000000..096e1400 Binary files /dev/null and b/manual/images/gaming-geforce-now.webp differ diff --git a/manual/images/gaming-minecraft.webp b/manual/images/gaming-minecraft.webp new file mode 100644 index 00000000..ab8fc052 Binary files /dev/null and b/manual/images/gaming-minecraft.webp differ diff --git a/manual/images/gaming-retroarch.webp b/manual/images/gaming-retroarch.webp new file mode 100644 index 00000000..2cb50efc Binary files /dev/null and b/manual/images/gaming-retroarch.webp differ diff --git a/manual/images/gaming-starcraft.webp b/manual/images/gaming-starcraft.webp new file mode 100644 index 00000000..56f86564 Binary files /dev/null and b/manual/images/gaming-starcraft.webp differ diff --git a/manual/images/gaming-steam.webp b/manual/images/gaming-steam.webp new file mode 100644 index 00000000..11787e5d Binary files /dev/null and b/manual/images/gaming-steam.webp differ diff --git a/manual/images/gaming-xbox-cloud.webp b/manual/images/gaming-xbox-cloud.webp new file mode 100644 index 00000000..0b9f951d Binary files /dev/null and b/manual/images/gaming-xbox-cloud.webp differ diff --git a/manual/images/install-config.webp b/manual/images/install-config.webp new file mode 100644 index 00000000..a8e0e0ea Binary files /dev/null and b/manual/images/install-config.webp differ diff --git a/manual/images/install-done.webp b/manual/images/install-done.webp new file mode 100644 index 00000000..07615916 Binary files /dev/null and b/manual/images/install-done.webp differ diff --git a/manual/images/macbook-omarchy.webp b/manual/images/macbook-omarchy.webp new file mode 100644 index 00000000..d3603128 Binary files /dev/null and b/manual/images/macbook-omarchy.webp differ diff --git a/manual/images/navigation-browser-terminal.webp b/manual/images/navigation-browser-terminal.webp new file mode 100644 index 00000000..dc83ae71 Binary files /dev/null and b/manual/images/navigation-browser-terminal.webp differ diff --git a/manual/images/navigation-dwindle-layout.webp b/manual/images/navigation-dwindle-layout.webp new file mode 100644 index 00000000..14831503 Binary files /dev/null and b/manual/images/navigation-dwindle-layout.webp differ diff --git a/manual/images/navigation-fourway-tiling.webp b/manual/images/navigation-fourway-tiling.webp new file mode 100644 index 00000000..a1eb1de0 Binary files /dev/null and b/manual/images/navigation-fourway-tiling.webp differ diff --git a/manual/images/navigation-popped-window.webp b/manual/images/navigation-popped-window.webp new file mode 100644 index 00000000..cdf2509d Binary files /dev/null and b/manual/images/navigation-popped-window.webp differ diff --git a/manual/images/navigation-scrolling-layout.webp b/manual/images/navigation-scrolling-layout.webp new file mode 100644 index 00000000..c041e2b0 Binary files /dev/null and b/manual/images/navigation-scrolling-layout.webp differ diff --git a/manual/images/navigation-stacked.webp b/manual/images/navigation-stacked.webp new file mode 100644 index 00000000..ccaeb9ed Binary files /dev/null and b/manual/images/navigation-stacked.webp differ diff --git a/manual/images/notice-battery.webp b/manual/images/notice-battery.webp new file mode 100644 index 00000000..9418fd5c Binary files /dev/null and b/manual/images/notice-battery.webp differ diff --git a/manual/images/notice-datetime.webp b/manual/images/notice-datetime.webp new file mode 100644 index 00000000..db752869 Binary files /dev/null and b/manual/images/notice-datetime.webp differ diff --git a/manual/images/notice-weather.webp b/manual/images/notice-weather.webp new file mode 100644 index 00000000..db547c59 Binary files /dev/null and b/manual/images/notice-weather.webp differ diff --git a/manual/images/prompt.webp b/manual/images/prompt.webp new file mode 100644 index 00000000..637f12ed Binary files /dev/null and b/manual/images/prompt.webp differ diff --git a/manual/images/reminders.webp b/manual/images/reminders.webp new file mode 100644 index 00000000..99500a18 Binary files /dev/null and b/manual/images/reminders.webp differ diff --git a/manual/images/snapshots-bootloader.webp b/manual/images/snapshots-bootloader.webp new file mode 100644 index 00000000..0e2c16bf Binary files /dev/null and b/manual/images/snapshots-bootloader.webp differ diff --git a/manual/images/snapshots-restore.webp b/manual/images/snapshots-restore.webp new file mode 100644 index 00000000..afd4f408 Binary files /dev/null and b/manual/images/snapshots-restore.webp differ diff --git a/manual/images/text-extraction.webp b/manual/images/text-extraction.webp new file mode 100644 index 00000000..30683ead Binary files /dev/null and b/manual/images/text-extraction.webp differ diff --git a/manual/images/tmux-tdl.webp b/manual/images/tmux-tdl.webp new file mode 100644 index 00000000..3d8c48e6 Binary files /dev/null and b/manual/images/tmux-tdl.webp differ diff --git a/manual/images/tmux-tdl2.webp b/manual/images/tmux-tdl2.webp new file mode 100644 index 00000000..01c54d79 Binary files /dev/null and b/manual/images/tmux-tdl2.webp differ diff --git a/manual/images/tmux-tdlm.webp b/manual/images/tmux-tdlm.webp new file mode 100644 index 00000000..8d78eaa0 Binary files /dev/null and b/manual/images/tmux-tdlm.webp differ diff --git a/manual/images/tmux-tsl.webp b/manual/images/tmux-tsl.webp new file mode 100644 index 00000000..ad6e0cfa Binary files /dev/null and b/manual/images/tmux-tsl.webp differ diff --git a/manual/images/troubleshooting-1password.webp b/manual/images/troubleshooting-1password.webp new file mode 100644 index 00000000..058005c2 Binary files /dev/null and b/manual/images/troubleshooting-1password.webp differ diff --git a/manual/images/update-available.webp b/manual/images/update-available.webp new file mode 100644 index 00000000..636ea37b Binary files /dev/null and b/manual/images/update-available.webp differ diff --git a/manual/images/windows-vm.webp b/manual/images/windows-vm.webp new file mode 100644 index 00000000..0f0b82bc Binary files /dev/null and b/manual/images/windows-vm.webp differ