Host the manual's images in the repo under manual/images (#6861)
* Host the manual's images in the repo under manual/images Replaces all learn.omacom.io/manual.omakub.org hotlinks with local webp files capped at 1600px wide (~20MB total), so the manual is fully self-contained. Theme and unlock previews are converted from the canonical themes/*/preview.png files. A handful of illustration shots are interim conversions of the current images, pending retakes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * Retake the illustration screenshots fresh at 3x scaling Navigation, clipboard history, notices, tmux layouts, prompt, and About reshot on a clean workspace at 3.13x (1920x1080 logical on 6K) across ten themes: Tokyo Night, Catppuccin, Gruvbox, Kanagawa, Everforest, Nord, Osaka Jade, Rose Pine, Matte Black, and Ristretto. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * Drop the extra themes chapter from the manual The community theme gallery will live elsewhere. Removes the chapter and its 114 gallery images, renumbers the following chapters, and repoints the two references (theme installs still work via Install > Style > Theme in the menu). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * Reference the shipped theme previews instead of copying them The themes chapter now points straight at themes/*/preview.png and preview-unlock.png, so previews can never drift from the source and manual/images drops from 6.3MB to 3.5MB. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
@@ -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:
|
||||
|
||||

|
||||

|
||||
|
||||
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.
|
||||
|
||||

|
||||

|
||||
|
||||
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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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:
|
||||
|
||||

|
||||

|
||||
|
||||
You can then hit `Super + J` to stack them on top of each other instead of side by side:
|
||||
|
||||

|
||||

|
||||
|
||||
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:
|
||||
|
||||

|
||||

|
||||
|
||||
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.
|
||||
|
||||

|
||||

|
||||
|
||||
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`.
|
||||
|
||||

|
||||

|
||||
|
||||
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.
|
||||
|
||||

|
||||

|
||||
|
||||
### Scratchpad workspace
|
||||
|
||||
|
||||
@@ -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_
|
||||
|
||||

|
||||

|
||||
_Catppuccin_
|
||||
|
||||

|
||||

|
||||
_Lumon_
|
||||
|
||||

|
||||

|
||||
_Ethereal_
|
||||
|
||||

|
||||

|
||||
_Everforest_
|
||||
|
||||

|
||||

|
||||
_Gruvbox_
|
||||
|
||||

|
||||

|
||||
_Miasma_
|
||||
|
||||

|
||||

|
||||
_Hackerman_
|
||||
|
||||

|
||||

|
||||
_Osaka Jade_
|
||||
|
||||

|
||||

|
||||
_Kanagawa_
|
||||
|
||||

|
||||

|
||||
_Nord_
|
||||
|
||||

|
||||

|
||||
_Matte Black_
|
||||
|
||||

|
||||

|
||||
_Vantablack_
|
||||
|
||||

|
||||

|
||||
_Ristretto_
|
||||
|
||||

|
||||

|
||||
_Retro 82_
|
||||
|
||||

|
||||

|
||||
_Flexoki Light_
|
||||
|
||||

|
||||

|
||||
_Rose Pine_
|
||||
|
||||

|
||||

|
||||
_Catppuccin Latte_
|
||||
|
||||

|
||||

|
||||
_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:
|
||||
|
||||

|
||||

|
||||
_Catppuccin_
|
||||
|
||||

|
||||

|
||||
_Catppuccin Latte_
|
||||
|
||||

|
||||

|
||||
_Ethereal_
|
||||
|
||||

|
||||

|
||||
_Everforest_
|
||||
|
||||

|
||||

|
||||
_Flexoki Light_
|
||||
|
||||

|
||||

|
||||
_Gruvbox_
|
||||
|
||||

|
||||

|
||||
_Hackerman_
|
||||
|
||||

|
||||

|
||||
_Kanagawa_
|
||||
|
||||

|
||||

|
||||
_Lumon_
|
||||
|
||||

|
||||

|
||||
_Matte Black_
|
||||
|
||||

|
||||

|
||||
_Miasma_
|
||||
|
||||

|
||||

|
||||
_Nord_
|
||||
|
||||

|
||||

|
||||
_Osaka Jade_
|
||||
|
||||

|
||||

|
||||
_Retro 82_
|
||||
|
||||

|
||||

|
||||
_Ristretto_
|
||||
|
||||

|
||||

|
||||
_Rose Pine_
|
||||
|
||||

|
||||

|
||||
_Tokyo Night_
|
||||
|
||||

|
||||

|
||||
_Vantablack_
|
||||
|
||||

|
||||

|
||||
_White_
|
||||
|
||||
@@ -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`.
|
||||
|
||||

