// ARCH LINUX · HYPRLAND · QUICKSHELL

Omarchy OS

把 Linux 桌面變成開發工作站。鍵盤優先、視窗自動排列、整體主題一致,從 Terminal、Neovim 到 AI coding agents 都預先考慮好。

Arch-basedTiling WMKeyboard-firstAgent-friendly
● OMARCHY · 1:dev
13:56 ▣ ▰
~/projects01
▾ spark/
  ▸ public/
  ▸ .git/
  package.json
  README.md

▾ agenthub/
  ▸ backend/
  ▸ frontend/

● workspaces
terminal — foot02
❯ git status
On branch main
nothing to commit

❯ herdr
Agent workspace ready

❯ _
SUPER + SPACE · MENUSUPER + K · KEYMAP

Omarchy 是什麼?

不是單純的桌面主題,也不是在 Ubuntu 上裝幾個套件,而是一套有自己安裝流程、桌面環境與工具預設值的 Linux 發行版。

01 · ARCH

Arch Linux 基底

享有 Arch 生態與滾動更新,但日常系統更新以 Omarchy 的更新流程為主。

02 · HYPRLAND

Tiling Window Manager

視窗自動排列,靠 Super 快捷鍵切換、移動、全螢幕或改成浮動視窗。

03 · QUICKSHELL

整合的桌面體驗

頂端列、選單、通知、主題與工具都設計成協調的一體系統。

最值得記住的快捷鍵

Super 指鍵盤上的 Windows / Meta 鍵。先按 Super + Space 叫出選單;Super + K 可以看完整快捷鍵。

啟動與系統
開啟 Omarchy 選單Super + Space
開啟 TerminalSuper + Enter
開啟 BrowserSuper + Shift + Enter
開啟檔案管理員Super + Shift + F
開啟 HerdrSuper + Ctrl + Enter
開啟 tmux TerminalSuper + Alt + Enter
查看快捷鍵表Super + K
鎖定畫面Super + Ctrl + L
網路 / Wi-Fi 設定Super + Ctrl + N
系統電源選單Super + Esc
視窗與 Workspace
切換到 Workspace 1–4Super + 1/2/3/4
把視窗搬到 WorkspaceSuper + Shift + 1/2/3/4
往方向移動焦點Super + ←/→/↑/↓
與其他視窗交換位置Super + Shift + 方向鍵
切換左右/上下排列Super + J
切換 Tiling / FloatingSuper + T
切換全螢幕Super + F
關閉目前視窗Super + Q
外觀與工具
更換桌面主題Super + Ctrl + T
更換桌布Super + Ctrl + W
複製(全域)Super + C
貼上(全域)Super + V
剪貼簿歷史Super + Ctrl + V
擷取螢幕畫面Print Screen
切換頂端列Super + Shift + Space
活動監控 btopSuper + Shift + T

以官方目前的預設快捷鍵為準;若曾自行修改 ~/.config/hypr/bindings.lua,請以本機設定為主。

第一次開機,照這樣操作

不用一次背所有按鍵,先養成「開工具 → 排列視窗 → 切 Workspace」的習慣。

開啟工具

Super + Enter 開 Terminal;Super + Shift + Enter 開瀏覽器。Hyprland 會自動把視窗排好。

調整版面

Super + J 改變上下/左右排列;Super + 方向鍵 移動焦點,Super + T 讓視窗浮動。

分配工作區

用 Super + 1–4 切換工作區。例如 1 寫程式、2 看文件、3 開 Herdr、4 看監控。

常用 CLI 指令

Omarchy 的選單基本都能透過 CLI 完成,對寫 Shell script 或交給 Agent 操作很有幫助。

更新與查詢

更新 Omarchy + 套件、列出 CLI、輸出診斷。

omarchy update
omarchy commands
omarchy debug

外觀與文字

可用選單或指令切換主題、字體、顯示文字大小。

omarchy theme list
omarchy theme set catppuccin
omarchy font list
omarchy display text size 14
更新提醒: 不要把 Omarchy 的一般更新流程當成純 Arch 的 pacman -Syu。官方建議使用 omarchy update,才會一起處理 Omarchy 的 migration、設定更新與快照。

客製化在哪裡改?

目前 Omarchy 的主要使用者設定是 ~/.config 裡的 .lua 與其他 dotfiles。優先改使用者檔案,不要直接改 /usr/share/omarchy。

設定檔用途
~/.config/hypr/bindings.lua新增、覆蓋快捷鍵
~/.config/hypr/monitors.lua解析度、螢幕排列、縮放
~/.config/hypr/input.lua鍵盤、滑鼠、觸控板
~/.config/hypr/looknfeel.lua視窗間距、邊框、動畫
~/.config/hypr/autostart.lua登入時要啟動的程式
~/.config/omarchy/shell.json頂端列、桌面元件、鎖定與閒置行為
~/.config/foot/foot.ini預設 Foot Terminal 設定

修改快捷鍵

例如想把 Obsidian 的預設快捷鍵改成開啟 Joplin,使用官方提供的 o.rebind。

-- ~/.config/hypr/bindings.lua
o.rebind("SUPER + SHIFT + O", "Joplin", "joplin-desktop")

自動啟動

登入桌面時讓程式跟著啟動。

-- ~/.config/hypr/autostart.lua
o.launch_on_start("my-service")

建議先從 Super + Space → Setup 的設定選單開啟檔案,編輯完離開編輯器後,Omarchy 會處理需要重新載入的元件。

安裝前先知道

Omarchy 是真正的作業系統。只是想看看操作的話,可先使用官方提供的虛擬機體驗方案。

INSTALL

使用官方 ISO

從官網下載 ISO 寫入 USB,再由 USB 開機。可依安裝流程選擇整顆磁碟或空間安裝。

BACKUP

完整備份資料

整顆磁碟安裝會清除所選磁碟;與 Windows 雙重開機,應先讀官方 BitLocker 與分割磁碟說明。

BOOT

檢查安全開機設定

官方安裝說明目前要求調整 BIOS 內的 Secure Boot / TPM 相關設定,且預設會加密安裝磁碟。