|
||||

|
||||
|
||||
You can also search the history just by starting to type:
|
||||
|
||||

|
||||

|
||||
|
||||
@@ -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'`.
|
||||
|
||||

|
||||

|
||||
|
||||
@@ -6,13 +6,13 @@ You can quickly access the date and time, battery status, and current weather us
|
||||
|
||||
`Super + Ctrl + Alt + T`
|
||||
|
||||

|
||||

|
||||
|
||||
### Weather
|
||||
|
||||
`Super + Ctrl + Alt + W`
|
||||
|
||||

|
||||

|
||||
|
||||
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`
|
||||
|
||||

|
||||

|
||||
|
||||
@@ -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.
|
||||
|
||||

|
||||

|
||||
|
||||
### Dictation
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
@@ -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`):
|
||||
|
||||

|
||||

|
||||
|
||||
You can also start a second agent with `tdl c cx` (opencode + claude) (or just `icx`):
|
||||
|
||||

|
||||

|
||||
|
||||
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/...`:
|
||||
|
||||

|
||||

|
||||
|
||||
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:
|
||||
|
||||

|
||||

|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||

|
||||

|
||||
|
||||
## 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`.
|
||||
|
||||

|
||||

|
||||
|
||||
## 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.
|
||||
|
||||

|
||||

|
||||
|
||||
## 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.
|
||||
|
||||

|
||||

|
||||
|
||||
## 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.
|
||||
|
||||

|
||||

|
||||
|
||||
## 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.
|
||||
|
||||

|
||||

|
||||
|
||||
## Lutris (Windows games)
|
||||
|
||||
|
||||
@@ -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`.
|
||||
|
||||

|
||||

|
||||
|
||||
## Using it
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||

|
||||

|
||||
|
||||
### 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.
|
||||
|
||||

|
||||

|
||||
|
||||
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!
|
||||
|
||||
@@ -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).
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Omarchy uses JetBrainsMono Nerd Font as both the terminal and system font by default.
|
||||
|
||||

|
||||

|
||||
|
||||
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.
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||

|
||||

|
||||
|
||||
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!)
|
||||
|
||||
@@ -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`.
|
||||
|
||||

|
||||

|
||||
|
||||
### 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.
|
||||
|
||||

|
||||

|
||||
|
||||
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.
|
||||
|
||||

|
||||

|
||||
|
||||
### Converting images yourself
|
||||
|
||||
|
||||
@@ -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](https://github.com/JJDizz1L/aetheria)
|
||||
|
||||

|
||||
[Amberbyte](https://github.com/tahfizhabib/omarchy-amberbyte-theme)
|
||||
|
||||

|
||||
[Arc Blueberry](https://github.com/vale-c/omarchy-arc-blueberry)
|
||||
|
||||

|
||||
[Archwave](https://github.com/davidguttman/archwave)
|
||||
|
||||

|
||||
[Ash](https://github.com/bjarneo/omarchy-ash-theme)
|
||||
|
||||

|
||||
[Artzen](https://github.com/tahfizhabib/omarchy-artzen-theme)
|
||||
|
||||

|
||||
[Aura](https://github.com/bjarneo/omarchy-aura-theme)
|
||||
|
||||

|
||||
[All Hallow's Eve](https://github.com/guilhermetk/omarchy-all-hallows-eve-theme)
|
||||
|
||||

|
||||
[Atelier](https://github.com/atif-1402/omarchy-atelier-theme)
|
||||
|
||||

|
||||
[Ayaka](https://github.com/abhijeet-swami/omarchy-ayaka-theme)
|
||||
|
||||

|
||||
[Azure Glow](https://github.com/Hydradevx/omarchy-azure-glow-theme)
|
||||
|
||||

|
||||
[Batman](https://github.com/OldJobobo/omarchy-batman-theme)
|
||||
|
||||

|
||||
[Batou](https://github.com/HANCORE-linux/omarchy-batou-theme)
|
||||
|
||||

|
||||
[Bauhaus](https://github.com/somerocketeer/omarchy-bauhaus-theme)
|
||||
|
||||

|
||||
[Biscuit de Mar Dark](https://github.com/OldJobobo/omarchy-biscuit-de-mar-dark-theme)
|
||||
|
||||

|
||||
[Black Arch](https://github.com/ankur311sudo/black_arch)
|
||||
|
||||

|
||||
[Black Gold](https://github.com/HANCORE-linux/omarchy-blackgold-theme)
|
||||
|
||||

|
||||
[Black Turq](https://github.com/HANCORE-linux/omarchy-blackturq-theme)
|
||||
|
||||

|
||||
[bluedotrb](https://github.com/dotsilva/omarchy-bluedotrb-theme)
|
||||
|
||||

|
||||
[Blue Ridge Dark](https://github.com/hipsterusername/omarchy-blueridge-dark-theme)
|
||||
|
||||

|
||||
[Catppuccin Mocha Dark](https://github.com/Luquatic/omarchy-catppuccin-dark)
|
||||
|
||||

|
||||
[Citrus Cynapse](https://github.com/Grey-007/citrus-cynapse)
|
||||
|
||||

|
||||
[City-783](https://github.com/OldJobobo/omarchy-city-783-theme)
|
||||
|
||||

|
||||
[Cobalt2](https://github.com/hoblin/omarchy-cobalt2-theme)
|
||||
|
||||

|
||||
[CpUnk](https://github.com/stannorbvb-cmd/cpunk)
|
||||
|
||||

|
||||
[Darcula](https://github.com/noahljungberg/omarchy-darcula-theme)
|
||||
|
||||

|
||||
[Demon](https://github.com/HANCORE-linux/omarchy-demon-theme)
|
||||
|
||||

|
||||
[Dotrb](https://github.com/dotsilva/omarchy-dotrb-theme)
|
||||
|
||||

|
||||
[Dos Moos](https://github.com/HANCORE-linux/omarchy-dos-moos-theme)
|
||||
|
||||

|
||||
[Drac](https://github.com/ShehabShaef/omarchy-drac-theme)
|
||||
|
||||

|
||||
[Dracula](https://github.com/catlee/omarchy-dracula-theme)
|
||||
|
||||

|
||||
[Eldritch](https://github.com/eldritch-theme/omarchy)
|
||||
|
||||

|
||||
[Event Horizon](https://github.com/OldJobobo/omarchy-event-horizon-theme)
|
||||
|
||||

|
||||
[Evergarden](https://github.com/celsobenedetti/omarchy-evergarden)
|
||||
|
||||

|
||||
[Felix](https://github.com/TyRichards/omarchy-felix-theme)
|
||||
|
||||

|
||||
[Fireside](https://github.com/bjarneo/omarchy-fireside-theme)
|
||||
|
||||

|
||||
[Flat Dracula](https://github.com/OldJobobo/omarchy-flat-dracula-theme)
|
||||
|
||||

|
||||
[Flexoki Dark](https://github.com/euandeas/omarchy-flexoki-dark-theme)
|
||||
|
||||

|
||||
[Forest Green](https://github.com/abhijeet-swami/omarchy-forest-green-theme)
|
||||
|
||||

|
||||
[Frost](https://github.com/bjarneo/omarchy-frost-theme)
|
||||
|
||||

|
||||
[Futurism](https://github.com/bjarneo/omarchy-futurism-theme)
|
||||
|
||||

|
||||
[Ghost Pastel](https://github.com/row-huh/omarchy-ghost-pastel-theme)
|
||||
|
||||

|
||||
[Gold Rush](https://github.com/tahayvr/omarchy-gold-rush-theme)
|
||||
|
||||

|
||||
[Golden Brown](https://github.com/atif-1402/omarchy-golden-brown-theme)
|
||||
|
||||

|
||||
[The Greek](https://github.com/HANCORE-linux/omarchy-thegreek-theme)
|
||||
|
||||

|
||||
[Greek Noir](https://github.com/HANCORE-linux/omarchy-greek-noir-theme)
|
||||
|
||||

|
||||
[Green Garden](https://github.com/kalk-ak/omarchy-green-garden-theme)
|
||||
|
||||

|
||||
[Gruvu](https://github.com/ankur311sudo/gruvu)
|
||||
|
||||

|
||||
[Harbor](https://github.com/HANCORE-linux/omarchy-harbor-theme)
|
||||
|
||||

|
||||
[Harbor Dark](https://github.com/HANCORE-linux/omarchy-harbordark-theme)
|
||||
|
||||

|
||||
[Hinterlands](https://github.com/OldJobobo/omarchy-hinterlands-theme)
|
||||
|
||||

|
||||
[Infernium](https://github.com/RiO7MAKK3R/omarchy-infernium-dark-theme)
|
||||
|
||||

|
||||
[Inky Pinky](https://github.com/HANCORE-linux/omarchy-inkypinky-theme)
|
||||
|
||||

|
||||
[Last Horizon](https://github.com/HANCORE-linux/omarchy-lasthorizon-theme)
|
||||
|
||||

|
||||
[Map Quest](https://github.com/ItsABigIgloo/omarchy-mapquest-theme)
|
||||
|
||||

|
||||
[Mars](https://github.com/steve-lohmeyer/omarchy-mars-theme)
|
||||
|
||||

|
||||
[Mechanoonna](https://github.com/HANCORE-linux/omarchy-mechanoonna-theme)
|
||||
|
||||

|
||||
[Miasma](https://github.com/OldJobobo/omarchy-miasma-theme)
|
||||
|
||||

|
||||
[Midnight](https://github.com/JaxonWright/omarchy-midnight-theme)
|
||||
|
||||

|
||||
[Milky Matcha](https://github.com/hipsterusername/omarchy-milkmatcha-light-theme)
|
||||
|
||||

|
||||
[Monochrome](https://github.com/Swarnim114/omarchy-monochrome-theme)
|
||||
|
||||

|
||||
[Monokai](https://github.com/bjarneo/omarchy-monokai-theme)
|
||||
|
||||

|
||||
[Moodpeak](https://github.com/HANCORE-linux/omarchy-moodpeak-theme)
|
||||
|
||||

|
||||
[Nagai Poolside](https://github.com/somerocketeer/omarchy-nagai-poolside-theme)
|
||||
|
||||

|
||||
[Neo Sploosh](https://github.com/monoooki/omarchy-neo-sploosh-theme)
|
||||
|
||||

|
||||
[Neovoid](https://github.com/RiO7MAKK3R/omarchy-neovoid-theme)
|
||||
|
||||

|
||||
[NES](https://github.com/bjarneo/omarchy-nes-theme)
|
||||
|
||||

|
||||
[Omacarchy](https://github.com/RiO7MAKK3R/omarchy-omacarchy-theme)
|
||||
|
||||

|
||||
[One Dark Pro](https://github.com/sc0ttman/omarchy-one-dark-pro-theme)
|
||||
|
||||

|
||||
[Oxo Carbon](https://github.com/HANCORE-linux/omarchy-oxocarbon-theme)
|
||||
|
||||

|
||||
[Pandora](https://github.com/imbypass/omarchy-pandora-theme)
|
||||
|
||||

|
||||
[Pina](https://github.com/bjarneo/omarchy-pina-theme)
|
||||
|
||||

|
||||
[Pink Blood](https://github.com/ITSZXY/pink-blood-omarchy-theme)
|
||||
|
||||

|
||||
[Pulsar](https://github.com/bjarneo/omarchy-pulsar-theme)
|
||||
|
||||

|
||||
[Purple Moon](https://github.com/Grey-007/purple-moon)
|
||||
|
||||

|
||||
[Purplewave](https://github.com/dotsilva/omarchy-purplewave-theme)
|
||||
|
||||

|
||||
[Rainy Night](https://github.com/atif-1402/omarchy-rainynight-theme)
|
||||
|
||||

|
||||
[Red Monarch](https://github.com/kamatealif/omarchy-red-monarch-theme)
|
||||
|
||||

|
||||
[Retro 82](https://github.com/OldJobobo/omarchy-retro-82-theme)
|
||||
|
||||

|
||||
[RetroPC](https://github.com/rondilley/omarchy-retropc-theme)
|
||||
|
||||

|
||||
[Ristretto Light](https://github.com/brokkoli71/omarchy-ristretto-light-theme)
|
||||
|
||||

|
||||
[RobZee84](https://github.com/robzolkos/omarchy-robzee84-theme)
|
||||
|
||||

|
||||
[Rose Pine Dark](https://github.com/guilhermetk/omarchy-rose-pine-dark)
|
||||
|
||||

|
||||
[Rose of Dune](https://github.com/HANCORE-linux/omarchy-roseofdune-theme)
|
||||
|
||||

|
||||
[Ryu](https://github.com/HANCORE-linux/omarchy-ryu-theme)
|
||||
|
||||

|
||||
[Sakura](https://github.com/bjarneo/omarchy-sakura-theme)
|
||||
|
||||

|
||||
[Sakura Mochi](https://github.com/OldJobobo/omarchy-sakura-mochi-theme)
|
||||
|
||||

|
||||
[Saga](https://github.com/HANCORE-linux/omarchy-saga-theme)
|
||||
|
||||

|
||||
[Sapphire](https://github.com/HANCORE-linux/omarchy-sapphire-theme)
|
||||
|
||||

|
||||
[Shades of Jade](https://github.com/HANCORE-linux/omarchy-shadesofjade-theme)
|
||||
|
||||

|
||||
[Space Monkey](https://github.com/TyRichards/omarchy-space-monkey-theme/)
|
||||
|
||||

|
||||
[Snow](https://github.com/bjarneo/omarchy-snow-theme)
|
||||
|
||||

|
||||
[Snow Black](https://github.com/ankur311sudo/snow_black)
|
||||
|
||||

|
||||
[Solarized](https://github.com/Gazler/omarchy-solarized-theme)
|
||||
|
||||

|
||||
[Solarized Light](https://github.com/dfrico/omarchy-solarized-light-theme)
|
||||
|
||||

|
||||
[Solarized Osaka](https://github.com/motorsss/omarchy-solarizedosaka-theme)
|
||||
|
||||

|
||||
[Solitude](https://github.com/HANCORE-linux/omarchy-solitude-theme)
|
||||
|
||||

|
||||
[Sunset](https://github.com/rondilley/omarchy-sunset-theme)
|
||||
|
||||

|
||||
[Sunset Drive](https://github.com/tahayvr/omarchy-sunset-drive-theme)
|
||||
|
||||

|
||||
[Super Game Bro](https://github.com/TyRichards/omarchy-super-game-bro-theme)
|
||||
|
||||

|
||||
[Synthwave '84](https://github.com/omacom-io/omarchy-synthwave84-theme/)
|
||||
|
||||

|
||||
[Temerald](https://github.com/Ahmad-Mtr/omarchy-temerald-theme)
|
||||
|
||||

|
||||
[Tokyo Night OLED](https://github.com/Justin-De-Sio/omarchy-tokyoled-theme)
|
||||
|
||||

|
||||
[Tycho](https://github.com/leonardobetti/omarchy-tycho)
|
||||
|
||||

|
||||
[Waffle Cat](https://github.com/OldJobobo/omarchy-waffle-cat-theme)
|
||||
|
||||

|
||||
[Waveform Dark](https://github.com/hipsterusername/omarchy-waveform-dark-theme)
|
||||
|
||||

|
||||
[White Gold](https://github.com/HANCORE-linux/omarchy-whitegold-theme)
|
||||
|
||||

|
||||
[Windows Dark Mode](https://github.com/oldjobobo/omarchy-windows-dark-mode-theme)
|
||||
|
||||

|
||||
[Van Gogh](https://github.com/Nirmal314/omarchy-van-gogh-theme)
|
||||
|
||||

|
||||
[Velvet Night](https://github.com/HANCORE-linux/omarchy-velvetnight-theme)
|
||||
|
||||

|
||||
[Venice from Above](https://github.com/mattbbia/venice-from-above-omarchy)
|
||||
|
||||

|
||||
[Vesper](https://github.com/thmoee/omarchy-vesper-theme)
|
||||
|
||||

|
||||
[VHS 80](https://github.com/tahayvr/omarchy-vhs80-theme)
|
||||
|
||||

|
||||
[Void](https://github.com/vyrx-dev/omarchy-void-theme)
|
||||
@@ -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).
|
||||
@@ -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.
|
||||
|
||||

|
||||

|
||||
|
||||
### Installing Omarchy on Mac
|
||||
|
||||
@@ -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._
|
||||
|
||||

|
||||

|
||||
|
||||
Or if you haven't launched 1Password since booting up, the prompt will not appear.
|
||||
@@ -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).
|
||||
@@ -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.
|
||||
|
||||

|
||||

|
||||
|
||||
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`.
|
||||
|
||||

|
||||

|
||||
|
||||
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.
|
||||
|
||||
@@ -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**.
|
||||
|
||||

|
||||

|
||||
|
||||
Find the appropriate partition, right click, and choose **Shrink Volume**.
|
||||
|
||||

|
||||

|
||||
|
||||
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.
|
||||
|
||||

|
||||

|
||||
|
||||
When you're finished, you should see something like this where the 50GB section is where we'll install Omarchy in this example.
|
||||
|
||||

|
||||

|
||||
|
||||
## 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.
|
||||
|
||||

|
||||

|
||||
|
||||
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.
|
||||

|
||||

|
||||
|
||||
## 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.
|
||||
|
||||

|
||||

|
||||
|
After Width: | Height: | Size: 12 KiB |
|
After Width: | Height: | Size: 193 KiB |
|
After Width: | Height: | Size: 7.5 KiB |
|
After Width: | Height: | Size: 836 KiB |
|
After Width: | Height: | Size: 101 KiB |
|
After Width: | Height: | Size: 123 KiB |
|
After Width: | Height: | Size: 51 KiB |
|
After Width: | Height: | Size: 61 KiB |
|
After Width: | Height: | Size: 65 KiB |
|
After Width: | Height: | Size: 50 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 63 KiB |
|
After Width: | Height: | Size: 74 KiB |
|
After Width: | Height: | Size: 199 KiB |
|
After Width: | Height: | Size: 148 KiB |
|
After Width: | Height: | Size: 164 KiB |
|
After Width: | Height: | Size: 45 KiB |
|
After Width: | Height: | Size: 133 KiB |
|
After Width: | Height: | Size: 141 KiB |
|
After Width: | Height: | Size: 36 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 26 KiB |
|
After Width: | Height: | Size: 40 KiB |
|
After Width: | Height: | Size: 110 KiB |
|
After Width: | Height: | Size: 87 KiB |
|
After Width: | Height: | Size: 93 KiB |
|
After Width: | Height: | Size: 105 KiB |
|
After Width: | Height: | Size: 24 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 21 KiB |
|
After Width: | Height: | Size: 7.9 KiB |
|
After Width: | Height: | Size: 110 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 39 KiB |
|
After Width: | Height: | Size: 26 KiB |
|
After Width: | Height: | Size: 23 KiB |
|
After Width: | Height: | Size: 26 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 31 KiB |
|
After Width: | Height: | Size: 36 KiB |
|
After Width: | Height: | Size: 2.3 KiB |
|
After Width: | Height: | Size: 50 KiB |