Omarchy 快速上手

中文版整理　｜　對應原文：Omarchy Manual

時間有限的話，看完這一篇就夠了。它涵蓋你每天八成的操作。其餘 50 章就當工具書——想改設定、裝東西、解問題時再回來查就好，不必一次讀完。

一句話理解 Omarchy

Super 是重心，選單是入口，K 是答案，平鋪不要拖。

卡住時的三個出口

新手最常卡住的就是這三種情況，只要記住這張圖，你就不會「不知道下一步該做什麼」：

日常八成操作，只有五個動作

視窗與工作區怎麼運作

Omarchy 最大的心態轉變：視窗不重疊、不需要拖曳。你開一個視窗，它佔滿畫面；再開一個，它們自動分割。想換位置就用 Super + Shift + 方向鍵「交換」，而不是拿滑鼠拖。

工作區就像 macOS 的 Space 或 Windows 的虛擬桌面，只是這次你真的會用它——把 1 當瀏覽、2 當開發、3 當聊天，一個鍵就跳過去。用順了之後，你可能根本不需要第二個螢幕。

四個視窗同時可見、自動分配空間，這是 Omarchy 的預設狀態。

按 Super + J 就能在「左右並排」與「上下堆疊」之間切換，再按一次復原。

花五分鐘，讓系統變成你的

以下每一項都只要按一個鍵，做完就很有「我的電腦」的感覺：

• 換主題：Super + Ctrl + Shift + Space——22 套配色，整個桌面、終端機、編輯器一起換。
• 換桌布：Super + Ctrl + Space。
• 連 Wi-Fi：Super + Ctrl + W。
• 調音量：Super + Ctrl + A（可單獨調某個應用程式的音量）。
• 剪貼簿歷史：Super + Ctrl + V，文字與圖片都記得，直接打字就能搜尋。
• 截圖：Print Screen（沒有這個鍵就按 Super + Ctrl + C）。
• 想多看一點畫面：Super + Shift + Space 把頂部狀態列收起來。
• 切換中文輸入法：Ctrl + Space。

剪貼簿歷史由 Omarchy shell 提供，支援文字與圖片，並可用關鍵字搜尋。

兩週上手節奏

不用一次背完。照這個節奏走，兩週後你會發現自己已經不看這篇了：

從 macOS / Windows 過來

你的肌肉記憶幾乎都能對應過來，只要換一個鍵：

接下來去哪裡

• 想背完整快速鍵 → 第 6 章 快速鍵
• 想搞懂平鋪與工作區的各種玩法 → 第 3 章 視窗導航
• 想改設定、備份自己的設定 → 第 30 章 Dotfiles
• 想確認資料安全與加密 → 第 47 章 安全性
• 遇到問題 → 第 44 章 疑難排解、第 45 章 常見問題

歡迎使用 Omarchy！

原文：The Manual

Omarchy 是一套「無選單主廚精選（omakase）」式的 Linux 發行版，建立在 Arch、平鋪式視窗管理器 Hyprland，以及桌面建構工具箱 Quickshell 之上。它預先裝好了現代且熟悉電腦的使用者能立刻上手、馬上開始工作的一切：從 Neovim（順帶一提）到 Chromium、從 Obsidian 到 LibreOffice、從 Kdenlive 到 OBS Studio。甚至連復古的 Winamp 風格音樂播放器都有！

不過，這並不只是把一堆套件塞進來而已。它是一套同時兼顧「美感」與「生產力」而設計的完整系統。因為一套漂亮的系統才會激勵人去使用，而生產力一向是動機的下游產物。這裡沒有任何多餘的肥肉：只有我真正會用的東西。

確實，要培養出欣賞 Omarchy 這種「大量使用 TUI、精心配色主題、平鋪視窗管理」系統之美的眼光，需要一點時間。但這正是你來這裡的原因，不是嗎？想體驗一點舒適圈之外的東西？想踏上一場用全新方式操作電腦的小冒險？我希望如此。

Omarchy 不像 Windows，也不像 macOS。它不試圖盡可能地「看起來眼熟」，它想追求的是美麗與更好。盡情擁抱它滿滿的 Linux 味吧：手動編輯一些設定檔，當然；大量使用終端機，絕對要。

我們就從基礎開始吧。

開始使用

原文：Getting Started

Omarchy 是透過 ISO 映像檔安裝的。你可以選擇「整顆硬碟安裝」（佔用整顆磁碟），或是「剩餘空間安裝」（把 Omarchy 放進磁碟上未配置的空間）——後者就是與 Windows 或其他系統雙開機的方式（參見雙系統安裝，注意你得先在 Windows 關閉 BitLocker）。無論哪一種，安裝預設都會啟用全磁碟加密，而整顆硬碟安裝會清空所選磁碟，所以如果要沿用既有磁碟，務必先備份！

先下載 Omarchy ISO，寫入 USB 隨身碟（Mac/Windows 上可用 balenaEtcher，Linux 上可用 caligula），然後從隨身碟開機。

你必須在 BIOS 中關閉 Secure Boot 和／或 TPM。要安裝 Omarchy 就得關掉它們。那些是 Microsoft 為 Windows 及 Microsoft 關係良好的 Linux 發行版所設計的安全機制。

接著回答設定問題，並像這樣確認：

然後選擇要安裝的磁碟，接著就坐著看安裝秀開演。在最快的現代機器上不到一分鐘就能完成，就算在老電腦上也不該超過 5 分鐘。

現在你可以開始 Omarchy 了！

請使用有線或 2.4GHz 無線鍵盤！

全磁碟加密不允許你在開機時用藍牙鍵盤輸入密碼——就像你沒辦法用藍牙鍵盤進 BIOS 一樣。你需要一把走 2.4GHz 接收器或直接接線的鍵盤（接線的延遲表現也更好！）。我個人很愛 Lofree Flow84！

幫別人安裝

如果你是幫別人（家人、新進員工、買家）設定機器，不該由你代替他回答那些個人問題。在安裝程式第一個畫面（鍵盤選擇）按 Ctrl + C，Omarchy 就會提議改為「幫另一位擁有者準備機器」。系統會立刻安裝，但所有個人設定——鍵盤配置、使用者名稱、密碼——都會延後到機器第一次開機時才進行。磁碟仍預設加密，而新擁有者在首次開機時選的密碼也會成為加密密碼。（已經在使用的機器也可以不重灌就轉交出去——參見重設電腦。）

無人自動安裝

只要把設定檔放在第二顆磁碟上交給它，ISO 也能完全自行安裝——不需要鍵盤、不需要精靈。這正是把 Omarchy 當作 VM 與大量機器基礎映像檔的做法。參見無人自動安裝。

不加密安裝

Omarchy 預設以加密方式安裝。對任何可能遺失或被偷的電腦來說，這是最安全、最負責任的選擇。你不會希望任何能接觸到硬體的人拿到你的資料！

但在特殊情況下，例如在受保護的電腦上遠端安裝 Omarchy，或是安裝用完即丟、不含敏感資料的系統，你可能會想不加密安裝。你可以在磁碟格式化確認畫面按 Ctrl + C，切換成不加密安裝。

卡住時的求助管道

如果卡住了，通常可以在社群 Discord 的 #omarchy-help 頻道找到願意幫忙的人。

從 macOS 或 Windows 轉換過來

原文：Coming From Mac or Windows

如果你在 macOS 或 Windows 上用了多年，你的手指記得一百件你的大腦早已忘記自己學過的事。這一章就是那個「翻譯層」：那些本能反應在 Omarchy 裡對應到什麼。各項功能本身在其他章節有深入介紹——這裡只是一張地圖。

Super 是所有事情的中心

你圍繞著 Cmd 或 Windows 鍵建立的所有肌肉記憶，都轉移到同一個鍵上：Super。在 PC 鍵盤上就是 Windows 鍵，它是 Omarchy 幾乎每一個快速鍵的錨點。

你找 Spotlight、Raycast 或開始功能表的反射動作，變成 Super + Space。它會開啟 Omarchy 選單，用來啟動應用程式、變更設定、安裝軟體、擷取螢幕——幾乎所有事情。開始打字就能篩選。另外還有一個只列出應用程式的專用選單，在 Super + Alt + Space。參見視窗導航。

沒有 Dock，也沒有桌面圖示

沒有任何東西可以點來啟動程式，桌面上也沒有圖示可以排列。應用程式從快速鍵啟動（終端機是 Super + Return、瀏覽器是 Super + Shift + Return，Super + K 則會列出所有已繫結的快速鍵），或從選單啟動。唯一常駐的介面元件是頂部狀態列，它涵蓋了過去由選單列、系統匣與通知中心負責的功能——而且上面幾乎每個小工具在左鍵、右鍵、中鍵點選時都有作用。

視窗會自己就定位

最大的心態轉變：你不會拖曳視窗，也不會把它們吸附到螢幕左右半邊。開一個視窗，它就佔滿整個螢幕；開第二個，它們就分割畫面。你永遠不需要把某個視窗從另一個下面挖出來，因為視窗不會重疊。

當你真的需要浮動視窗時，Super + T 可以把當前視窗切出／切回平鋪模式。但請先給平鋪一個真正的機會——它是整套系統的核心。視窗導航會帶你走一遍。

工作區（workspace）會讓你覺得熟悉：它們就是 macOS 的 Space 或 Windows 的虛擬桌面，只是這次你真的會用它們，因為 Super + 1/2/3/4 可以直接跳過去，Super + Shift + 1/2/3/4 則把當前視窗送過去。沒有動畫延遲，就是瞬間跳轉。這代表如果你以前習慣用多螢幕，現在可能根本不需要了。

複製與貼上就是能動

在 Mac 上你到處都用 Cmd + C；在 Windows 上你到處都用 Ctrl + C——除了終端機，在那裡它會殺掉你的程式。Omarchy 給你 Super + C、Super + X、Super + V，而且到處都能用，包括終端機。不必為 shell 另外學一套反射動作。

Windows 來的朋友：你的 Win + V 剪貼簿歷史在 Super + Ctrl + V，而且它連圖片都能存，不只文字。參見統一剪貼簿與歷史。

對照表

有些地方真的不一樣

很多設定存在你用文字編輯器編輯的文字檔裡，而不是一層層點進去的面板。聽起來很原始，但當你意識到這代表每一項調整都能被看見、複製到下一臺機器、放進版本控制時，就不這麼認為了。選單裡的設定（Setup）會直接帶你到正確的檔案，並在你完成後重新啟動需要重啟的東西。

更新只透過一個指令完成——Update > Omarchy——它會同時更新 Omarchy 本身與系統上每個套件，並先建立一份快照。沒有各自為政的應用程式更新提示在那邊隨機騷擾你。參見更新。

軟體來自套件管理器，而不是下載來的安裝檔。

而且當你關掉視窗時，應用程式就真的結束了。沒有 macOS 那種「程式還在跑、只是沒有視窗」的懸置狀態。Super + W——或如果你帶來的肌肉記憶是 Super + Q，也行——就是消失。

在 Mac 硬體上

Omarchy 在 Intel Mac 上跑得很順——參見 Mac 支援。而且鍵盤對你很友善：Omarchy 沒有重新對應任何按鍵，而 Linux 把 Command 鍵當作 Super，所以 Super 就坐在 Cmd 原本的位置。你的大拇指不會察覺到搬家了。

給它兩週時間

本能的轉移比你以為的快。把快速鍵那一章掃過一次，之後每當你忘記某個繫結，就按 Super + K——它會把所有快速鍵列給你。那是你唯一真正必須背下來的快速鍵。

視窗導航

原文：Navigation

在 Omarchy 裡，每一件事都靠鍵盤完成——每一件！系統第一次啟動時，光靠滑鼠你 literally 什麼都做不了。但你可以按 Super + Space 叫出 Omarchy 選單，從那裡你幾乎可以做任何事。

不過 Omarchy 選單甚至不是設計來當作日常作業系統的主要方式。我們可以更快！所有最重要的應用程式都直接繫結到各自的快速鍵。用 Super + Return 啟動終端機，用 Super + Shift + Return 啟動瀏覽器。試著一個接一個開，你就會看到 Hyprland 平鋪的魔法：

接著你可以按 Super + J，把它們從左右並排改成上下堆疊：

再按一次 Super + J 就會回到左右並排。然後在瀏覽器上試試 Super + Shift + 右方向鍵 來交換兩個視窗的位置。

現在試試 Super + Ctrl + T 啟動活動監視器。它會以浮動視窗出現。你可以用 Super + T 把它平鋪（再按一次就變回浮動）。接著按 Super + Shift + F 開啟檔案管理員。你就有了一個整齊的四方格配置：

你用 Super + 方向鍵 在各視窗之間切換焦點。這會切換作用中視窗，並把遊標移到新應用程式的中心。

如果你按 Super + Shift + 2，會把當前焦點的應用程式移到第二個工作區；Super + Shift + 1 則把它移回來。（而 Super + Shift + Alt + 2 會把當前焦點應用程式移到第二個工作區，但不會跟著切換過去。）

如果你按住 Super 並用滑鼠點選某個視窗，就能重新安排它的位置。按住 Super 並按滑鼠右鍵，則可以自由調整視窗大小。

你用 Super + W 或 Super + Q 關閉視窗（用 Ctrl + Alt + Delete 關閉所有視窗）。

你也可以用 Super + F 進入全螢幕，或用 Super + Alt + F 只佔滿寬度（保留頂部狀態列），或用 Super + Ctrl + F 在視窗內全螢幕（看 YouTube 很好用！）。

Dwindle 與滾動式版面

Omarchy 的預設版面叫做 dwindle（遞減）。它會讓你在單一工作區開的所有視窗隨時可見，即使必須把它們縮小也一樣。

但你也可以把某個工作區切換成滾動式版面：視窗一個接一個橫向排列，延伸超出螢幕可見邊緣。用 Super + L 把單一工作區切換成這個版面。

這個選擇是「每個工作區各自獨立」的，而且會保留下來。所以你可以讓工作區 1 保持 dwindle 用來瀏覽，工作區 2 用滾動式來寫程式，重開機後它們還會維持原樣。（同樣的切換開關也在 Omarchy 選單的 Trigger > Toggle > Workspace Layout 底下。）

如果你想把滾動式版面設為預設，可以在 ~/.config/hypr/looknfeel.lua 裡設定：

hl.config({
  general = {
    layout = "scrolling",
  },
})

視窗分組

視窗可以用 Super + G 分組。一旦進入分組狀態，之後你開的每個視窗都會屬於該組。你可以用 Super + Ctrl + 左右方向鍵 在群組內的視窗之間移動，或用 Super + Alt + 1/2/3/4 直接跳到群組內第 n 個視窗。

你可以用 Super + Alt + G 把某個視窗移出群組，或再按一次 Super + G 解散整個群組。最後，你可以用 Super + Alt + 方向鍵 把群組外的視窗移進群組。

彈出視窗（Popping）

你可以用 Super + O 把視窗從它的工作區配置中彈出。它會被釘成一個浮動視窗，無論你切到哪個工作區都跟著你。很適合影片播放器之類的東西。

Scratchpad 工作區

最後，有一個特別的 scratchpad 工作區，會像 Quake 主控臺那樣在你當前所在的工作區上方降下來。用 Super + 反引號（`） 或 Super + S 切換它，並用 Super + Shift + 反引號 或 Super + Alt + S 把視窗放進去。

它特別適合拿來放執行 agent 的終端機，或是你不想離開當前工作區就想快速操作的控制項。要把視窗移出 scratchpad，可以用 Super + Shift + 1 之類的指令把它直接送往另一個工作區。

這需要一點時間適應！

要習慣這樣操作桌面需要一點時間，但一旦上手，你就很難再回到傳統的滑鼠驅動桌面體驗了！

頂部狀態列

原文：The Top Bar

螢幕頂端的那一條，就是 Omarchy 狀態列。它不是外掛上去的狀態列，而是 Omarchy shell 的一部分——那個單一、長時間執行的 Quickshell 行程，同時也負責繪製選單、通知、OSD 彈出視窗與鎖定畫面。這就是為什麼它與其他所有元件的佈景主題能完美一致，也是為什麼面板能瞬間開啟，而不是另外啟動一個應用程式。

它也是桌面上唯一永遠顯示的元件，所以值得搞清楚那些小圖示到底在做什麼。

預設有哪些東西

狀態列分成三個區段。左邊是 Omarchy 標誌（選單啟動器）與工作區指示器。中間是狀態指示器、時鐘、鍵盤配置、天氣，以及 Omarchy 更新標記。右邊則是系統匣、agents、藍牙、網路、音訊、顯示與電源。

其中有些只在意義存在時才出現。鍵盤配置只在你設定了多於一種配置時顯示；更新標記只在有 Omarchy 更新待處理時出現；而 agents 圖示則在 Omarchy 首次在機器上發現 AI 程式開發用量時出現（參見 AI）。

到處點點看

幾乎每個小工具在左鍵、右鍵、中鍵點選時都有作用，還有幾個會回應滾動。這正是大家常忽略的部分——右鍵與中鍵才是很多好東西藏身之處。

表格裡並非每一項都預設出現在你的狀態列上。媒體小工具（MPRIS 正在播放，含會捲動的曲名與演出者）與麥克風小工具都內建但預設關閉——想要的話可以自己加，方法見下文。

面板

點選狀態列圖示會開啟面板，那是真正的彈出視窗，有滑桿、清單，並支援鍵盤操作，而不是單純的提示文字。每個面板也都有自己的快速鍵，讓你永遠不必去瞄準一個 16 畫素的小圖示：

這些面板不是唯讀的顯示器，而是你真正動手做事的地方：

• 音訊：有主音量滑桿、輸出裝置選擇器，以及各應用程式混音器，讓你能單獨把某個瀏覽器分頁調小，而不影響其他所有東西。
• 網路：掃描 Wi-Fi、顯示訊號強度、連線，並讓你選擇 DNS 供應商。
• 藍牙：列出你的裝置，可連線／中斷連線並顯示電量。
• 電源：顯示電池統計、切換電源設定檔（它會分別記住使用電池與接電源時的不同選擇），並印出一些系統資訊。
• 顯示：有亮度滑桿、文字大小、螢幕縮放預設值，以及——當你有不只一個螢幕時——各螢幕的獨立控制。更深入的說明參見螢幕。
• 時鐘：開啟月曆格狀檢視，含 ISO 週數與月份切換。

每個面板都同時接受鍵盤與滑鼠：方向鍵移動、Return 啟動、Tab 切換到相鄰面板、Escape 關閉。

Super + Ctrl + 1-9 是從左到右計算右側區段的面板，並跳過系統匣（因為它沒有自己的面板）。所以編號會對應到你會去點的那個圖示。

Tailscale 與 Dropbox

還有兩個小工具，只有當你從 Install → Service 安裝對應服務後才會出現在狀態列上。這兩個都值得了解，因為它們不只是回報狀態而已。

Tailscale 面板可以連線／中斷 tailnet、切換帳號，並選擇 exit node（你自己的機器與 Mullvad 區域都會出現在該清單中）。它也能瀏覽你的機器——選定一臺後，按 s 就能透過 Taildrop 傳檔案給它，這是把檔案傳到手機或另一臺筆電最快的方法。c 複製該機器的 IP、n 複製名稱、d 複製完整 DNS 名稱。每臺機器的列上也有傳送按鈕，如果你偏好用點的話。從終端機做同樣的事則是 omarchy tailscale send <machine> [file...]。

Dropbox 面板則負責登入、顯示已使用的儲存空間，並列出最近同步的檔案。

移除任一個服務，對應的小工具就會從狀態列上消失。

指示器

中間那一小群圖示就是指示器小工具。它們是你已開啟模式的狀態圖示：勿擾模式、夜間光線、已排入的提醒、正在進行的螢幕錄影、保持清醒，以及聽寫。模式啟用時它們會亮起，否則就安靜待著——把遊標移到狀態列中央就能偷看那些未啟用的圖示。點選指示器即可切換該模式。

如果你希望它們永遠可見，把該小工具的 alwaysShow 設為 true。如果你只在意其中幾個，把它們列在 items 裡：["Dnd", "Reminder", "NightLight"]。你可以放多個指示器小工具，讓不同區段顯示不同的子集合。

重新排列狀態列

狀態列會自我配置。你不必開啟設定檔就能移動東西。

抓住狀態列中央附近的空白處，往另一個螢幕邊緣拖曳，狀態列就會移過去——左、右、上、下都可以，而且每個小工具都會跟著適應（垂直狀態列會退化成精簡的純圖示形式）。按住不放也會開始同樣的拖曳。在同一塊空白處按左鍵雙擊可切換透明。你也可以拖曳任何小工具來重新排序，或把它丟到另一個區段。

如果你偏好從選單挑選，Style → Menu Bar 裡同時有位置與透明度選項。

同樣的事也有對應指令，這正是 dotfiles 設定會想用的方式：

omarchy bar position bottom
omarchy bar transparent toggle
omarchy bar move omarchy.clock --section center --index 0
omarchy bar set omarchy.clock format "HH:mm"
omarchy bar defaults          # 回到出廠版面

要完整新增或移除一個小工具，請使用外掛指令。omarchy plugin list 會印出 shell 認識的每個小工具及其 id，然後：

omarchy plugin enable omarchy.media --section center
omarchy plugin disable omarchy.weather

隱藏狀態列

Super + Shift + Space 可以關閉再開啟狀態列，而不必殺掉 shell——面板與快速鍵仍可運作，你只是把那些畫素要回來而已。它也在選單的 Trigger → Toggle → Menu Bar 底下。

設定檔

以上所有設定都存放在 ~/.config/omarchy/shell.json 的 bar 鍵底下。以下是一個精簡版：

{
  "version": 1,
  "bar": {
    "position": "top",
    "transparent": false,
    "centerAnchor": "omarchy.clock",
    "layout": {
      "left": [{ "id": "omarchy.menu" }, { "id": "omarchy.workspaces" }],
      "center": [{ "id": "omarchy.clock", "format": "HH:mm" }],
      "right": [{ "id": "omarchy.audio" }, { "id": "omarchy.power" }]
    }
  }
}

每個小工具都是三個版面陣列中某一項的一個專案，而它的設定就內嵌在該專案上——沒有另外的設定檔，也沒有 config 子物件。時鐘的 format、formatAlt（右鍵迴圈切換到的格式）與 verticalFormat 全都直接放在 { "id": "omarchy.clock" } 上。

centerAnchor 指定中間哪一個小工具會被釘在螢幕正中央，其他小工具則分列兩側。這正是為什麼即使天氣與更新標記出現或消失，時鐘仍能穩穩待在正中央。把它設成空字串，中間清單就會改成整組一起置中。

有一條規則值得內化：一旦你有了自己的 shell.json，它就成了唯一權威。在你進行任何自訂之前，shell 讀的是 Omarchy 的預設檔案。當你拖曳了小工具、執行過 omarchy bar，或自己編輯了該檔案，它就歸你所有了——不會有深度合併，所以未來 Omarchy 版本新增的預設小工具不會自動出現在你的狀態列上。想要乾淨重來時，omarchy bar defaults 會把出廠版面放回去。

同一個檔案也在最上層（bar 鍵之外）儲存你的閒置時序：idle.screensaver 與 idle.lock，兩者都以「閒置幾秒」為單位。所以預設螢幕保護在 150 秒時啟動，鎖定則在 300 秒。

主題

原文：Themes

Omarchy 內建 22 套漂亮的主題。你可以在 Omarchy 選單（Super + Space）的 Style > Theme 中選擇，或直接用 Super + Ctrl + Shift + Space 跳到主題選擇器。

每套主題都會為桌面、終端機、neovim、活動監視畫面（btop）、Chromium，以及整個 Omarchy shell（頂部狀態列、選單、通知、OSD、鎖定畫面）套用配色。（至於 Obsidian，你必須在應用程式內透過 Appearance > Themes 手動選擇 Omarchy 主題。）

每套主題都有一組背景圖片，你可以用 Super + Ctrl + Space 從中挑選。

你還可以在額外主題頁面找到更多主題，甚至自己做一套主題。

解鎖畫面（Unlocks）

主題也可以有自訂的解鎖設計，用於開機時的磁碟解密程式。你可以在 Style > Unlock 底下選擇其中一種。它們看起來像這樣：

快速鍵

原文：Hotkeys

你可以用 Super + K 看到所有主要的鍵盤繫結（Tmux 繫結用 Super + Alt + K，Herdr 繫結用 Super + Ctrl + K）。

導航

系統控制

調整

啟動應用程式

在 ~/.config/hypr/bindings.lua 中變更／新增繫結。

通用剪貼簿

通常在 Linux 上，終端機裡要用 Ctrl + Shift + C/V 複製貼上，其他地方則用 Ctrl + C/V。這些 Omarchy 統一剪貼簿快速鍵到處都能用。

擷取

螢幕錄影時，這個快速鍵會先問你要收哪種音訊，然後才開始錄。再按一次則停止。詳情參見截圖與螢幕錄影。

所有擷取選項也可從 Omarchy 選單（Super + Space）的 Trigger > Capture 存取。

通知

風格

額外背景圖片放在 ~/.config/omarchy/backgrounds/<主題名稱>。也可從 Omarchy 選單的 Install > Style > Background 取得。

所有風格選項也可從 Omarchy 選單（Super + Space）的 Style 存取。

開關

提醒事項

通知快報（Notices）

Tmux

前置鍵（prefix）是 Ctrl + Space（Ctrl + B 也可以）。你可以在 ~/.config/tmux/tmux.conf 中變更這些繫結。

窗格（Panes）

視窗（Windows）

工作階段（Sessions）

複製模式（vi 風格）

一般

Tmux 版面函式

這些函式必須在 Tmux 工作階段內執行。

Ghostty 終端機

Ghostty 終端機是透過 Omarchy 選單的 Install > Terminal 安裝的。

檔案管理員

Neovim（使用 LazyVim）

導航

在側邊欄中

檢視 LazyVim 設定的所有 Neovim 快速鍵。

快速表情符號

你可以用 Super + Ctrl + E 叫出完整的表情符號選擇器，選取後會放進剪貼簿；也可以使用以下快速選項。

快速補完（Quick Completions）

你可以編輯 ~/.XCompose 新增更多自己的補完，然後在終端機執行 omarchy-restart-xcompose 讓變更生效。

統一剪貼簿與歷史

原文：Unified Clipboard & History

通常在 Linux 上，終端機裡要用 Ctrl + Shift + C/V 複製貼上，其他地方則用 Ctrl + C/V。對於不是從小泡在 Linux 裡長大的人來說，這很難習慣！如果你是從 Mac 過來，從 super 改成 ctrl 的轉換也一樣難受。

Omarchy 用一組（幾乎）到處都能用的統一剪貼簿快速鍵，一次解決這兩個問題。它們是：

注意：大多數 agent 工具會用 Ctrl + V 貼上圖片，但用 Super + V 貼上文字。

剪貼簿歷史

剪貼簿歷史由 Omarchy shell 提供，文字與圖片都能處理。用 Super + Ctrl + V 叫出，用 Return 選擇專案，選中的內容就會放進剪貼簿，準備好用 Super + V 貼上。

你也可以直接開始打字來搜尋歷史：

提醒事項

原文：Reminders

Omarchy 內建一種設定簡單提醒的方式，基於倒數計時器並附上一則訊息。你可以用 Super + Ctrl + R 設定、用 Super + Ctrl + Alt + R 檢視所有已設定的提醒，並用 Super + Ctrl + Shift + R 清除全部。這些都能從 Trigger > Reminder 存取。你也可以用命令列：omarchy reminder 7 '茶泡好了'。

通知快報（Notices）

原文：Notices

你可以用快速鍵快報迅速取得日期時間、電池狀態與目前天氣。

日期與時間

Super + Ctrl + Alt + T

天氣

Super + Ctrl + Alt + W

位置是由你的 IP 位址推斷的，通常夠接近，但不總是準。你可以用 omarchy weather location --set Malibu 把它固定下來，或加上經緯度以求精確：omarchy weather location --set Malibu 34.0259,-118.7798。單獨執行 omarchy weather location 可看到它認為你在哪裡，用 --clear 則回到自動偵測。

電池

Super + Ctrl + Alt + B

文字擷取與聽寫

原文：Text Extraction & Dictation

文字擷取

按 Super + Ctrl + PrtScr 在螢幕上選取一個區域進行文字擷取。開源的 tesseract OCR 模型會迅速把該選取範圍轉成文字並放進剪貼簿。接著你只要按 Super + V 貼上即可。

這對於從圖片頁尾抓地址，或從網站標題中挖出電話號碼非常有幫助。

聽寫

Omarchy 透過 Voxtype 提供 AI 聽寫。你透過 Omarchy 選單的 Install > AI > Dictation 安裝。它預設會載入一個 150MB 的基礎英文模型。但你可以執行終端機中的 voxtype setup model 來調整想用的模型，並透過 ~/.config/voxtype/config.toml 調整所有設定。

安裝完成後，按住 F9 或按 Super + Ctrl + X 切換來聽寫，聽寫的文字會出現在目前聚焦的輸入區。

截圖與螢幕錄影

原文：Screenshots & Recording

所有能從螢幕上抓下來的東西，都掛在 Print Screen 鍵上。單按一個鍵拍張照，加上各種修飾鍵則變成錄影、取色，或擷取某個區域裡的文字。如果你的鍵盤根本沒有 Print Screen 鍵，Super + Ctrl + C 會以選單形式開啟同一組功能。

螢幕截圖

按下 Print Screen，畫面會凍結，讓你在瞄準時不會有東西在底下跑動。拖出一個框選自由區域，或單點一下——照片就會吸附到你點選處所在的矩形：如果你點在視窗上就抓那個視窗，如果點在狀態列或縫隙上就抓整個螢幕。改變心意了？再按一次 Print Screen 就能關閉選擇器。

結果會同時送到兩個地方：一張 PNG 存到你的圖片目錄，同時放進剪貼簿，讓你可以用 Super + V 直接貼到聊天視窗。畫面會彈出一則帶縮圖的通知。點它（或按 Super + Alt + , 叫回最近一則通知），截圖會在註釋編輯器 Tensaku 中開啟，讓你送出前在上面畫箭頭和方框。

檔案預設放在 ~/Pictures，命名為 screenshot-2026-08-13_14-22-05.png。如果你想把它們另外放在自己的資料夾，設定 OMARCHY_SCREENSHOT_DIR——要放在哪裡參見常見問題中關於 session 環境變數的說明。資料夾若不存在，Omarchy 會幫你建立。你也可以用 OMARCHY_SCREENSHOT_EDITOR 換掉編輯器。

從終端機的話，omarchy screenshot 會拍下同樣的截圖，而且你可以說得更明確：omarchy capture screenshot region 只做自由選取，windows 吸附視窗與螢幕矩形，fullscreen 則完全跳過選擇器直接抓當前聚焦的螢幕。第二個引數 copy 只把截圖放進剪貼簿，save 則只存到磁碟。

用鍵盤操作選擇器

選取介面出現時，你完全不必用滑鼠：

方向鍵與 Tab 會把遊標移到它們選中的視窗，所以標亮範圍會跟著移動，你能看到自己即將擷取什麼。這些繫結只在選取畫面出現時存在，所以不會與你自己設定裡的任何東西衝突。

螢幕錄影

Alt + Print Screen 會開啟 Trigger > Capture > Screenrecord，它會問你想在聲音裡收什麼：無音訊、桌面音訊、桌面加麥克風，或桌面加麥克風加網路攝影機。最後一項只在你真的插了攝影機時才會出現。選好之後，你會拿到與截圖相同的選擇器：拖一個區域，或點一個視窗或螢幕。

錄影由 gpu-screen-recorder 執行，它會用 GPU 以 60fps 編碼，逼不得已則回退到 CPU。結果是 ~/Videos 裡的一個 MP4，命名為 screenrecording-2026-08-13_14-22-05.mp4。設定 OMARCHY_SCREENRECORD_DIR 可以改變這點——但注意，與截圖目錄不同，這個目錄必須事先存在，否則錄影會拒繪開始。

錄影期間，狀態列上會出現一個小指示器。點它就能停止。你也可以再按一次 Alt + Print Screen 停止，或用 Trigger > Capture > Screenrecord 底下的 Stop Screenrecording，它只在真的在錄影時才會出現。

停止時會先做一點整理才把檔案交給你：第一幀會被裁掉；若有音訊，會標準化到 -14 LUFS，並把開頭 PipeWire 捕獲時的爆音靜音。接著會彈出一則帶錄影縮圖的通知。點它就能用 mpv 播放該檔案。

網路攝影機疊層

當你帶著網路攝影機錄影時，攝影機會以一個釘住、裁切過的直立視窗出現在你所錄內容的右下角。如果它擋住了你需要的東西，可以即時調整大小：

共有三種大小——小、中、大——快速鍵會在她們之間逐步切換。預設是中。它們與錄影內容成比例，所以不管你是錄 1080p 還是 6K 螢幕，攝影機都佔畫面的相同比例。而且如果你錄的是某個區域而非整個螢幕，疊層會鎖定在那個區域的角落而非螢幕的角落，因此會留在畫面內。

你也可以直接呼叫 omarchy-capture-webcam-resize small，或用 reset 回到中。

文字、QR 碼與顏色

Super + Ctrl + Print Screen 選取一個區域並把它 OCR 到剪貼簿。這部分在文字擷取與聽寫有完整說明。

Trigger > Capture > QR Code 對 QR 碼做同樣的事。選取包含該碼的區域，解碼結果就會進剪貼簿。它只找 QR 碼——不然密集的螢幕內容很容易被誤判成條碼。值得知道的是：解碼結果只進剪貼簿，不會到其他地方。它不會被印出、不會出現在通知裡，而且被標記為敏感，所以不會留在剪貼簿歷史裡。QR 碼經常攜帶機密——例如 2FA 設定碼背後那個 otpauth:// URI——你不會想讓它出現在日誌裡。貼上仍然正常運作。

Super + Print Screen（或 Trigger > Capture > Color）會把遊標變成滴管。點螢幕上任何東西，顏色就會進剪貼簿。再按一次快速鍵可以不選而退出。

分享前先轉碼

一段 4K 螢幕錄影或手機拍的原生 HEIC，常常大到無法直接傳送。Super + Ctrl + .（或 Trigger > Transcode）可以解決。它會在 ~/Pictures 與 ~/Videos 上提供模糊檔案選擇器，然後問你要什麼格式與大小。

圖片可轉成 jpg 或 png，分高、中、低，分別將寬度上限設為 3160、2160、1080 畫素。影片可轉成 mp4 或動畫 gif，分 4K、1080p、720p。轉換後的檔案寫在原始檔旁，名稱含解析度——demo-1080p.mp4——並將路徑以檔案 URI 複製到剪貼簿，讓你能直接貼到接受檔案拖放的應用程式裡。

從終端機也能用，如果你已經知道自己要什麼：omarchy transcode ~/Videos/demo.mov mp4 1080p。還有 omarchy transcode ascii，會把圖片變成 ASCII 畫——那個主要用於品牌識別。

把它送到別處

拿到檔案後，Super + Ctrl + S 會開啟分享選單，透過 LocalSend 把它送到網路上另一臺裝置。這部分參見 GUI 程式。

開關、閒置與螢幕保護

原文：Toggles, Idle & the Screensaver

你日常改變的很多東西其實不是真正的「設定」，而是你開一小時又關掉的模式：晚上趕工時的夜間光線、簡報時的勿擾、看影片時的保持清醒。Omarchy 稱這些為 toggles（開關），它們的運作方式都一樣——一個快速鍵、一個選單項、一個指令，全部打到同一個開關。

開關選單

Super + Ctrl + O 直接開啟 Trigger > Toggle，或你也可以從 Omarchy 選單（Super + Space）走過去。那個清單裡的每一項都是一個你可以不用思考狀態存在哪裡就能直接翻轉的開關。

從終端機，同樣的開關是 omarchy toggle <thing>。單獨執行 omarchy toggle 可以看到整個群組。

觸控板、觸控螢幕與混合式 GPU 開關位於 Trigger > Hardware（Super + Ctrl + H）底下，而不是 Toggle 底下，因為它們只在你真的有該硬體時才會出現。觸控板與觸控螢幕的開關能撐過 Hyprland 重新載入——被停用裝置的名稱會存到一個小的狀態檔，Hyprland 開機時讀取它來再次停用該裝置。

Toggle 選單也帶了一些不是 omarchy toggle 指令但行為相同的東西：狀態列上的電池百分比、工作區版面（Super + L）、視窗間隙（Super + Shift + Backspace），以及單視窗正方形比例（Super + Ctrl + Backspace）。

這些大多隻是 ~/.local/state/omarchy/toggles/ 底下的一個旗標檔。如果你想在指令碼裡根據其中一個分岔，omarchy-toggle-enabled 會給你一個退出碼，而不必叫你自己去找：

omarchy-toggle-enabled screensaver-off && echo "screensaver is off"

這些旗標是以「關閉狀態」命名的——screensaver-off、suspend-off、bar-off——所以它們存在就代表該功能被停用。

狀態列上的指示器

某個模式開啟時，你會在頂部狀態列中央、時鐘旁邊得到一個小圖示。那就是指示器小工具，它攜帶聽寫、螢幕錄影、待處理提醒、夜間光線、勿擾與保持清醒。

未啟用的指示器是隱藏的。把遊標移到它們周圍的區域，它們會以暗色淡入，讓你不必知道快速鍵也能點它來開啟。點一個已啟用的則把它關掉。如果你希望它們一直全部可見，把 ~/.config/omarchy/shell.json 中 omarchy.indicators 專案的 alwaysShow 設為 true——狀態列小工具怎麼設定參見頂部狀態列。

夜間光線

Super + Ctrl + N 把螢幕暖化到 4000K，再按一次回到 6500K。它由 hyprsunset 驅動，若尚未執行，這個開關會幫你啟動它。

預設上 hyprsunset 完全不會影響你的螢幕。~/.config/hypr/hyprsunset.conf 出廠時帶的是一個 identity（不變）設定檔，正是為了讓螢幕在你要求暖色之前保持不變。如果你希望它按時鐘切換，把它換成時間設定檔：

profile {
    time = 20:00
    temperature = 4000
}

然後在 ~/.config/hypr/autostart.lua 加入 o.launch_on_start("hyprsunset")，讓它在登入時啟動。開關所用的 4000K/6500K 搭配是固定的，所以想要不同色溫就得去改設定檔。

勿擾模式

Super + Ctrl + , 會靜音通知。開啟期間不會彈出任何提示，狀態列上也會坐著一個帶斜線的鈴鐺指示器，提醒你桌面為何變安靜了。

但沒有任何東西會遺失。被靜音的通知會直接寫進你的通知歷史，那正是你回來後想知道自己錯過了什麼時所需的紀錄。用 Super + Shift + Alt + , 開啟它。通知的其他故事參見通知快報。

仍有兩種訊息能穿過：Omarchy 自己針對你剛做完的事所發的確認提示（「主題已變更」、「螢幕截圖已儲存」），以及從命令列送出的重要警示。那些把所有訊息都標成重要以便強行擠到你面前的聊天應用程式不算數。

閒置

Omarchy shell 負責閒置行為，而時序是 ~/.config/omarchy/shell.json 裡最上層的 idle 區塊：

{
  "version": 1,
  "idle": {
    "screensaver": 150,
    "lock": 300
  }
}

兩個數字都是從你開始閒置那一刻算起的秒數——不是彼此相對於。所以用預設值，螢幕保護在兩分半後出現，而鎖定畫面在五分鐘時接管，不論螢幕保護有沒有跑過。儲存檔案後 shell 會立即採用新的時序。

如果你在鎖定期限前關掉螢幕保護，那也算活動，待處理的鎖定會被取消。你不會因為瞄一眼自己的機器就被鎖在外面。

要完全停止閒置鎖定，Super + Ctrl + I——或 omarchy toggle idle——把保持清醒開啟，狀態列上就會出現咖啡杯指示器。這是長時間簡報前或想看一個建置跑完時該按的鍵。再按一次則回到正常。omarchy toggle idle status 會以 JSON 印出目前狀態，如果你需要從指令碼讀取。

這篇講的是鎖定與螢幕保護，不是電源。休眠與偽休眠有它們自己的設定，見系統休眠。

螢幕保護

Omarchy 的螢幕保護是 ASCII 藝術跑過隨機文字效果，每個螢幕一個例項。任何按鍵或滑鼠移動都能退出。

你可以從 System > Screensaver（Super + Esc）按需啟動它，它會強制跑出來，即使你已經關掉閒置螢幕保護。預設沒有繫結快速鍵。

omarchy toggle screensaver 是用來關掉閒置螢幕保護的，如果你寧願從工作直接跳到鎖定。它需要一個它知道怎麼配置的終端機——Alacritty、Foot、Ghostty 或 Kitty——如果你的預設終端機是別的，它會告訴你。

它畫的標誌是可以換的，在 Style > Screensaver 底下。上傳 png 或 svg，Omarchy 會把它轉成 ASCII。參見品牌識別。

鎖定畫面

Super + Ctrl + L 鎖定機器。它會從 Omarchy shell 執行鎖定畫面、關掉螢幕、把你的鍵盤配置重設為第一個，以免你用錯字母表輸入密碼，並且——如果你有在跑的話——連帶鎖上 1Password。

鎖定畫面接受密碼，你設定指紋後它也接受指紋。這部分與其他驗証方式涵蓋在硬體驗証裡。

Omarchy 命令列工具

原文：Omarchy CLI

Omarchy 通常透過快速鍵與 Omarchy 選單（Super + Space）控制。但你也可以透過 omarchy CLI 控制它。當你讓 AI agent 幫你一起做自訂或設定時，這特別有幫助。

CLI 可以存取選單與其他方式所用的所有內部工具。在終端機執行 omarchy 就能看到所有可用專案。

它看起來大致像這樣：

~ ❯ omarchy
Omarchy command center

Usage:
  omarchy <command> [args...]
  omarchy commands [--all] [--json] [--check]
  omarchy <group> --help
  omarchy <group> <command> --help

Common commands:
  omarchy update              Update Omarchy and system packages
  omarchy theme list          List available themes
  omarchy theme set <name>    Apply a theme
  omarchy font list           List available fonts
  omarchy screenshot          Take a screenshot
  omarchy debug               Print debugging information

Groups:
  agent          AI coding agent usage data
  audio          Audio input and output controls
  bar            Omarchy shell bar layout and settings
  battery        Battery status helpers
  bluetooth      Bluetooth device controls
  branch         Omarchy git branch management
  branding       About and screensaver branding
  brightness     Display and keyboard brightness
  capture        Screenshots and screen recording
  channel        Omarchy release channel management
  clipboard      Clipboard helpers
  cmd            Command and shortcut helpers
  config         System configuration helpers
  debug          Diagnostics and support logs
  ...

你也可以深入每一個群組：

~ ❯ omarchy capture
Capture commands - Screenshots and screen recording:
  omarchy capture qr                          Decode a QR code from a screenshot region
  omarchy capture screenrecording [...]       Start or stop screen recording
  omarchy capture screenrecording with webcam Pick a webcam and start a screen recording with it
  omarchy capture screenshot [...]            Take a screenshot
  omarchy capture text                        Extract text from a screenshot region with OCR
  omarchy capture webcam resize <size>        Resize the active webcam recording overlay

每個指令也都接受 --help，不論你是問整個群組（omarchy capture --help）還是單一指令（omarchy capture screenshot --help）。

從終端機開啟選單

Omarchy 選單也可以被指令碼呼叫，這對你自己的快速鍵繫結很方便。omarchy menu 在根層開它，而你可以直接命名來跳到樹中的任何位置：omarchy menu summon style.theme 直接到主題選擇器，omarchy menu toggle system 開啟系統選單，若已開則關閉，而 omarchy menu close 則把它收起來。

終端機

原文：Terminal

Foot 是 Omarchy 的預設終端機。它快、輕量，連老電腦都能跑。不過它不支援原生分頁或分割。

如果你用 Tmux，可能不在意；如果不用的話，我們也完全支援 Alacritty、Ghostty 與 Kitty 作為選項。在 Omarchy 選單的 Install > Terminal 下選擇你偏好的。

你用 Super + Return 啟動新終端機。（這個繫結會自動指向你透過 Install > Terminal 安裝的終端機，你可以在 Setup > Defaults > Terminal 下切換已安裝的終端機。）

Tmux

Tmux 為窗格、視窗（即分頁）與可恢復的工作階段提供一致、可程式化的介面，不論你用哪種終端機。它甚至能在遠端主機上運作，所以當你 SSH 進一臺伺服器時，也能使用同樣的方式。

你在新終端機中用 Super + Alt + Return 啟動新的 Tmux 工作階段。因為 Tmux 是常駐行程，即使你關掉那個終端機，也能恢復工作階段。只要按 Ctrl + Space（稱為前置鍵）然後按 s，就能看到所有使用中的工作階段。

Omarchy 出廠附帶一份根據人體工學最佳化的 Tmux 設定，它有很多快速鍵要學，請把速查表放在手邊。

Tmux 版面函式

因為 Tmux 可程式化，我們可以用函式來建立版面。Omarchy 出廠附帶四個用於常見開發者版面的函式。

tdl [agent] 會啟動一個像 IDE 的三方分割介面：左邊是 $EDITOR，右邊是你選的 AI agent（例如 c 代表 opencode、cx 代表 Claude、codex 代表 OpenAI），下方則是一個終端機。

所以 tdl c 會啟動這個（或直接打 ic）：

你也可以用 tdl c cx（opencode + claude）啟動第二個 agent（或直接打 icx）：

還有 tds，它會啟動一個四方格：左上編輯器、右上即時 diff 監視器、左下終端機、右下 opencode。

你還可以用 tdlm [agent] 為當前目錄下的每個子目錄啟動這個版面配置，然後用 alt + 1/2/3/4/5/... 導航：

最後，你可以用 tsl [panes] [command] 啟動一整群 agent。所以 tsl 4 c 會給你一個四格網格的 opencode agent：

Neovim

原文：Neovim

Neovim 是 vi 編輯器的現代實作，vi 是 Bill Joy 早在 1976 年創造的。它是一個模式化編輯器，插入模式與命令模式分開；只要學會那套深不見底的按鍵指令裡的哪怕一小部分，就會覺得像超能力。但它同時也是一道相當陡的學習曲線！

如果你完全沒碰過 vim 風格的編輯，我推薦你看看 YouTube 上 ThePrimeagen 的 Vim As Your Editor 系列。它會教你基礎。只要知道：不像那些更相似的主流編輯器，你要花更久才能對 vim 有基本熟悉度。但一旦你做到了，報酬也更大。

然後，Neovim 基本上是無限可配置的。如果你真的想玩到極致，可以從零建立自己的 Neovim 設定。有一個來自 Typecraft 關於從零設定 Neovim 的好課程，ThePrimeagen 也有一個。

但 Omarchy 出廠附帶一套完整的 Neovim 設定——omarchy-nvim 套件——它被細心調校到能展示開箱即用的最佳可能。你連一行設定都不用寫！它建立在 LazyVim 之上，LazyVim 是 Neovim 外掛與配置的發行版。它很棒。

LazyVim 基礎

如前所述，這篇短短的介紹不會教你 vim，但我可以示範幾個 LazyVim 基礎以及如何在其中穿梭。

首先，Neovim 有 leader key 的概念。它基本上是通往所有指令的入口。LazyVim 把它設為 Space。所以只要按下去、等一下，你就會看到一堆選項內嵌說明，像這樣：

以下是我經常使用的一些基礎指令：

• Space Space —— 模糊尋找當前目錄下任何檔案。
• Space S G —— 用 grep 搜尋所有檔案並帶預覽。
• Space E —— 切換檔案樹開／關。
• Ctrl + W W —— 從檔案樹跳到編輯器再跳回來。
• Shift + H —— 在開啟的分頁（vim 稱之為 buffer）之間向左移動。
• Shift + L —— 在開啟的分頁之間向右移動。
• Space B D —— 關閉分頁。
• Space B O —— 除了目前分頁外關閉所有其他分頁。
• Space G G —— 從當前目錄在浮動窗格中啟動 LazyGit。
• Space U W —— 切換自動換行（soft wrap）。

當你在檔案樹裡時（用 Space E 叫出，用 Ctrl + W W 跳過去），你可以用 a 新增檔案，或用 A 新增目錄。在樹中按 ? 可看到所有指令。

如果你想掌握基礎 vim 語言，我寫過關於三部分語法以及怎樣使出那些赫赫有名的連招！

你可以在 LazyVim Keymaps 頁面看到所有可能的指令。

啟動 Neovim

你可以用 Super + Shift + N 啟動 Neovim（該繫結會啟動你的預設編輯器，開箱即為 Neovim），但通常從終端機操作更方便：導航到你想工作的目錄，然後打 n。n 是 nvim 的別名，它預設會用目前目錄開啟。你可以用 n myfile.txt 開啟單一檔案。

用 Neovim 做 sudo 編輯

如果你需要編輯只有超級使用者能改的檔案，可以用 neovim 並帶上你所有的外掛設定，執行 sudoedit /etc/sudoers.d/00-sudo-only-file。

AI

原文：AI

Omarchy 把 AI 程式開發 agent 當作一等公民，但它不會替你先選一個最愛的。相反地，每個主要的程式開發 agent CLI 都已預先接好成為延遲載入的啟動器。這些啟動器是 ~/.local/bin/ 中由 mise 管理的小存根，所以在你真的第一次執行它們之前，什麼都不會下載。叫用其中任何一個並在提示時完成驗証即可：

ori 是比較特別的一個：它拿其他 harness 去跑 OpenRouter 的整個模型目錄，所以 ori claude、ori codex 或 ori opencode 會在你能指定的任何模型上啟動那些 agent，而 ori code 則是 Ori 自己的 agent。

要用同樣方式包裝另一個 CLI，執行 omarchy-mise-install <package> [command-name]。當你執行 omarchy update（或 mup 別名）時，這些存根會跟 mise 管理的其他一切一起保持最新。

預設 agent

用 omarchy default agent <name> 選擇你的預設 agent，或在 Omarchy 選單（Super + Space）的 Setup > Defaults > Agent 下選擇。如果該 agent 尚未安裝，選擇它會先幫你安裝。全新的 Omarchy 會用一則一次性通知邀請你做這個選擇。

選好之後，Super + Shift + Ctrl + A 會在一個專用終端機視窗中啟動預設 agent（若你還沒選，則叫出選擇器）。你也可以直接讓它帶著任務啟動：omarchy agent prompt "Review this project"。用這種方式啟動的 agent 會以各自「不停下來問」的模式無人看守地執行，所以要做好它們真的會動手的準備！而因為 agent 拒絕在 home 目錄裡記住信任，從 $HOME 啟動的會在 ~/Work 開始。

也有終端機捷徑：a 在當前終端機中就地執行預設 agent，而 c、cx 與 cy 分別直接啟動 OpenCode、Claude Code 與 Codex（同樣在它們的自動準許模式）。主題變更也會同步到 agent：當你切換 Omarchy 主題時，Claude Code、Pi 與 OpenCode 都會跟著換。

agents 面板

當 Omarchy 首次在機器上發現 AI 程式開發用量時，頂部狀態列會長出一個 agents 圖示（在那之前都不會佔用空間）。它背後的面板在同一個地方追蹤每一種訂閱：你的方案、5 小時工作階段與每週限制已使用的百分比（或剩餘的預付餘額），以及按日與按模型的 token 用量。Claude Code、Codex 與 Fireworks 都開箱即用。

左鍵點狀態列圖示開面板，右鍵則啟動你的預設 agent。背後的用量記錄每 15 分鐘由 omarchy agent usage-update 重新產生，面板甚至可以透過同步資料夾合併你其他機器的用量。完整設定見 $OMARCHY_PATH/shell/plugins/agents/ 下的 README。

崩潰診斷

Omarchy 會監看 systemd-coredump 的行程崩潰。有東西 segfault 時，你會收到一則「Process crashed」通知——點它，崩潰就會連同 Omarchy 的 diagnose-crash 技能一起交給你的預設 agent，該技能會帶 agent 從 core dump 建立事實，並判斷這個崩潰值不值得回報上游。你也可以手動對 coredumpctl list 中任何 PID 執行 omarchy agent crash <pid>。

監看預設是開的。在 Trigger > Toggle > Crash Capture（或用 omarchy toggle crash-capture）關掉它，通知就會停止；omarchy agent crash <pid> 仍可手動使用。

崩潰也可以一次靜音一個程式，這正是診斷最後會提供給你的選項。omarchy crash mute hyprland 只停掉該程式的通知，omarchy crash mute hyprland off 把它們恢復，而單獨執行 omarchy crash mute 則列出你已靜音的東西。它接受二進位檔的路徑就和接受名稱一樣樂意，所以 omarchy crash mute /usr/bin/hyprland 做的是同一回事。名稱含空格時請加引號，例如 omarchy crash mute 'Some App'。其他一切仍然會通知，而被靜音的程式仍然會崩潰——這只是隱藏提醒，不是修好任何東西。

桌面應用程式

Install > AI 選單也帶了幾個圓形介面的 AI 應用程式：ChatGPT 桌面版，以及用來跟 xAI 模型聊天的 Grok Bot。

本機 LLM

Omarchy 推薦兩種跑本機 LLM 模型的方式：LM Studio 與 Ollama。LM Studio 提供 GUI 介面來尋找開放權重模型、安裝並執行它們，是輕鬆上手的好方法。Ollama 則提供 CLI 做類似的事。但如果你是本機模型新手，我建議從 LM Studio 開始。兩者都可以在 Omarchy 選單的 Install > AI 下安裝。

Omarchy 技能（Skill）

Agent 技能幫助 AI 以特定方式使用特定工具，而 Omarchy 出廠附帶一個用於調整系統的預設技能。比如微調你的 Hyprland 設定、調整狀態列，甚至從零建立新主題。它被符號連結到各 harness 的技能目錄：Claude Code（~/.claude/skills）、Codex（~/.codex/skills）、Pi（~/.pi/agent/skills）、Antigravity（~/.gemini/config/skills）以及通用的 ~/.agents/skills 位置，所以大多數 harness 都會自動抓到它。

但你應該把這個技能當作實驗性的。不同模型會以不同效果使用它。最好先跑「計劃模式」，讓你對 agent 想改什麼有概念。然後也要準備好回滾變更，甚至叫用 omarchy reinstall configs，以防 agent 把一切弄得一團糟。

開發工具

原文：Development Tools

其他編輯器

Omarchy 預設附帶 Neovim，但如果你想要更主流、更熟悉的東西，可以叫出 Omarchy 選單（Super + Space），看看 Install > Editor 底下的選項。那裡有 VSCode、Cursor、Zed、Sublime Text、Helix、Vim 與 Emacs。如果找不到你想要的，去看看 Install > Package，確認它是不是在 Arch 套件裡（若沒有，試試 Install > AUR 查 AUR）。

有提供主題搭配的是 VSCode、Cursor、VSCodium 與 Helix。

你可以在 Setup > Defaults > Editor 下設定全系統的預設編輯器。

環境

Omarchy 支援透過 Omarchy 選單（Super + Space）的 Install > Development 區段，設定一整套開發環境。你當然會找到 Ruby on Rails，也有三種主要 JavaScript runtime（Node.js、Bun、Deno），以及 Laravel、Symfony 等熱門 PHP 框架。哦，還有 Go、Rust、Python、Java、Elixir（含 Phoenix）、.NET、OCaml、Zig、Clojure 與 Scala。選擇非常廣！

這些環境大多由 Mise 管理。它是一個讓你可以在同一臺機器上安裝並執行多個程式語言版本的工具。就像 Ruby 的 rbenv 或 rvm、Python 的 virtualenv，但它對一堆不同環境都能用。

要安裝比如 Ruby，你可以執行 mise use -g ruby，它既會安裝 Ruby，也會把它設為全域預設。或者，如果你的專案有 .ruby-version 檔，你可以直接在該專案根目錄執行 mise i。

Docker

Docker 幾乎不需要介紹。它讓你執行隔離的容器，而 Omarchy 安裝了把它跑好所需的一切，包括 Docker 本身與 Docker Compose。

預設上你的使用者不在 docker 群組裡。那個群組實際上是無密碼的 root——任何在裡面的東西都能 docker run -v /:/host 接管整臺機器——所以一個以你身分執行的惡意指令碼或依賴，否則就離 root 只有一個指令之遙。因此命令列上你用 sudo 執行 Docker（sudo docker ps、sudo docker compose up），而與 daemon 溝通的圖形工具——Super + Shift + D 的 Docker TUI 與 Windows 虛擬機器——則在需要時請求授權。如果你想要回來那種免群組設定的便利，並理解其中取捨，可以從 Setup > Security > Sudoless Docker（或執行 omarchy-setup-security-sudoless-docker）啟用它，它會在警告後把你加進 docker 群組；之後單純的 docker 與 d 別名又能不用 sudo 使用。

記得去看看用 Super + Shift + D 在帥氣的 TUI 中管理容器的 Lazydocker 指令；除非你已啟用免 sudo Docker，否則第一次使用時它會請求授權。

你可以在 Omarchy 選單的 Install > Development > Docker DB 下，為本機開發在 Docker 中設定常見的資料庫。

GitHub CLI

GitHub CLI 讓你用 GitHub 帳號驗証並用它複製私人儲存庫。它被接成其中一個延遲載入的 mise 存根，所以你第一次執行 gh 時它會自行安裝。要驗証，執行 gh auth login。然後你可以用 gh repo clone org/repo 複製私人儲存庫。

你也可以用這個指令執行一堆其他 GitHub 操作。單獨執行 gh 就能看到所有可能。

也有一個延遲安裝的 ghui 存根，讓你用 TUI 管理 pull request。而且 lazygit 已預先安裝，如果你想也從 TUI 驅動 git 本身的話。

Shell 工具

原文：Shell Tools

除了標準的 Linux 工具，Omarchy 也附帶一堆強化的 shell 工具。以下是幾個關鍵的。

fzf

fzf 透過 ff 別名提供模糊檔案尋找。到任何目錄，打 ff，你就能模糊找到該樹中的任何檔案，同時在右側看到你逐步縮小範圍的檔案預覽。

你可以用 Ctrl + R 讓 fzf 模糊搜尋你的指令歷史。

這個工具也被 Neovim 在你打 Space Space 時使用。

完整手冊可用 man fzf 檢視。

Zoxide

Zoxide 是 cd 的替代品。它會記得你去過的目錄，所以下次你更容易跳過去。比如你執行過一次 cd ~/.config/omarchy。下次，你只要打 cd omarchy（甚至只要 cd oma），Zoxide 就會直接帶你到那裡。

完整手冊可用 man zoxide 檢視。

ripgrep

ripgrep 用 rg <pattern> <path> 搜尋檔案內容，例如 rg Controller app/ 會找到 app 目錄中所有提及 Controller 的地方。

這個工具也被 Neovim 在你打 Space S G 時使用。

完整手冊可用 man rg 檢視。

eza

eza 是 ls 的替代品。它給你帶更多資訊、顏色與圖示的目錄列出。預設上，eza 已被別名為 ls。你也可以用 lt 取得兩層巢狀的列出。lsa 給你包含隱藏檔案的列出，而 lta 則是包含隱藏檔案的巢狀列出。

完整手冊可用 man eza 檢視。

fd

fd 是更易用的 find 替代品。用 fd person.rb 在當前樹中找一個叫 person.rb 的檔。fd person.rb / 會搜尋整個檔案系統。fd person.rb / -H 搜尋整個檔案系統，包括隱藏目錄。

完整手冊可用 man fd 檢視。

bat

bat 是帶語法高亮、行號與分頁的 cat。執行 bat somefile.rb，你就會明白為何很難再回去。它也在其他地方靜靜為你工作：它是幫你的 man page 上色的東西，也是在 ff 中繪製預覽的東西。

完整手冊可用 man bat 檢視。

tldr

tldr 是那些開頭先講三頁歷史才給你看一個範例的 man page 的解藥。tldr tar 給你真正想要的那幾種用法。

yt-dlp

yt-dlp 從 YouTube 與數百個其他網站下載影片。yt-dlp <url> 把目前可用的最佳品質抓進當前目錄。

完整手冊可用 man yt-dlp 檢視。

try

try 讓你能用帶日期的目錄輕鬆管理程式實驗。所有實驗都放在 ~/Work/tries，你可以用 try 存取它們。

Shell 函式

原文：Shell Functions

Omarchy 附帶一組 shell 函式，用來簡化常見任務並封裝錯綜複雜的引數呼叫。

壓縮

• compress [file/dir]：從檔案／目錄建立 tar.gz 壓縮檔。
• decompress [file.tar.gz]：解開 tar.gz 檔案。

磁碟

• iso2sd [image.iso]：用指定的 iso 檔在 SD 卡上建立可開機磁碟，並以互動方式選擇磁碟。
• format-drive [device] [name]：把整顆磁碟格式化為單一 exFAT 分割區（Windows 與 macOS 也能用）。不加引數執行可看到可用磁碟。小心！

開發版面

給 tmux 的即時多窗格開發版面：

• tdl [ai]：建立含編輯器、AI agent 與終端機的 Tmux Dev Layout。使用 agent 別名，例如 tdl c 代表 opencode、tdl cx 代表 Claude Code，或傳第二個 agent 同時跑兩個，例如 tdl c cx。
• tds：建立含編輯器、diff 監看（透過 hunk diff --watch）、終端機與 opencode 的 Tmux Dev Square。
• tdlm [ai]：為當前目錄中每個子目錄建立一個 tdl 視窗。
• tsl [count] [command]：建立一群以網格平鋪的窗格，全部執行相同指令（很適合 AI agent）。

同樣的版面在 Herdr 中也有，分別是 hdl、hds、hdlm 與 hsl。

Git worktree

• ga [branch]：在當前儲存庫旁邊建立新的 worktree 與分支，並跳進去。
• gd：移除當前 worktree 及其分支（會先請求確認）。

Rsync 監看器

• rsw [source] [destination]：啟動背景監看器，每當有任何變更就把來源 rsync 到目的地。目的地可以是遠端主機，例如 rsw ~/Work/app nyc-dev:Work/app。
• lsw：列出所有使用中的監看器。
• dsw：停止所有使用中的監看器。

SSH 連線埠轉送

非常適合用 localhost 的安全上下文許可權對遠端機器做 web 開發。

• fip：透過 SSH 從遠端主機轉送一或多個連線埠到 localhost。
• dip：中斷一或多個已轉送的連線埠。
• lip：列出所有使用中的 SSH 連線埠轉送。

比如你在可透過 nyc-dev 存取的機器上於連線埠 3000 啟動了一個 dev server，那麼你可以執行 fip nyc-dev 3000 轉送該連線埠，讓 localhost:3000 實際上到達 nyc-dev:3000，但不需要 SSL 憑証就能建立測試 WebSocket 之類所需的安全上下文。

SSH 重新連線

ssh 本身被包在一個函式裡，當遠端 tmux、Herdr 或編輯器佔用了終端機而連線中斷時，它會清理終端機，並在互動式工作階段掉落時自動重新連線（Ctrl-C 會停止重試迴圈）。

TUI 文字介面程式

原文：TUIs

Lazygit

Lazygit 是 GitHub Desktop 之類應用程式非常討喜的替代品，而且它在終端機裡跑。

你可以直接執行它：到任何由 git 管理的目錄，執行 lazygit。或者你可以在 Neovim 裡跑它，用 Space G G 啟動。

你用 Tab 在不同窗格之間跳。在 Files 窗格，用 Space 選擇要暫存的檔案，然後用 c 建立新提交。用 ? 可以看到所有可用指令。

Lazydocker

Lazydocker 也是本著與 Lazygit 相同的精神製作的，同樣給你一個終端機介面來管理容器與映像檔。

你可以用 Super + Shift + D 啟動它。

你用 s 停止容器，或用 r 啟動／重新啟動它。用 ? 看所有指令。

Btop

Btop 是一個漂亮的資源管理器，顯示記憶體、CPU、磁碟與網路用量。它也列出所有使用中的行程，並讓你管理它們。

Omarchy 稱它為 Activity，你按 Super + Ctrl + T 啟動它。它以浮動視窗開啟，你可以用 Super + T 把它平鋪。

Herdr

Herdr 是一個終端機工作區管理器，給你工作區、分頁與窗格，並把它們全部維持在一個可以脫離之後再回來的常駐工作階段中。

你用 Super + Ctrl + Return 啟動它（或重新接上你現有的工作階段）。Omarchy 附帶一份映象其 Tmux 設定的 Herdr 設定，所以這裡的前置鍵也是 Ctrl + Space。你可以用 Super + Ctrl + K 瀏覽所有快速鍵。

Fastfetch

Fastfetch 顯示系統資訊，如核心版本、開機時間、主題、CPU、記憶體等。它是熱門 neofetch 工具的後繼者。

Omarchy 把它包裝為 Omarchy 選單（Super + Space）中的 About。

磁碟用量

當磁碟滿了而你完全不知道是什麼吃掉的，從應用程式啟動器（Super + Space）啟動 Disk Usage。它是dua 的互動模式，指向整個檔案系統，讓你可以一路走入罪魁禍首的目錄（從最大開始排序），並直接從裡面刪除。

Cliamp

Cliamp 是一個受 Winamp 2.x 啟發的復古終端機音樂播放器，內建 lo-fi beats 電臺。用 Super + Shift + Alt + M 啟動它，或從 Omarchy 選單的 Apps 底下啟動。按 ? 看完整快速鍵清單。

那 Wi-Fi 與藍牙呢？

你不會找到 Wi-Fi 與藍牙的 TUI——那些工作屬於 Omarchy shell。點頂部狀態列的 Wi-Fi 圖示（或按 Super + Ctrl + W）來檢視網路並連線，點藍牙圖示（或按 Super + Ctrl + B）來配對並連線裝置。完整故事見網路。

加入你自己的

任何終端機程式都能得到完整的應用程式待遇。到 Omarchy 選單（Super + Space）的 Install > TUI，給它一個名稱、一個啟動指令、一個視窗樣式與一個圖示，它就會像任何其他應用程式一樣出現在應用程式啟動器裡。你可以在 Remove > TUI 下再次移除它。

GUI 圖形介面程式

原文：GUIs

Files（檔案）

Files（Nautilus）是圖形檔案管理員。Super + Shift + F 開啟它，而 Super + Shift + Alt + F 會在你的終端機所在目錄開啟它，省下很多點選。Ctrl + L 讓你輸入路徑，而在任何檔案上按 Space 則給你快速預覽，不必開啟任何東西。

插上 USB 隨身碟或 SD 卡，它會自動掛載，於是就出現在側邊欄裡。更多複雜的事——格式化磁碟、檢查 SMART 健康度、建立分割區——就從應用程式啟動器（Super + Space）啟動 Disks。

雙擊遵循合理的預設：圖片用 imv 開、影片用 mpv、PDF 用 Document Viewer、純文字用 Neovim。

Obsidian

Obsidian 是一款免費且高度可擴充的筆記應用程式，使用簡單的 Markdown 檔案儲存。

Obsidian 對所有用途都免費，包括個人、商業與非營利使用。

Obsidian 也提供商業同步外掛，可與 iOS 及 Android 上的行動應用程式同步（參見 定價頁）。

你用 Super + Shift + O 啟動 Obsidian。要使用主題同步，你必須在設定裡選擇 Omarchy 主題。

Omawrite

Omawrite 是 Omarchy 自家的極簡 Markdown 寫作應用程式。沒有儲存庫、沒有外掛，只有你和文字。

你用 Super + Shift + W 啟動 Omawrite。

Pinta

Pinta 是一款基礎圖片編輯工具，很適合裁切、縮放與其他基礎操作。別把它想成 Photoshop 的替代品就好。但它還是有魔術棒和圖層！

你透過應用程式啟動器（Super + Space）啟動 Pinta。

Aether

Aether 是一款主題應用程式，能從背景圖片擷取顏色並把它們變成一套完整、和諧的主題。這是製作自己的主題最簡單的方法。

你透過應用程式啟動器（Super + Space）啟動 Aether。

LocalSend

LocalSend 讓你傳檔案給同網路上其他安裝了該應用程式的裝置，就像 Apple 的 AirDrop。不過它是跨平臺的，所以你可以與 Windows、macOS、Android、iOS 及當然 Linux 互相傳檔。

你可以用 Super + Ctrl + S 或在 Omarchy 選單的 Trigger > Share 下開啟分享選單。它給你四個選項：

• Clipboard：把你複製的東西以文字檔傳送。很適合把連結或程式碼片段弄到手機上，而不必寄信給自己。
• File：開啟檔案選擇器，你可以一次選多個。
• Folder：傳送整個目錄。
• Receive：開啟 LocalSend 本體，讓另一臺裝置可以傳東西給你。

從終端機也能做同樣的事：omarchy share clipboard、omarchy share file [path] 與 omarchy share folder [path]。省略路徑就會得到選擇器。

你也可以直接從檔案管理員傳送：在 Nautilus 中右鍵點選取專案，選 Send via LocalSend。

Omarchy 的防火牆預設關閉，除了 LocalSend 的連線埠，所以這在全新安裝上就能直接運作。參見安全性。

LibreOffice

LibreOffice 是一套完整的辦公室包，含文書處理、試算表、簡報、繪圖應用程式等。它與 Microsoft Office 檔案相容，所以這是能開啟那些 Word 檔案的好方法。

你透過應用程式啟動器（Super + Space）啟動 LibreOffice。

Omacalc

Omacalc 是 Omarchy 自家的極簡計算機，以浮動視窗開啟。

你用 Super + Ctrl + Q 啟動 Omacalc（或按鍵盤上的計算機鍵）。

Signal

Signal 是端到端加密訊息的先鋒，對任何不想走大型科技集團的人來說都是很好的通訊選擇。

你用 Super + Shift + G 啟動 Signal。它不是基礎安裝的一部分，所以你第一次按時，Omarchy 會提議幫你安裝（它也在 Omarchy 選單的 Install > Service 底下）。

mpv

mpv 是一款簡單、快速的媒體播放器，幾乎能從任何來源播放任何東西。看影片很方便。

你透過應用程式啟動器（Super + Space）啟動 mpv，或直接在檔案管理員中雙擊影片。

OBS Studio

OBS Studio 讓你從多個輸入錄製或直播影片。你可以把螢幕錄影、網路攝影機與麥克風輸入混在一起。Omarchy 的螢幕錄影就是用它的。

你透過應用程式啟動器（Super + Space）啟動 OBS Studio。

Kdenlive

Kdenlive 是一款優秀的影片編輯器。很適合在分享從 OBS Studio 出來的影片前先處理它。

你透過應用程式啟動器（Super + Space）啟動 Kdenlive。

Omacut

Omacut 是 Omarchy 自家的極簡影片修剪器。當你只需要剪掉一段片段的開頭和結尾時，它比叫出完整的影片編輯器好用。

你透過應用程式啟動器（Super + Space）啟動 Omacut。

瀏覽器

原文：Browsers

Omarchy 出廠以 Chromium 作為預設瀏覽器。它是純開源建置版，配色與系統其餘部分一致，也正是 Super + Shift + Return 開啟的、以及每個網頁應用程式在裡面執行的瀏覽器。

如果 Chromium 不合你口味，你也不是非得用它。在 Omarchy 選單的 Install > Browser 下，你會找到 Chrome、Edge、Brave、Brave Origin、Firefox 與 Zen。選一個，Omarchy 會安裝它、設定它的政策目錄，並把你的當前主題套用到它上面。

把其中一個設為預設

安裝一個瀏覽器不會把它提升為預設。它上了機器之後，到 Setup > Defaults > Browser 選它——該選單只列出你實際已安裝的瀏覽器，並以勾號標示目前的預設。

從終端機則是：

omarchy default browser firefox

不加引數執行它會告訴你目前的預設。這會設定 XDG handler，所以不只是 Omarchy 的快速鍵會跟著改變——任何會開啟連結的東西，從聊天應用程式到終端機指令，都會走向你選的瀏覽器。

複製網址與下載影片

Chromium 家族的瀏覽器（Chromium 本身、Chrome、Edge 與 Brave）附帶兩個 Omarchy 擴充功能，能從瀏覽器伸出去觸及你係統的其他部分。

Copy URL 用 Alt + Shift + L 把目前分頁的網址放進你的剪貼簿。這比點進網址列再複製快，而且因為它走的是系統剪貼簿而非瀏覽器的，你會得到一則確認用的 Omarchy 通知，而且網址會立即可用在剪貼簿歷史與其他每個應用程式裡。也有工具列按鈕，如果你偏好點的話。

Download Video 用 Alt + Shift + D 抓取你正在看的頁面上播放的影片。它把網址交給 yt-dlp，所以它能用的遠不只 YouTube，下載會落在 ~/Videos。進度顯示在與音量和亮度相同的螢幕顯示（OSD）上，就地更新而不是堆疊通知。如果你希望檔案放到別的地方，設定 OMARCHY_YTDLP_DIR——環境變數要放在哪裡參見 FAQ。

兩個擴充功能都透過一個小的原生訊息主機與 Omarchy 溝通，該主機會隨著瀏覽器一起幫你安裝。正是這塊讓網頁上的影片能落到你的家目錄、讓網址能進你的剪貼簿管理器，而普通擴充功能自己做不到。

這些只適用於 Chromium 家族。Firefox 與 Zen 不會得到它們。

Firefox 與 Zen

Firefox 與 Zen 是另一個家族，所以它們得到不同待遇：Omarchy 為合理的預設值安裝一份政策檔，並把它們切到原生 Wayland 模式，這是你在分數縮放與順暢觸控板捲動時會想要的。

它們不會得到上面的 Chromium 擴充功能，也不會被 Omarchy 套用主題，所以那部分的體驗得由你自己設定。

再次移除

你在這裡安裝的任何東西都可以在 Remove > Browser 下移除。Chromium 不在那份清單上——它是基礎系統的一部分。

商業軟體與服務

原文：Commercial apps/services

Omarchy 主要專注於提供免費、開源軟體，但它對此並不教徒式狂熱。有時最好的解決方案就是商業產品，那也完全沒問題。以下是我們提供簡易安裝的一些選項。

1Password

把密碼放在密碼管理器裡是最佳實務。如果你跟團隊一起工作，更是加倍如此。而 1password 是很棒的解決方案，它還附帶命令列工具，能把金鑰查詢整合進指令碼。

你用 Super + Shift + / 啟動 1Password。如果尚未安裝，該快速鍵會先觸發安裝（你也可以用 Omarchy 選單的 Install > Service > 1Password）。安裝程式也會幫 Chromium 設定好 1Password 擴充功能。

Bitwarden

Bitwarden 是密碼管理器領域的開源替代品，其免費方案涵蓋大多數個人使用。從 Omarchy 選單的 Install > Service > Bitwarden 安裝它，它也會一併帶上 Bitwarden 命令列工具。

Spotify

Spotify 是全世界最受歡迎的串流音樂服務。而它的 Linux 應用程式提供了你期待的一切，包括離線播放。

你用 Super + Shift + M 啟動 Spotify。跟 1Password 一樣，如果 Spotify 尚未安裝，該快速鍵會先觸發安裝（或使用 Omarchy 選單的 Install > Service > Spotify）。

Dropbox

Dropbox 是在多臺機器間同步檔案、同時在雲端保留備份的好方法。要設定它，從 Omarchy 選單選 Install > Service > Dropbox。跑起來之後，把遊標移到狀態列右上方的系統匣，右鍵點 Dropbox 圖示完成設定。

Tailscale

Tailscale 是一個 mesh VPN，讓你能安全、極其簡單地透過網際網路存取自己所有的電腦與伺服器。要設定它，從 Omarchy 選單選 Install > Service > Tailscale。

它會在狀態列得到一個面板、一個給管理主控臺用的網頁應用程式，以及用於在機器間傳檔的 Taildrop——參見網路。

ONCE

ONCE 是 37signals 的一系列「買一次、在自己伺服器上跑」的軟體，比如 Campfire 聊天系統。從 Omarchy 選單選 Install > Service > ONCE 來安裝它，它會啟用其背景服務並把你帶進 ONCE 終端機介面，讓你自己接手。

NordVPN

NordVPN 是一項標準 VPN 服務，讓你能從世界各地大多數地區輸出流量。要設定它，從 Omarchy 選單選 Install > Service > NordVPN。它要求的重新開機之後，執行 nordvpn login 完成驗証。

網頁應用程式

原文：Web Apps

你可以用 Omarchy 選單（Super + Space）的 Install > Web App 加入自己的網頁應用程式。它會問你應用程式名稱、應用程式 URL，以及圖示 URL（如果它無法透過 favicon 取得）。你可以在 Dashboard Icons 找到許多熱門網頁應用的漂亮 PNG 圖示。

它們接著就可以透過應用程式啟動器（Super + Space）存取，並使用那個漂亮的無邊框網頁應用程式視窗。

如果你想移除一個網頁應用程式，只要到 Omarchy 選單的 Remove > Web App。

最好先使用一般瀏覽器登入你所有的帳號，再使用網頁應用程式捷徑。那個薄薄的包裝框與 1password 搭配不好，所以先直接登入比較簡單。

這些網頁應用程式的所有鍵盤快速鍵都可以在 ~/.config/hypr/bindings.lua 中變更。

當你在一個網頁應用程式裡時，可以用 Shift + Alt + L 把目前網址複製到剪貼簿。

預設上，Omarchy 已經附帶一堆預設應用程式：

HEY

HEY 是一項電子郵件與行事曆服務，對受不了 Gmail、Outlook 或 Apple Mail 的人來說是很好的替代品。它由 37signals 製作，而 Omarchy 也出自那裡。

你可以用 Super + Shift + E 啟動 HEY Email、用 Super + Shift + Alt + E 直接跳到撰寫新郵件，並用 Super + Shift + C 啟動 HEY Calendar。

Basecamp

Basecamp 是一項專案管理服務，幫助小團隊跑得更快、有更多進展。不必再把 Trello、Slack、Asana、Notion 之類的東西拼湊成一團，你可以用 Basecamp 把一切放在同一個地方。它由 37signals 製作，而 Omarchy 也出自那裡。

你可以用應用程式啟動器（Super + Space）啟動 Basecamp。

ChatGPT

ChatGPT 是全世界最受歡迎的 AI 聊天機器人。

你可以用 Super + Shift + A 啟動 ChatGPT。

Grok

Grok 是 xAI 的聊天機器人。

你可以用 Super + Shift + Alt + A 啟動 Grok。

WhatsApp

WhatsApp 是全世界最受歡迎的訊息服務之一，其網頁版對 Linux 來說是很好的選擇。

你可以用 Super + Shift + Alt + G 啟動 WhatsApp。

Google 應用程式

Google Messages、Google Photos、Google Maps 與 Google Contacts 也都以網頁應用程式的形式包含在內。

你可以用 Super + Shift + Ctrl + G 啟動 Google Messages、用 Super + Shift + P 啟動 Google Photos、用 Super + Shift + S 啟動 Google Maps。Google Contacts 可透過應用程式啟動器（Super + Space）取得。

X

X 是新聞爆發的地方。

你可以用 Super + Shift + X 啟動 X，並用 Super + Shift + Alt + X 直接去寫一則新貼文。

YouTube

YouTube 是全世界最受歡迎的影片平臺。

你可以用 Super + Shift + Y 啟動 YouTube。

Zoom

Zoom 是美國最受歡迎的視訊聊天系統。世界各地連線品質良好，而且不用付費帳號也能開 40 分鐘的會議。Omarchy 包裝了 Zoom 的網頁客戶端，而 Zoom 會議連結會直接在其中開啟。

你用應用程式啟動器（Super + Space）啟動 Zoom。

Discord

Discord 是大多數遊戲與開源社群逗留的地方，包括Omarchy 自己的社群。

你用應用程式啟動器（Super + Space）啟動 Discord。

遊戲

原文：Gaming

Omarchy 不只是為了生 產 力，它也是為了好玩，而還有什麼比遊戲更好玩？Omarchy 附帶一整套遊戲選項——Steam 與 RetroArch 負責原生與復古遊戲，Battle.net、Lutris 與 Heroic 負責非 Steam 商店，Moonlight 負責 PC 串流，Xbox Cloud Gaming + NVIDIA GeForce NOW 負責雲端，再加上永不過時的 Minecraft。

感謝 Valve 在 proton 相容層上令人賣佩的工作，現在 Linux 上有數萬款可玩的現代遊戲。哦，你知道 Steam Deck 其實跑的就是 Arch 嗎！

所有遊戲安裝器都在 Omarchy 選單（Super + Space）的 Install > Gaming 底下。如果你想撤銷其中一個，用 Remove > Gaming。

Steam

從 Omarchy 選單（Super + Space）選 Install > Gaming > Steam 來安裝 Steam。

安裝完之後，你就能用 Super + Space 啟動 Steam。

注意 Steam 可能要花 10-20 秒才啟動，而且它不會提供任何正在載入的視覺回饋。

RetroArch

從 Omarchy 選單（Super + Space）選 Install > Gaming > RetroArch 來安裝 RetroArch。它附帶完整的 libretro core 集，所以所有經典主機都涵蓋在內。

RetroArch 已完整預先設定好，並帶有漂亮的 CRT Royale 著色器，呈現完美的復古外觀。

要開始使用：

1. 把你的 BIOS 檔拖進 ~/Games/bios，把你的 ROM 拖進 ~/Games/roms。
2. 用 Super + Space 並輸入 retro 來啟動 RetroArch。
3. 掃描 ~/Games/roms 目錄，你就可以開始玩了。

你也可以用 Install > Gaming > RetroArch Game Launcher 給一個最愛的遊戲在應用程式啟動器裡自己一個專案，它讓你選一個 core 和一個 ROM，直接從 Super + Space 跳進遊戲。

Xbox Cloud Gaming

從 Omarchy 選單（Super + Space）選 Install > Gaming > Xbox Cloud Gaming 來安裝 Xbox Cloud Gaming 網頁應用程式。它「只是」該服務的網頁應用程式，但它啟動快，而且 1080p 跑得很好。

如果你已經有 Xbox Game Pass，這是玩 Fortnite 與其他無法在 Linux 原生執行的遊戲的可靠方法。

NVIDIA GeForce Now

從 Omarchy 選單（Super + Space）選 Install > Gaming > NVIDIA GeForce NOW 來安裝雲端遊戲服務 NVIDIA GeForce NOW。另一個玩 Linux 上無法原生執行遊戲的好方法。

Minecraft

從 Omarchy 選單（Super + Space）選 Install > Gaming > Minecraft 來安裝 Minecraft。

跟 Steam 一樣，注意登入或啟動後下一個畫面可能要等一陣子才出現，而你等待時不會得到任何回饋。

Xbox 控制器

從 Omarchy 選單（Super + Space）選 Install > Gaming > Xbox Controllers 來安裝藍牙 Xbox 控制器支援。透過藍牙（Super + Ctrl + B）配對控制器，它們就會在你所有遊戲裡運作。如果你只是用 USB-C 線直連控制器，就不需要這個。

Moonlight（從 PC 串流遊戲）

Moonlight 客戶端隨 Omarchy 預先安裝，所以你可以馬上從一臺執行 Sunshine 的 Windows PC 串流遊戲。透過 Super + Space 啟動 Moonlight。

如果你的 Omarchy 機器與遠端遊戲 PC 都是有線連線，體驗與本機遊玩毫無差別。把解析度拉到原生、重新整理率設為 120Hz、位元率拉到最大——這是在 Linux 上玩 Fortnite 之類競技射擊遊戲的最佳方式。

你也可以執行 omarchy install service sunshine 把一臺 Omarchy 機器變成主機，它會安裝 Sunshine 並為你的區域網路與 Tailscale 開啟 Moonlight 串流連線埠。

Battle.net

從 Omarchy 選單（Super + Space）選 Install > Gaming > Battle.net 來安裝 Battle.net。這給你暗黑破壞神、星海爭霸與魔獸世界之類的作品，作為在 GE-Proton 下執行的獨立安裝——不需要 Steam、Lutris 或 Heroic。

Lutris（Windows 遊戲）

從 Omarchy 選單（Super + Space）選 Install > Gaming > Lutris 來安裝 Lutris。Lutris 是用來玩 EA 與 Ubisoft Connect 等商店之 Windows 遊戲的方式，那些商店沒有上面提到的専用安裝器。

安裝過程有點卡卡的，有時看起來像什麼都沒發生——耐心點，它在背景工作。

Heroic Launcher（Epic Games）

從 Omarchy 選單（Super + Space）選 Install > Gaming > Heroic (Epic Games) 來安裝 Heroic Launcher。Heroic 讓你跑不依賴反外掛的 Epic Games 作品，例如 OddSparks——還有 GOG 與 Amazon Prime Gaming 的遊戲。遺憾的是，這意味著沒有 Fortnite、沒有 Rocket League——在 Tim Sweeney 走向 Linux 之前，這已經是最接近的了。

跟 Lutris 一樣，安裝遊戲時可能感覺慢又卡。給它時間。

填寫 PDF

原文：Filling out PDFs

Omarchy 附帶一個漂亮、基礎的 PDF 檢視器，叫做 Document Viewer。這就是你雙擊任何 PDF 時會開啟的程式。

但你只能用 Document Viewer 填寫已設定為表單的 PDF。如果你需要填寫沒有設定成表單的 PDF，或需要簽署 PDF，你得右鍵點檔案，選 Open With…，然後選 Xournal++。

Xournal++ 讓你用 T 工具在 PDF 上任何地方書寫。如果你需要簽署檔案，你會需要一張簽名圖片，可以用 Image 工具插入這個簽名並調整大小。

填完 PDF 後，用 File > Export as PDF 儲存最終版本。

Windows 虛擬機器

原文：Windows VM

Omarchy 提供一個簡單的方式，透過 Docker VM 來跑 Windows。你可以用 Omarchy 選單（Super + Space）的 Install > Windows 安裝它。

你的機器需要有 KVM 虛擬化，大多數都有——但有時在 BIOS 裡是關的，安裝器會在那種情況下告訴你。你也會需要磁碟空間：你分配給 Windows 的量，再加上映像檔本身大約 10GB。

安裝器會問要給多少 RAM、多少 CPU 核心、多少磁碟（64GB 或以上是合理的下限），然後問一組 Windows 使用者名稱與密碼。留空的話你會得到 docker / admin。下載要花一陣子——10-15 分鐘是正常的——你可以在瀏覽器開啟 http://127.0.0.1:8006 追蹤進度。瀏覽器在開啟主控臺前會要求同樣的使用者名稱與密碼。

使用它

安裝好之後，從應用程式啟動器啟動 Windows。它會在 VM 尚未執行時啟動它，並透過 RDP 全螢幕連上你。冷啟動時給它 15-30 秒。

RDP 工作階段攜帶聲音、你的麥克風與共享剪貼簿，所以在 Linux 與 Windows 之間複製文字就是能動。解析度會跟著你的視窗，而且 Omarchy 會把你的螢幕縮放傳過去，所以在 HiDPI 螢幕上不會是一團模糊。

當你關掉 RDP 視窗，VM 會自動關機。如果你希望讓它繼續跑——比如裡面有東西正在忙——改用 omarchy windows vm launch --keep-alive 啟動它。

其餘控制都在同一個指令上：

omarchy windows vm status    # 它在跑嗎？
omarchy windows vm stop      # 關掉它
omarchy windows vm launch    # 啟動並連線

共享檔案

你家目錄中的 ~/Windows 目錄會自動與 VM 共享。如果你希望檔案能被 Windows 存取，就放在那裡。VM 無權存取你檔案系統的其他任何部分，所以你不必擔心 Windows 那邊的任何壞東西。它自己的虛擬磁碟位於 ~/.windows。

那些熟悉的 home 路徑會留在各自的檔案系統上。它們也可以是符號連結，指向你擁有的目錄，當虛擬磁碟位於較大的磁碟上時這很有用。安裝器測量的是實際上包含 ~/.windows 的那個檔案系統上的可用空間，而不一定是包含你家目錄的檔案系統。

請把磁碟與共享路徑保持為分開、不重疊的目錄。移除時刻意清空磁碟目錄，但保留共享目錄。就在刪除之前，Omarchy 會執行一個有界限的包含關係檢查，若該檢查超時或無法證明兩棵樹是分開的，就拒絕移除任何東西。

在 VM 啟動前，Omarchy 會開啟並釘住那兩個目錄，然後把確切的目錄 inode 繫結掛載到 /var/lib/omarchy/windows/mounts 下每個使用者專屬的私有錨點上。Docker 只看得到那些受 root 保護的錨點。這既保留了自訂的磁碟位置，又防止另一個以你身分執行的行程在特権容器消費之前掉換已檢查的路徑。既有的磁碟與共享目錄在遷移期間會被收緊到 0700 許可權，讓其他本機帳號無法窺看其內容。

VM 的連線埠只繫結到 localhost，所以你網路上沒有任何東西能搆到那臺 Windows 機器。網頁主控臺也要求已設定的 Windows 使用者名稱與密碼，防止另一個本機帳號透過 8006 連線埠驅動 VM。

限制與授權

這套設定沒有 GPU 直通，所以不適合遊戲或影片剪輯。它是跑 Microsoft Office 或任何你絕對必須有的東西的好方法。

安裝的版本是 Windows 11 Pro，未啟用。你需要自己的授權金鑰才能使用受限功能。

如果這臺電腦出廠就帶 Windows，即使安裝了 Omarchy，OEM 金鑰仍在韌體裡。用 omarchy windows key 印出它。那個金鑰繫結這臺機器——它會在這套硬體上重新安裝的 Windows 啟用，但通常不會啟用 VM。

你可以稍後重新執行 omarchy-windows-vm install 來改變資源分配，它會根據你的回答重寫 VM 的設定。compose 檔本身現在位於 /var/lib/omarchy/windows/docker-compose.yml 且由 root 擁有——這是刻意的，這樣一個以你身分執行的行程就不能重寫它，然後讓特権啟動程式把你的整顆磁碟掛載進容器。如果你需要手動編輯它（例如要掛載一個 USB 裝置），用 sudo 編輯，並在 Dockur Windows 專案看看所有選項。

要徹底清掉這一切，用 Omarchy 選單的 Remove > Windows。那會刪除 VM 的磁碟及其所有資料，所以請先確認你在意的東西都已從 ~/Windows 拿出來。

其他套件

原文：Other Packages

Arch 在官方儲存庫與 Arch User Repository（AUR）之間，為幾乎任何型別的軟體提供了驚人的套件選擇。

使用也再簡單不過。到 Omarchy 選單（Super + Space）的 Install > Package，輸入你想要的套件。它會自動模糊篩選所有套件清單。（你也可以在終端機手動使用 omarchy pkg add [package]）。

AUR 也是一樣，只要用 Install > AUR。只要記得 AUR 沒有經過 Arch 團隊審查。它就像 RubyGems 或 npm。任何人都能上傳。

如果你想移除套件，可以用 Omarchy 選單的 Remove > Package。它會移除套件、設定檔與依賴項。（你也可以手動使用 omarchy pkg drop [package]）。

更新

原文：Updates

Omarchy 與你的套件透過 Omarchy 選單（Super + Space）的 Update > Omarchy 保持最新。

Omarchy 本身是以一般的 pacman 套件形式，從 Omarchy Package Repository 安裝的，所以一次更新會安裝最新的 Omarchy 發行版、執行任何待處理的遷移讓你的系統與最新版同步，並從 Omarchy Arch Mirror 與 AUR 更新所有系統套件（如果你安裝過任何 AUR 套件）。

有新發行版時，時鐘右邊會出現一個圓形箭頭圖示。點它，更新流程就會開始。

四個通道

Omarchy 沿四個通道更新：stable、RC、edge 與 dev。新安裝從 stable 通道開始，它跟隨官方發行版，以及那個落後最新版一個月的 stable Omarchy Arch 映象，讓我們能在任何需要更改設定的新不相容問題對人們造成困擾之前先抓到它們。

但如果你想幫忙找出那些潛在問題，你可以跑在 edge 通道。那會讓你的 Omarchy 套件跟隨最新的開發建置，並讓你一有新 Arch 套件就更新。只有在你有 Linux 經驗、且知道如何搶救出問題的系統時，才應該這麼做。

在任何新的重大發行前，我們會用 RC 通道做最終驗証。如果你有興趣幫忙做最後的打磨，來 Discord 的 #omarchy-release-candidates 坐坐。

最後，還有 dev 通道，它把 Omarchy 直接連到 ~/omarchy 中原始碼的 git checkout，並搭配 edge 套件。只有當你是經驗豐富的 Linux 使用者、直接在 Omarchy 上工作、並願意容忍損壞時，才應該使用這個通道。

你可以用 Omarchy 選單的 Update > Channel（或終端機的 omarchy-channel-set）在通道之間切換。

韌體更新

你的套件不是唯一會過期的東西。許多筆記型電腦與周邊透過 Linux Vendor Firmware Service 提供 BIOS、SSD 與擴充座韌體，而 Omarchy 選單的 Update > Firmware 會抓取並安裝你的硬體在等的任何東西。它第一次執行時會安裝 fwupd。很多韌體只能在重新開機期間寫入，所以被要求重新開機時不必驚訝。

關於直接使用 pacman/yay 更新的警告

如果你已經熟悉 Arch，你可能會忍不住直接自己跑 pacman -Syu 或 yay -Syu，但如果你那麼做，你會錯過 Omarchy 與新套件一起執行的快照、遷移與設定更新。這就是為何 Omarchy 實際上會阻止直接的系統升級，並改為引導你去用 omarchy update。（如果你真的知道自己在做什麼，這個防護會告訴你如何在單一交易中繞過它。）

回滾壞掉的更新

如果你在做完更新後遇到問題，可以把系統回滾到更新前所建立的快照。只要重新開機，並在開機選單中選取你開始更新之前的那個快照。

如果你的設定檔不知何故損壞了，你也可以在終端機執行 omarchy reinstall 來做 Omarchy 重灌。這會重灌所有預設 Omarchy 套件、把你切回 stable 並降級任何太新的套件，並重設所有設定檔。注意，這麼做會覆寫你對 Omarchy 預設值所做的所有使用者設定變更！

Dotfiles

原文：Dotfiles

Omarchy 主要透過位於 ~/.config 的所謂 dotfiles 來配置。那些被視為你的檔案，供你修改。位於 /usr/share/omarchy 的檔案屬於 Omarchy 本身，你不應該去動它們。如果你需要改變 /usr/share/omarchy 裡的任何東西，你應該改為在 ~/.config 中覆寫該值。

關鍵設定可以直接從 Omarchy 選單（Super + Space）編輯，例如 Setup > Monitors、Setup > Keybindings、Setup > Input 與 Setup > Config > [file]。當你用這種方式編輯時，設定編輯後需要重新啟動的任何行程，都會在你退出編輯器後自動重啟（預設是 Neovim——記得 :wq！——但你可以透過 Setup > Defaults > Editor 改掉）。

以下是 ~/.config 中關鍵檔案的清單及其控制內容：

如果你為了調整自己的設定而做了大量變更，備份這些 dotfiles 是個好主意。Stow 是個好方法。

隨工作階段啟動你自己的應用程式

如果你希望某樣東西每次登入都執行——同步 daemon、聊天應用程式、你自己的指令碼——把它放進 ~/.config/hypr/autostart.lua：

o.launch_on_start("my-service")

它會把該指令作為工作階段的一部分啟動，所以當你登出時它也會被正確清理。

在系統事件上執行指令碼

Omarchy 在幾個時刻會觸發 hooks，你可以把自己的指令碼掛上去。它們位於 ~/.config/omarchy/hooks/<event>.d/，每個事件一個目錄，裡面的每個可執行檔都會在該事件發生時執行：

這些目錄裡已經各有一個 .sample 檔示範 hook 的長相——把檔名中的 .sample 去掉就能讓它上工。要安裝你在別處寫好的指令碼，用 omarchy hook install post-boot ~/my-hook，它會把指令碼複製進去並讓它可執行。

加入你自己的選單專案

Omarchy 選單（Super + Space）可以透過編輯 ~/.config/omarchy/extensions/omarchy-menu.jsonc 用你自己的列來擴充。專案以帶點的 id 為鍵，而 id 就是決定它們在樹中位置的東西，所以 personal 會出現在根選單，而 personal.notes 會出現在它裡面：

"personal": {"icon":"","label":"Personal"},
"personal.notes": {"icon":"󰎞","label":"Notes","action":"omarchy-launch-editor ~/notes"},

重複使用既有的 id 就會覆寫該列，而不是新增一列。該檔出廠時已以註解記錄了所有可用欄位。

加入你自己的 shell 匯出、函式與別名

Omarchy 附帶一堆符合人體工學的別名與有用的函式，但想要加入自己的東西非常常見。你應該在 ~/.bashrc 中同時加入別名、函式與匯出。這個檔案在更新時不會被覆寫。如果你想改變任何 Omarchy 預設值，也可以安全地在這裡加入。

修改 Omarchy 內部檔案

看，這是你的電腦。你可以對它做任何你想做的事，但我會建議不要直接修改 /usr/share/omarchy 裡的檔案。它們屬於 Omarchy pacman 套件，所以你的變更在下次更新時就會直接被覆寫。你最好只是在 ~/.config/* 資料夾裡覆寫任何你不喜歡的預設值。

你幾乎可以用那種方式改變一切，例如預設快速鍵。只要編輯 ~/.config/hypr/bindings.lua，比如把 Obsidian 換成 Joplin（用 omarchy-pkg-add joplin-bin 安裝）：

hl.unbind("SUPER + SHIFT + O")
o.bind("SUPER + SHIFT + O", "Joplin", "joplin-desktop")

如果你堅持要對 Omarchy 內部檔案動手術，透過 Update > Channel > Dev 切到 dev 通道。那會把 Omarchy 連到 ~/omarchy 中原始碼的 git checkout，你可以盡情修改。這裡沒人會告訴你不能怎麼做！

重設任何變更

如果你最終把設定弄得一團糟，你總是可以透過 Omarchy 選單的 Update > Config 把它們還原成預設值。或執行 omarchy reinstall configs 重設一切。

Shell 外掛

原文：Shell Plugins

Omarchy 桌面以一個叫做 omarchy-shell 的單一長壽命 Quickshell 行程執行，而你在螢幕上看到的幾乎一切都是它裡面的一個外掛。狀態列是一個外掛。從它掉下來的面板、像表情符號選擇器與剪貼簿管理器那樣的全螢幕疊層、Omarchy 選單本身、鎖定畫面、polkit 對話方塊，以及監看電池、在晚上暖化螢幕的無頭服務，都是外掛。

這不只是實作細節。它意味著你可以把桌面的某些部分關掉、換掉，或寫你自己的，而不必碰到 Omarchy 原始碼的任何一行。

第一方外掛隨 Omarchy 出廠，位於 $OMARCHY_PATH/shell/plugins/。你自己加入的任何東西——你自己的實驗，或你在 GitHub 上找到的東西——則位於 ~/.config/omarchy/plugins/。兩者在啟動時都以相同方式被發現；唯一的差別是它們在磁碟上的位置。

看看你有什麼

omarchy plugin list

那會印出每個被發現的外掛及其 id、是否啟用、是第一方還是第三方、它的種類與顯示名稱。如果你要餵給其他東西，加上 --json。

外掛 id 是有名稱空間的。內建的全部以 omarchy. 開頭——omarchy.clock、omarchy.network、omarchy.notifications——而且該名稱空間是保留的，所以第三方外掛永遠不能宣稱它。

把它們開關起來

omarchy plugin enable omarchy.tailscale
omarchy plugin disable omarchy.weather

或使用選單：Setup > Plugins 有 Enable、Disable、Add、Clone 與 Remove，每一個都有一個只提供對該動作合理的外掛的選擇器。

啟用狀態儲存在 ~/.config/omarchy/shell.json，而規則對兩種外掛略有不同。第三方外掛的啟用條件正是它的 id 出現在該檔的某處——作為狀態列版面專案、作為 plugins[] 的專案，或作為 bar.id。非狀態列小工具的第一方外掛則相反：它們預設開啟，只有在被列進 disabledPlugins[] 時才會關掉。

完整的狀態列外掛完全沒有關閉狀態。永遠只會有一個狀態列，所以你要把它換掉就是啟用另一個。狀態列小工具的放置見頂部狀態列。

從 git 加入外掛

第三方外掛就是一個根目錄帶有 manifest.json 的 git 儲存庫。

omarchy plugin add https://github.com/acme/omarchy-weather.git --enable

在它做任何事之前，它會明白地告訴你：外掛在你長壽命的 shell 行程裡以任意、無沙箱的程式碼執行，並顯示 URL 並要求你確認。請認真對待這件事。外掛不是設定檔——它是隻要你工作階段還活著就會執行的程式碼，而且擁有你的使用者帳號能觸及的一切。只加入你願意執行的儲存庫，並在啟用前先讀過它們。

接著它把儲存庫複製到暫存目錄、驗証 manifest、如果另一個外掛已宣稱該 id 就拒絕安裝，然後把它移到 ~/.config/omarchy/plugins/<id>/。沒有 --enable 時它會問你是否現在就要開啟，你可以說不並先去讀程式碼。它從不執行外掛的任何東西、從不執行安裝 hook、從不要求 sudo——它複製檔案、檢查 manifest，並透過 IPC 翻一個位元。

更新就是對同一份 checkout 做 fast-forward pull：

omarchy plugin update acme.weather
omarchy plugin update

不加 id 則更新你所有由 git 管理的外掛。它會在套用前顯示 diff，如果你有它無法 fast-forward 過去的本機變更就拒絕更新，並在新修訂版未能通過驗証時回滾。

omarchy plugin remove acme.weather

移除會先停用外掛，然後如果是 git checkout 就刪除它（儲存庫仍在上游），或者如果是符號連結就取消連結。沒有 git 儲存庫的手工外掛資料夾則會被移到外掛目錄內一個帶時間戳的備份，而不是直接刪除。

複製內建元來修改它

這是我最喜歡的部分。如果你想改變一個內建小工具的行為，不要去編輯 $OMARCHY_PATH 下的檔案——那些屬於套件，下次更新會覆寫它們。改為複製它：

omarchy plugin clone omarchy.clock

那會把整個外掛複製到 ~/.config/omarchy/plugins/dhh.clock（用你的使用者名稱，不是我的）、把它重新命名為 "My Clock"、啟用它，並把 shell 從內建切換到你的副本——同時保留既有狀態列小工具的位置與設定。加上 --edit 會立刻在你的 $EDITOR 中開啟新目錄，選單的 Setup > Plugins > Clone Plugin 就是幫你做這件事。

使用者名稱字首讓你的副本 id 屬於你，所以分享它不會與其他人的碰撞。對原始內建 id 的呼叫會被路由到你的副本，所以任何引用 omarchy.clock 的東西都不需要更新。而如果你弄壞了，omarchy plugin remove dhh.clock 會把內建放回去。

在 ~/.config/omarchy/plugins/ 底下任何地方儲存檔案都會自動重新載入外掛程式碼，所以你可以把編輯器開著，看著你的變更落地。

寫你自己的

一個外掛就是一個帶 manifest.json 與一些 QML 的目錄。manifest 宣告 schemaVersion: 1、一個 id、name、version、一個或多個 kinds，以及一個 entryPoints 物件，指向每種 kind 的 QML 檔：

一個外掛可以同時宣告多種 kind——媒體外掛同時是 service 與 bar-widget。狀態列小工具會得到額外的 barWidget 區塊，含顯示名稱、分類、可選的 defaultSection，以及 allowMultiple（表示在狀態列上放多個是否合理）。大多數小工具把它設為 false；間隔器與指示器則設為 true。

在發布任何東西之前，檢查它：

omarchy plugin validate ./my-plugin

那會執行與 shell 在載入時相同的檢查：schema 版本、必要欄位、不是保留字的 id、安全並確實存在的相對路徑入口點、你宣稱的每種 kind 都有入口點，以及資料夾內任何地方都沒有符號連結。

要看全貌，原始碼就是檔案：Omarchy 儲存庫中的 shell/README.md 涵蓋 manifest schema、shell 的 IPC 契約與 shell.json 的確切形狀，而 shell/plugins/README.md 列出每個第一方外掛及其 id、kinds 與入口點。

把你的分享給世界

一旦你做出了自己喜歡的東西，把它放進公開的 git 儲存庫。這就是全部的散佈機制——任何人都可以對著你的 URL 執行 omarchy plugin add，幾秒內就讓它跑起來。

為了幫人們真的找到它，把它列在 omarchyplugins.com。那是 Omarchy shell 外掛的社群目錄，也是當你想知道是否已經有人做出你即將要寫的那個小工具時，第一個該看的地方。開始寫之前先去逛逛！

螢幕

原文：Monitors

Omarchy 預設假設你跑在 2x-capable 的 retina 級螢幕上。這是你要得到那些漂亮、銳利的程式字型所需要的。它是幾乎所有新的高解析度螢幕高階筆記型電腦所最佳化的。它是你會想在 27 吋 5K Apple Studio Display／ProArt PA27JCV／Samsung S9／Kuycon G27P 或 32 吋 6K Apple XDR／ProArt PA32QCV／Kuycon G32P 上跑的。

但如果你的螢幕 PPI 不是 218 或以上，你會想改變螢幕設定。例如，如果你有一臺 27 吋或 32 吋 4K，你可以用分數縮放：開啟 ~/.config/hypr/monitors.lua（透過 Omarchy 選單的 Setup > Monitors），切換到那種組合的推薦值：

local omarchy_gdk_scale = 2
local omarchy_monitor_scale = 1.6

如果你用的是 1080p 或 1440p 螢幕，你大概會想用 1x 縮放，所以可以用：

local omarchy_gdk_scale = 1
local omarchy_monitor_scale = 1

對 GDK_SCALE 的變更適用於變更之後才啟動的應用程式（而且 GTK 只接受整數，所以把它保持在你的螢幕縮放最接近的整數）。所以記得退出那些在變更後變得過大的視窗（或用 Ctrl + Alt + Del 關掉所有視窗！）。

你也可以用 Super + / 提高、Super + Alt + / 降低，快速在幾個主要螢幕縮放比例（1x、1.25x、1.6x、2x、3x、4x）間逐步切換。如果你用預設設定，這些變更也會在重新開機後保留。

把文字變大或變小

螢幕縮放會改變一切的大小。如果你只是想要更大或更小的文字，有一個專用的旋鈕：

omarchy display text size 14

它接受 9 到 20 之間的畫素大小，並同步移動 Omarchy shell、GTK 應用程式與你的終端機，讓整個桌面保持比例一致。不加引數執行可看到你目前在哪個值，而 omarchy display text size reset 則回到預設。Foot 是唯一的落除者：它沒辦法重新載入自己的設定，所以執行中的終端機會保留舊大小，直到你開一個新的。

延伸與映象筆記型電腦螢幕

當你把外部螢幕接到筆記型電腦時，螢幕會自動延伸。但你可以用 Omarchy 選單的 Trigger > Hardware 或 Super + Ctrl + Alt + Delete 把它改成映象。如果那個外部螢幕是投影機，而你想一邊工作一邊秀東西，這特別有幫助。

當你在延伸時，蓋上筆記型電腦的蓋子會自動關掉內建螢幕。開啟蓋子則把它開回來。你也可以用 Omarchy 選單的 Trigger > Hardware 或 Super + Ctrl + Delete 手動控制。

安排多個螢幕

Hyprland 與多螢幕搭配得很好。如何擺放它們的更多資訊請讀 Hyprland 螢幕檔案。你也可以把特定工作區繫結到特定螢幕。在 Omarchy 中，這些規則以 hl.monitor 專案的形式放在 ~/.config/hypr/monitors.lua——該檔出廠時帶有註解範例，示範把特定螢幕釘到某個解析度、位置與旋轉角度。

如果你想要一個 TUI 來幫你安排多螢幕的位置，也可以看看 Hyprmon。

控制亮度

螢幕亮度由專用的亮度提高／降低功能鍵控制。如果你按這些鍵時按住 shift，就會去到最大或最小亮度。這些鍵控制你目前聚焦的螢幕，所以支援 DDC/CI 的外部螢幕會以與筆記型電腦螢幕相同的方式被調整。

Apple 螢幕

如果你用的是 Apple 螢幕，當你聚焦在 Apple 螢幕上時，一般的鍵盤亮度鍵也會自動生效。這是透過 asdcontrol 指令完成的。

注意如果你用的是 Apple 6K XDR 螢幕，你可能會在 hyprctl monitors 列出中看到一個幻靈螢幕。你可以透過 Setup > Monitors 用類似 hl.monitor({ output = "DP-2", disabled = true }) 的方式關掉它。

在 Intel 機器上，你應該用一般的 Thunderbolt 線連線 Apple 螢幕。在沒有 Thunderbolt 的其他機器上，你通常得用 DP + USB-A -> USB-C 線才能讓它運作。

鍵盤、滑鼠與觸控板

原文：Keyboard, Mouse, Trackpad

Hyprland 讓你非常詳細地配置所有輸入。你可以把鍵盤重複速率調成超音速般快，或讓觸控板使用自然捲動。你都在 ~/.config/hypr/input.lua 裡改，也可以透過 Omarchy 選單（Super + Space）的 Setup > Input 到達。你在那裡設定的任何東西都會取代 Omarchy 的預設值。

以下是個例子：

hl.config({
  input = {
    -- 使用多種鍵盤配置，並用 Left Alt + Right Alt 在它們之間切換
    kb_layout = "us,dk",
    kb_options = "compose:caps,shift:both_capslock_cancel,grp:alts_toggle",

    -- 改變鍵盤重複的速度
    repeat_rate = 40,
    repeat_delay = 600,

    -- 提高滑鼠／觸控板靈敏度（預設：0）
    sensitivity = 0.35,

    touchpad = {
      -- 使用自然（反向）捲動
      natural_scroll = true,

      -- 用兩指點選作右鍵，而不是右下角
      clickfinger_behavior = true,

      -- 控制捲動速度
      scroll_factor = 0.3,
    },
  },
})

-- 在終端機中捲動快一點
o.window("(Alacritty|kitty|foot)", { scroll_touchpad = 1.5 })

你可以在 Hyprland wiki 上看到所有輸入選項。

預設上，Omarchy 用 CapsLock 作為 compose 鍵，用於快速表情符號與其他補完。如果你寧願把 CapsLock 當作 Caps Lock，把 compose 鍵移到別處，就是改變 kb_options 中的 compose:caps。例如，下面把 compose 鍵移到 Right Alt：

hl.config({
  input = {
    kb_options = "compose:ralt",
  },
})

觸控板手勢

你也可以開啟觸控板手勢，例如用三指滑動切換工作區：

hl.gesture({ fingers = 3, direction = "horizontal", action = "workspace" })

在配備觸覺觸控板的 Dell XPS 筆記型電腦上，你也可以在 Trigger > Hardware > Touchpad Haptics 下把點選強度設為低、中或高。

輸入中文、日文與其他語言

Omarchy 將 fcitx5 輸入法框架作為每個 session 的一部分執行——正是它驅動了 CapsLock compose 序列。這意味著非拉丁語系輸入的管路已經就緒：用 omarchy pkg add 安裝輸入引擎，例如 fcitx5-mozc（日文）或 fcitx5-chinese-addons（中文），再加上 fcitx5-configtool 把引擎加進你的輸入法並設定切換它們的按鍵。

把 ALT 當作 SUPER 使用

在某些鍵盤上，把主 meta 鍵（Windows/cmd 鍵）當作 SUPER 並不方便。你可以改用 ALT，使用這個變更：

hl.config({
  input = {
    kb_options = "compose:caps,shift:both_capslock_cancel,altwin:swap_alt_win",
  },
})

網路

原文：Networking

Omarchy 中的網路由 NetworkManager 處理，你從頂部狀態列的網路圖示或 Super + Ctrl + W 來操作它。

那個面板會掃描 Wi-Fi 網路、顯示訊號強度並連線。有線網路完全不需要任何東西——插上就能用。如果你寧願待在終端機，nmtui 給你同樣的控制，而且也有 omarchy network 指令群組。

分享你的 Wi-Fi

與其大聲唸出一長串密碼，在連上 Wi-Fi 時執行 Setup > Network > QR Code。那會在螢幕上放一個 QR 碼，任何手機相機都能掃描加入。這是那種一旦你知道它在那裡，就會用得比你想像更多的東西。

如果你真的需要密碼本身，omarchy network password <interface> 會印出它。

DNS

Omarchy 使用你網路透過 DHCP 發出的任何 DNS。你可以在 Setup > Network > DNS 下為整臺機器覆寫它，在那裡 Cloudflare 與 Google 都只要一鍵。選 Custom 則可輸入你自己的伺服器。

從終端機，omarchy dns 印出目前的供應商，omarchy dns Cloudflare 則設定一個。

固定 Wi-Fi 頻段

如果你的路由器把 2.4GHz、5GHz 與 6GHz 放在同一個網路名稱下，你的筆電有時會攀著慢的那個。omarchy network band 顯示你在哪個頻段，omarchy network band 5 則固定它。用 auto 則讓它重新選擇。

這固定的是頻段而非特定的存取點，所以你仍能正常在 AP 之間漫遊。

它有多快？

Trigger > Speed Test > Network Speed Test 用一對儀錶測量你實際的上傳與下載速度。從終端機則是 omarchy network speedtest down 或 up。（如果你在測另一個瓶頸，那個選單裡也有一個磁碟速度測試就在旁邊。）

防火牆

防火牆預設開啟並阻擋所有連入流量，只有一個例外：連線埠 53317，讓 LocalSend 開箱即用。

SSH 在你用 Setup > Security > SSHD 開啟之前是關的，那會啟動 daemon、開啟經過限速以防暴力破解的 22 連線埠，並授權一組金鑰。Docker 也被鎖上，所以容器不會意外把自己暴露給全世界。完整故事見安全性。

Tailscale

Tailscale 是一個 mesh VPN，讓透過網際網路觸及你所有電腦與伺服器變得簡單又安全。用 Install > Service > Tailscale 安裝它。

那會給你在狀態列上一個 Tailscale 面板，可連線／中斷 tailnet、切換帳號並選擇 exit node——你自己的機器與 Mullvad 區域都會出現在清單裡。它也能瀏覽你的機器，而 Taildrop 就住在那裡：選一臺機器按 s 傳檔給它，或按 c、n、d 複製它的 IP、名稱或完整 DNS 名稱。終端機的對等用法是 omarchy tailscale send <machine> [file...]，而傳給你的檔案會自動落在 ~/Downloads。宣告檔案到達的通知會等你點開或關閉它才消失，所以當你不在機器前時出現的檔案，等你回來仍然在那裡等你回應。

安裝它也會增加一個給 Tailscale 管理主控臺用的網頁應用程式。

當它停止運作

在重新開機之前，先試著單獨重新啟動出問題的那一塊。Update > Hardware 有 Wi-Fi、藍牙、音訊與觸控板，重新載入其中一個就能解決大多數「五分鐘前還好好的」情況。參見疑難排解。

系統休眠

原文：System sleep

Omarchy 預設啟用 suspend 與 hibernation，但如果你在自己的機器上對任一個有問題，可以把它們關掉。

電源設定檔

在筆記型電腦上，Omarchy 分別記住你接電與用電池時的電源設定檔，並在你插拔時在兩者之間切換。開箱即用的意思是接電時 performance、用電池時 balanced。

你可以用 omarchy powerprofiles list 看看你的機器提供什麼，並用 omarchy powerprofiles set autodetect power-saver 為你目前所處的狀態設定你想要的那個。要在不拔掉任何東西的情況下設定另一個狀態，就直接命名它：omarchy powerprofiles set battery power-saver。你選了什麼，下次你處於那個狀態時就會拿回那個。

切換 suspend

你從終端機執行 omarchy toggle suspend 來切換 suspend。那只是顯示／隱藏 System（或 Super + Esc）下的選項，然後你可以看看它在你的系統上是否穩定運作。如果不行，你可以用同一個指令再次隱藏它。

切換 hibernation

你從終端機執行 omarchy hibernation setup 來設定 hibernation。Hibernation 會在你的開機碟上建立一個大小等於你實體 RAM 分配的 /swap 子卷，所以請確保你有充足的剩餘空間。在 32GB 的機器上，你永遠需要 32GB 以上給這個卷。Hibernation 也需要預設的 Limine 開機載入程式。

設定好之後，你會在 System（或 Super + Esc）下看到 hibernate 選項，然後你可以看看它在你的系統上是否穩定運作。如果不行，你可以執行 omarchy hibernation remove 再次移除它。

硬體驗證

原文：Hardware authentication

指紋驗証

很多筆記型電腦都帶有指紋感應器來做驗証。你可以在 Omarchy 選單（Super + Space）執行 Setup > Security > Fingerprint 來使用它。

那會安裝指紋套件、收集你的指紋、驗証它，然後你就能用指紋從鎖定畫面解鎖（用 Super + Ctrl + L 觸發）、進入 sudo 模式，並授權系統提示。

當你的筆記型電腦蓋子闔上時，指紋提示會自動跳過，所以你直接去密碼提示，而不是在等一個你搆不到的感應器。如果你另有需要、要用一個沒有感應器的外接鍵盤，在 sudo 期間被要求指紋時，只要按 CTRL + C。

你可以在 Omarchy 選單的 Remove > Security > Fingerprint 下移除指紋驗証。

Fido2 驗証

如果你使用 Fido2 裝置，可以在 Omarchy 選單（Super + Space）用 Setup > Security > Fido2 設定它來做 sudo 驗証。不過它涵蓋的是 sudo 與系統授權提示，而不是解鎖你的電腦。

你可以在 Omarchy 選單的 Remove > Security > Fido2 下移除 fido2 驗証。

字型

原文：Fonts

Omarchy 預設使用 JetBrainsMono Nerd Font 作為終端機與系統字型。

你可以透過 Omarchy 選單（Super + Space）的 Style > Font 選單改變它。那會設定所有地方的等寬字型：終端機、狀態列，以及任何其他要求它的東西。

你可以透過 Omarchy 選單的 Install > Style > Font 安裝其他熱門的程式字型：Cascadia Mono、Meslo LG Mono、Fira Code、Victor Code、Bitstream Vera Mono 與 Iosevka 都只要一鍵，也都是 Nerd Font 版本，所以狀態列與終端機裡的符號圖示仍能運作。安裝完其中一款後，在 Style > Font 下選擇它。

桌布

原文：Backgrounds

每套主題都附帶自己的一組桌布，而你可以把額外的加到 ~/.config/omarchy/backgrounds/[theme]。如果你想給比如 nord 主題加一張額外桌布，只要把檔案放進 ~/.config/omarchy/backgrounds/nord 就好。

最簡單的做法是去 Omarchy 選單的 Install > Style > Background。那會帶出該主題桌布儲存的資料夾。按 Super + Shift + F 啟動另一個檔案管理員，找到你的桌布，把它複製過去。現在它就會被納入你可以用 Super + Ctrl + Space 選擇的桌布選項中。

你可以在 https://github.com/dharmx/walls 找到大量精心策劃的帥氣桌布收藏。

提示字元

原文：Prompt

Omarchy 預設附帶一個極簡的 Starship 提示字元。那是我喜歡保持提示字元的方式。我不需要知道使用者，因為那總是我；也不需要知道時間，因為它總是在上方。

如果你想要更多資訊或風格，你可以在 ~/.config/starship.toml 中改變 Starship.rs 設定。你可以做的很多。只要別玩過頭（或者就玩過頭吧，隨你高興，這是你的電腦！）

品牌識別

原文：Branding

Omarchy 讓你可以為開機解鎖、螢幕保護與 about 畫面設定公司標誌或個人影像。

開機解鎖

你可以用 omarchy plymouth preview 看看你自訂的標誌與顏色會長什麼樣。它接受一個背景色、一個文字色、一個標誌 png，以及預覽圖片的路徑：

omarchy plymouth preview '#1d2021' '#ebdbb2' logo.png preview.png

然後用 omarchy plymouth set '#1d2021' '#ebdbb2' logo.png 套用設定，它也會給 SDDM 登入畫面同樣的顏色與標誌。如果你想還原，可以用 omarchy plymouth reset。

螢幕保護

你可以在 Style > Screensaver 下改變螢幕保護使用的標誌。它是 ASCII 標誌，所以你可以直接編輯文字，但你也可以交給它一張 png 或 svg 圖片，我們會把它轉成 ASCII。看起來挺帥的。

那個選單裡有三個專案：

• Edit Text 在你的編輯器中開啟 ~/.config/omarchy/branding/screensaver.txt。任意打字或貼上——ASCII 藝術、你的名字、粗話。儲存退出，螢幕保護會立刻啟動讓你看見。
• Set From Image 開啟一個 png 或 svg 的檔案選擇器，把它轉成 ASCII，並顯示結果。輪廓清楚的標誌比照片效果好得多。
• Restore Default 把 Omarchy 標誌放回去。

About 畫面

同樣的三個選項也在 Style > About 底下，對你從 Omarchy 選單取得的 About 畫面，運作方式完全相同——檔案是 ~/.config/omarchy/branding/about.txt，而 About 視窗會在每次變更後彈出。About 圖案會轉成比螢幕保護小的尺寸，因為它得塞進視窗而不是填滿你的螢幕。

視窗開啟期間，一道綠色的閃光每隔幾秒斜掠過圖案，然後又讓它回覆靜止。你自己的圖案也會有，只要它每個字元都是一列寬——Set From Image 產生的任何東西都是。用表情符號或全形字元製作的圖案則保持不動，如果你保有自己的 fastfetch 設定，畫面也保持不動：那些情況下靜止的標誌是動畫在讀路，而不是壞掉，因為把閃光滑過它們會讓其餘那行走位。

自己轉換圖片

兩個 Set From Image 選項都只是呼叫 omarchy transcode ascii，如果你想要控制轉換過程，可以直接執行它：

omarchy transcode ascii ~/logo.svg ~/.config/omarchy/branding/screensaver.txt --width 100

它接受以終端機列與行計的 --width 與 --height、值為 braille（預設，細緻得多）或 block 的 --mode、用於決定哪些畫素算作標誌一部分的 --threshold 百分比，以及當你的標誌是深底淺色時用的 --invert。如果轉換出來是一團模糊，那個閾值通常是要轉的旋鈕。

用文字取代標誌

omarchy ascii 用 Delta Corps Priest 1 字型畫出文字，那正是 Omarchy 文字標誌本身所用的 FIGlet 字型，所以螢幕保護可以說點什麼而不是秀一張圖：

omarchy ascii "Back in five" > ~/.config/omarchy/branding/screensaver.txt

它以引數接受文字，不給引數時則從管道讀取。該字型只帶字母與空格——它當初就沒有繪製數字與標點——所以其他任何東西都會被丟掉並在 stderr 上指名，而不是靜靜吞掉。

常見調校

原文：Common tweaks

這是一系列對 Omarchy 設定的常見客製整理。要知道，系統更新偶爾可能需要把某些設定還原成原樣。如果發生這種情況，你的變更不會遺失，而是被放進同一目錄下的一個 .bak 檔中。

如果你搞砸了某些東西，可以透過 Omarchy 選單的 Update > Config 把個別設定還原成原始設定。如果你真的把一切都搞砸了，可以用 omarchy-reinstall 重設所有設定。

永遠顯示所有系統匣圖示

預設上，系統匣圖示（如 Dropbox、1password 或 Steam）藏在系統匣展開箭頭的後面，你把遊標移上去它們才會出現。如果你希望它們一直露出來，右鍵點展開箭頭開啟系統匣圖示管理器，然後把你想保持可見的圖示釘住（你也可以隱藏你永遠不想看的）。

圓角視窗

Omarchy 的預設設計是直角，但如果你想讓它柔和一點，可以改變 ~/.config/hypr/looknfeel.lua，讓圓角不再被註解掉：

hl.config({
  decoration = {
    -- 使用圓角視窗。
    rounding = 8,
  },
})

移除視窗間隙

在筆記型電腦螢幕上，有些人偏好不浪費任何畫素在視窗間隙上（甚至連頂部狀態列都不要，你可以用 Super + Shift + Space 把它關掉）。你可以用 Super + Shift + Backspace 切換所有間隙與邊框開關，或用 ~/.config/hypr/looknfeel.lua 中這一段去掉註解來永久移除它們：

hl.config({
  general = {
    -- 視窗或邊框之間沒有間隙。
    gaps_in = 0,
    gaps_out = 0,
    border_size = 0,
  },
})

製作自己的主題

原文：Making your own theme

你可以把自己的主題加到 ~/.config/omarchy/themes。只要複製一個現有的主題作為基礎（看看 /usr/share/omarchy/themes），然後盡情調整。只要你的主題在那個資料夾裡，它就會被納入主題選擇選單。

你必須調整的主要檔案是 colors.toml。它定義了接著用來產生以下設定的顏色集：終端機（Foot/Alacritty/Ghostty/Kitty）、btop、Chromium、Hyprland、Neovim、Helix、VSCode、Obsidian，以及整個 Omarchy shell（頂部狀態列、選單、通知、OSD 與鎖定畫面）。

你也可以使用內附的 Aether 應用程式，用一個可愛的 GUI 介面玩顏色、搜尋桌布來建立新主題。用 Super + Alt + Space 從應用程式選單啟動它即可。

安裝的主題可以包含什麼

你自己寫在 ~/.config/omarchy/themes 的主題可以包含任何你想要的東西——這是你的機器、你的檔案，Omarchy 會完整套用。

你用 omarchy theme install 從別人儲存庫安裝的主題，則會保留一切與顏色有關的東西，而丟掉那幾個會在你機器上執行程式碼的檔案：任何 .lua 檔、終端機設定（alacritty.toml、foot.ini、ghostty.conf、kitty.conf）與 vscode.json。主題的 hyprland.lua 是你的合成器在登入時執行的 Lua，終端機設定指定你終端機啟動的程式，而 vscode.json 指定要安裝的 VSCode 擴充功能。安裝別人的主題應該改變你桌面的外觀，而不是它執行的東西。

其他一切仍完全照主題作者寫的運作——btop.theme、chromium.theme、helix.toml、icons.theme、shell.toml、桌布與預覽都會保留。只有被丟掉的那些會在你的機器上從 colors.toml 重生成。

Omarchy 以主題內部是否有自己的 git 儲存庫來區分兩者，那正是 omarchy theme install 複製時留下的東西。所以你自己寫的主題仍然屬於你，而你從網路上抓來的則保持純顏色。

淺色模式

如果你在做淺色模式主題，在你的 colors.toml 頂部設定 mode = "light"。接著它就會自動與所有應用程式的淺色模式搭配。（舊的作法——在你主題根目錄放一個叫 light.mode 的空檔——也仍然有效。）

圖示顏色

如果你想讓檔案管理員圖示與你的主題配色一致，加入一個叫 icons.theme 的檔，內容是你想用的圖示集名稱。預設選項有：Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow。

解鎖圖片

帶有 unlock.png 與 preview-unlock.png 圖片的主題會被列在 Style > Unlock 下。你的 unlock.png 最好是透明的 png。而你可以用 omarchy plymouth preview 建立預覽圖片。

為 Omarchy 未涵蓋的應用程式上主題

如果你用的應用程式不在那份清單裡，你可以用範本自己教 Omarchy 為它上主題。在 ~/.config/omarchy/themed/ 放一個檔，命名為它產生的設定加上 .tpl 副檔名，並用 {{ background }}、{{ foreground }}、{{ accent }}、{{ red }}、{{ color0 }} 到 {{ color15 }} 以及其餘調色盤作為佔位符來寫該設定。每當你切換主題，該檔就會用該主題的顏色重新產生。

那個資料夾裡有一份註解完整的 alacritty.toml.tpl.sample 可以照抄——它列出你能用的每個變數，還有給想要沒有 # 或要十進位 RGB 顏色的應用程式用的 _strip 與 _rgb 修飾子。你的範本優先於 Omarchy 自己的，所以你也可以用這個來覆寫內建應用程式的上主題方式。

散佈你的主題

如果你想散佈你的主題讓別人使用，你需要把它放到公開的 git 伺服器上，例如 GitHub。接著人們就能用 Omarchy 選單的 Install > Style > Theme，使用那個 URL 安裝它。建議你遵循 omarchy-[themename]-theme 的命名慣例，因為安裝後主題在主題選擇選單中會正確地只顯示為 [themename]。

那個剩下的 [themename] 會成為主題的目錄名稱，所以它必須是 Omarchy 能安全傳遞的名稱：它必須以字母、數字或底線開頭，其餘部分可以包含字母、數字、.、_、+ 與 -。大寫會幫你轉成小寫，但其他任何東西——空格、引號、非英文字元——都會在安裝時被拒絕，而不是被變成目錄名稱。所以 omarchy-tokyo-night-theme、omarchy-flexoki_light-theme 與 omarchy-c++-theme 都能正常安裝。

記住，一旦從儲存庫安裝，它附帶的任何 .lua、終端機設定或 vscode.json 都會被丟掉，所以不要圍繞那些東西來建構主題。

你可以透過向 omarchy-site 儲存庫送 pull request，把你的主題加到額外主題頁面。

Mac 支援

原文：Mac support

Omarchy 對 Intel Mac 有內建支援。目前有幾個已知限制，但只要你知道並接受它們，你就可以用 Omarchy 給你的舊 Mac 注入新生命。

請注意，目前在 M 系列 Mac 上安裝並不直接支援。你可以在我們的 Discord 中的 #omarchy-on-other 瞭解更多這方面的現狀。

在一個簡單測試中，我們光靠安裝 Omarchy 就在一臺 2019 年的 MacBook Pro 上取得了 36% 的效能提升。

在 Mac 上安裝 Omarchy

Omarchy 目前只支援作為唯一安裝的作業系統。安裝期間磁碟會被清空，macOS 將不再能開機。

如果你有意，之後仍然可以透過 Internet Recovery 還原它。

為了這部分，我們假設你已經看過開始使用，並且已經備好你的 USB 隨身碟。如果還沒，請現在先去弄。

關閉 Secure Boot

為了從可開機 USB 以及作業系統開機，必須關閉 Apple 的 Secure Boot。要關閉它，執行以下步驟：

1. 關掉你的 Mac
2. 開機並立刻按住 Command-R 直到你看見載入畫面出現
3. 選擇你的使用者，若被要求則輸入密碼
4. 進入復原畫面後，從選單列選擇 Utilities > Startup Security Utility
5. 被要求驗証時輸入你的密碼
6. 在 Secure Boot 選項中選「No Security」
7. 在 External Boot 選項中選「Allow booting from external or removable media」

開始安裝

1. 插入 USB 隨身碟
2. 重新啟動你的 Mac 並立刻按住 Option 直到你看見開機裝置畫面
3. 選擇橘色的 EFI Boot 裝置
4. 照平常的方式繼續安裝

安裝器會偵測 Mac 硬體並自動套用所需的修正：Broadcom Wi-Fi 驅動與韌體、需要它的 MacBook 型號上的 SPI 鍵盤驅動，以及同型號的 NVMe suspend 修正。

已知限制

社群成員持續在為這些挑戰尋找解決方案，所以如果這些對你造成問題，加入我們 Discord 的 #omarchy-on-other，看看有沒有任何解決這些問題的最新方法。

配備 T1 晶片的裝置

Apple T1 晶片於 2016 年底推出，僅用於第一代配備 Touch Bar 的 MacBook Pro 型號。

• MacBook Pro 13 吋（2016，兩個 Thunderbolt 3 連線埠）——型號：A1706
• MacBook Pro 13 吋（2016，四個 Thunderbolt 3 連線埠）——型號：A1708
• MacBook Pro 15 吋（2016）——型號：A1707

已知問題

• Touch Bar 無法運作
• 聲音無法運作

配備 T2 晶片的裝置

Apple T2 安全晶片於 2017 年推出。T2 晶片在 2020 年開始轉向 Apple 自家晶片（M 系列）後停產。

• iMac Pro（2017）——型號：A1862
• MacBook Pro 13 吋（2018，四個 Thunderbolt 3 連線埠）——型號：A1989
• MacBook Pro 15 吋（2018）——型號：A1990
• MacBook Air（Retina，13 吋，2018）——型號：A1932
• Mac mini（2018）——型號：A1998
• MacBook Pro 13 吋（2019，兩個 Thunderbolt 3 連線埠）——型號：A2159
• MacBook Pro 13 吋（2019，四個 Thunderbolt 3 連線埠）——型號：A2178
• MacBook Pro 15 吋（2019）——型號：A1990
• MacBook Pro 13 吋（2020，兩個 Thunderbolt 3 連線埠）——型號：A2265
• MacBook Pro 15 吋（2020）——型號：A1990

在這些型號上，安裝器會自動設定修補過的 linux-t2 核心、T2 音訊設定、Apple 的 Broadcom Wi-Fi／藍牙韌體，以及透過 t2fanrd 的風扇控制。Touch Bar 則執行在核心內建的 Boot Camp 風格支援上。

疑難排解

原文：Troubleshooting

我因為更新把系統弄壞了！

先試著把系統回滾到你最近更新前的版本。如果那樣沒用，用 omarchy-debug 把你的問題分享到 Discord 的 #omarchy-help。如果全都失敗，你可以用 omarchy-reinstall 重新安裝預設設定與套件。

為什麼某些應用程式在我的螢幕上這麼大？

Omarchy 假設是 2x 高解析度螢幕，這需要在 ~/.config/hypr/monitors.lua 中把 GDK_SCALE 設為 2。但如果你用的是 1x 螢幕，你可以把 local omarchy_gdk_scale = 2 改成 1（然後重新啟動任何過大的應用程式）。參見螢幕。

對 Spotify，你可以用 Ctrl + Minus 縮小介面（用 Ctrl + Plus 放大）。

為什麼 Caps Lock 沒有作用？

在 Omarchy 中，Caps Lock 已被指定為 xcompose 鍵。那就是快速表情符號與其他自動補完得以運作的方式。如果你真的很懷念頭 Caps Lock 的用法，可以編輯 ~/.config/hypr/input.lua 把 xcompose 鍵重新對應到別的鍵，比如設成右 Alt 鍵：

hl.config({
  input = {
    kb_options = "compose:ralt",
  },
})

我的 Wi-Fi、藍牙、音訊或觸控板突然不工作了

在重新開機之前，先試著單獨重新啟動出問題的子系統。Omarchy 選單的 Update > Hardware 有 Wi-Fi、藍牙、音訊與觸控板，重新載入其中一個就能解決大多數「五分鐘前還好好的」情況——連不上的藍牙耳機、休眠後死掉的觸控板、拔掉螢幕後消失的聲音。

為什麼我的外接喇叭沒有出聲？

大概因為它們沒有被設為主要輸出。點狀態列右側的喇叭圖示，它會開啟音量彈出視窗，你可以在那裡選輸出裝置（也能調整各應用程式的音量）。

我的筆記型電腦喇叭聽起來不太對

在某些筆記型電腦上，Omarchy 會自動套用喇叭調音，以修正內建喇叭的頻率響應。omarchy audio tuning status 告訴你機器上是否有啟用一個，而 omarchy audio tuning off 則在你寧願聽到原始喇叭聲時把它關掉。

為什麼我不能用密碼登入或 sudo？

你大概輸入錯太多次而被鎖住了。如果這發生在鎖定畫面上，你可以按 CTRL + ALT + F2 開啟一個新的 TTY，在那裡以 root 登入，然後執行 faillock --reset --user [你的使用者名稱]。那會重設鎖定，你就能繼續了。

為什麼 1Password SSH Agent / CLI 的 1Password 授權提示沒有出現？

這可能出於兩個原因：

要出現豐富的核準提示，必須開啟 Settings > Advanced > Use Hardware Acceleration。注意：這需要重新開機才能開始運作。

或者，如果你開機後還沒有啟動過 1Password，提示也不會出現。

常見問題

原文：FAQ

要如何切換鍵盤配置？

編輯你的 ~/.config/hypr/input.lua 檔，加入以下內容，用 Left Alt + Right Alt 在配置之間切換：

hl.config({
  input = {
    -- 使用多種鍵盤配置，並用 Left Alt + Right Alt 在它們之間切換
    kb_layout = "us,fr",
    kb_options = "compose:caps,shift:both_capslock_cancel,grp:alts_toggle",
  },
})

一旦你設定了多種配置，狀態列就會自動顯示你目前的鍵盤配置（你也可以點它來切換）。

要如何把時鐘格式改成 12 小時制？

右鍵點狀態列上的時鐘，就能迴圈切換常見格式，包括 12 小時制。你也可以直接設定格式：

omarchy bar set omarchy.clock format "dddd h:mm AP"

這會顯示 Sunday 10:55 AM。

要如何改變我的時區？

執行 Omarchy 選單的 Update > Timezone 並從清單中選。如果時區正確但時鐘本身走偏了，Update > Time 會幫你重新啟動時間同步。

要如何改變 DNS、分享我的 Wi-Fi，或檢查連線速度？

那些都在網路裡。

要如何檢查我的磁碟有多快？

Trigger > Speed Test > Disk Speed Test 會測量你磁碟的即時讀寫速度，或從終端機用 omarchy disk speedtest。

為什麼我不能在 Chromium 中登入我的 Google 帳號？

純開源 Chromium 建置版沒有附帶 Google 要求的 OAuth 憑証。在 Omarchy 選單執行 Install > Service > Chromium Account 把它們加進去，重新啟動瀏覽器，登入就會成功。

要如何新增印表機？

列印功能開箱就已設定好並執行中，你從應用程式啟動器（Super + Space）的 Print Settings 自己新增每一臺印表機。

選 Add，給它一點時間去找：透過 USB 插上的印表機，以及大多數網路印表機，都會幫你找到。如果你的不在清單上，選 Network Printer > Internet Printing Protocol (ipp) 並輸入它的位址——印表機自己的顯示幕或網頁會告訴你那是什麼，通常是像 192.168.1.50 加上一個 ipp/print 佇列。Forward 接著會提供驅動，現代印表機用無驅動的 IPP Everywhere 設定檔效果最好，較舊的則需要該型號自己的驅動。

右鍵點一臺印表機選 Set as Default，選你應用程式優先使用的那臺；選 Properties 則設定紙張大小、雙面與品質。

自動探索（網路上的印表機不用新增就自動出現）目前正在重新製作而暫時關閉，這就是為何上面第一步得由你來做而不是自動。列印成 PDF 檔則完全不需要任何印表機。

要如何改變截圖或螢幕錄影的儲存位置？

如果你希望截圖存到 ~/Pictures/Screenshots 而不只是 ~/Pictures，你可以把以下內容加到 ~/.config/uwsm/env.d/ 下的一個檔（例如 ~/.config/uwsm/env.d/capture）：

export OMARCHY_SCREENSHOT_DIR="$HOME/Pictures/Screenshots"

你可以用 OMARCHY_SCREENRECORD_DIR 對螢幕錄影做同樣的事。

記得建立你想存到的那個目錄並重新啟動 Omarchy，這才會生效。

要如何讓我的 Apple Studio Display 的喇叭 + 網路攝影機運作？

你可能以為插上 USB-C 就該全部能動，但不幸的是並非如此。我找到能可靠讓它運作的方法，是使用 WJESOG DisplayPort + USB-A => USB-C 線。然後喇叭與網路攝影機就會完美運作。

記得 Omarchy 為 Apple 螢幕（Studio 與 XDR 皆然）內建了亮度控制，使用一般的鍵盤亮度鍵即可。

要如何擺脫所有額外的軟體？

如果你不想要 Obsidian 或 LibreOffice 或其他任何預先安裝的東西，你可以很輕鬆地移除它。

執行 Remove > Package 看到所有已安裝的套件。接著你可以用 tab 選擇任何你想移除的套件，並用 return 開始移除所有你選的東西。

而你可以用 Omarchy 選單的 Remove > Web App 移除任何你不想要的預先安裝網頁應用程式。

或者執行 Remove > Preinstalls 一次掃掉所有預先安裝的額外東西——網頁應用程式、TUI 與可選應用程式。啟動它們的快速鍵也會隨它們消失，所以你會得到一個乾淨的繫結起點，在 ~/.config/hypr/bindings.lua 中填上你自己的。

關於錯誤與壞掉的部分，見疑難排解區。

系統快照

原文：System snapshots

我們在每次 Omarchy 更新時自動建立快照，但如果你想自己建立，可以用 omarchy-snapshot create。

要開機並還原一個快照，你從 Limine 開機載入程式選擇它。（如果你目前是直接開進 Omarchy 解密畫面，你需要先透過 BIOS 把 Limine 選為開機選項）。

從那個畫面，根據日期與版本選擇你想開進去的快照。快照當時的 Omarchy 版本可以在左下角看到。

當你進入之後，會彈出一則通知告訴你正處於可開機快照中，而如果你點它，就會開始還原流程。或者你可以使用 omarchy-snapshot restore。

這會還原你的根檔案系統，但不是你的 /home。所以它適合用來回復一個壞掉的系統更新，但不適合用來救援遺失的個人檔案。

這也意味著你的 ~/.config 目錄會原樣保留。所以如果你要回滾到較早版本的某個函式庫或應用程式，而它以新格式儲存設定檔，你就得自己手動処理。

注意：此功能僅適用於使用 Limine 開機載入程式的安裝，它自 Omarchy 2.0 起就是預設。如果你用的是 GRUB 或 systemd-boot 則不適用。

跳過開機選單

如果你從不碰開機選單，只想讓機器直接去到解密畫面，執行 Omarchy 選單的 Setup > Direct Boot。那會增加一個直接指向 Omarchy 的 EFI 專案，所以韌體會直接啟動它，不在 Limine 停下來。

取捨就是本文開頭提到的那個：開啟直接開機後，要取得快照就意味著得先從你的 BIOS 開機選單選 Limine。再次執行 Setup > Direct Boot 可移除該專案並回到透過 Limine 開機。某些韌體對自訂 EFI 專案不友善，所以這個設定在 American Megatrends 與 Apple 韌體上會拒絕執行。

安全性

原文：Security

Omarchy 極其重視安全性。這是一套希望你可以在現實世界做真正的工作的作業系統。在那裡，遺失一臺筆記型電腦不會導致安全緊急事件。所以我們這麼做：

1. 全磁碟加密是強制的：這是確保你資料實體安全最重要的一步。如果你的電腦遺失或被偷，資料會以標準的 LUKS（Linux Unified Key Setup）完整加密。
2. 防火牆預設開啟：所有連入流量預設被阻擋，只有 LocalSend 的 53317 連線埠例外。連 ssh 都是關的，直到你透過 Setup > Security > SSHD 開啟它，那會作為設定的一部分開啟 22 連線埠（限制速率以防暴力破解）。我們甚至用 ufw-docker 設定鎖定 Docker 存取，防止你的容器意外暴露給全世界。
3. Arch 永遠有最新更新：Arch——Omarchy 所建立於其上的底層發行版——是一個滾動式發行版。這意味著任何套件中被發現並修補的安全漏洞，都能迅速透過 omarchy-update 安裝。你因此永遠跑著每樣東西最新、最安全的版本。
4. Omarchy 維護自己的套件與映象：Omarchy 預設只依賴 Arch 自家 core/extra/multilib 儲存庫的套件，以及自己的 Omarchy Package Repository。你可以直接從 AUR 安裝軟體，但基礎安裝不會——只有少數可選安裝，例如第三方瀏覽器，會從 AUR 拉取。
5. Cloudflare 保護我們免受 DDoS：所有 Omarchy 散佈基礎設施——ISO、Omarchy 套件、Arch 映象——都受 Cloudflare 強大的 DDoS 護盾保護並託管於其 CDN 上。這提供極佳的可用性。

改變你的密碼

在加密安裝上你有兩個密碼：一個在開機時解鎖磁碟的，以及你登入與 sudo 用的。兩者都可以在 Omarchy 選單的 Update > Password 下改變——前者是 Drive Encryption，後者是 User。改變磁碟密碼會先要求目前的密碼，所以請準備好。

轉交一臺你已經用過的機器

如果你要把機器交給別人，你不必重新安裝它。在 Omarchy 選單執行 Setup > Reset Computer，輸入 reset 確認，然後重新開機。那會清掉每個使用者帳號與 /home 裡的一切、丟掉你在安裝後做的所有套件與系統變更，並清除機器的身分——網路連線、host key 等等。回來的會是最初開機時的設定精靈，準備好讓它的新主人輸入自己的名字、密碼與加密密碼。

它的運作方式是還原安裝器所建立的基準快照，所以它僅適用於從 Omarchy ISO 安裝的機器。而在未加密的磁碟上，重設是刪除而非安全擦除，所以如果資料很敏感，請改為重新安裝。

無密碼 sudo

有時你會希望 sudo 別再問，最常見的情況是 AI agent 正在幫你做一大段系統工作。Setup > Security > Passwordless Sudo 會把它關掉 15 分鐘，然後自動放回來。在計時器到之前再執行一次可提前結束，如果 15 分鐘不夠，可用 omarchy-sudo-passwordless 30 傳入你自己的分鐘數。

對這件事要看得清楚：當它開啟期間，任何以你的使用者身分執行的東西都能不經詢問就以 root 做任何事。那正是它的目的，也正是它的全部風險。

簽署金鑰

所有 ISO 簽章與 Omarchy 儲存庫套件的公鑰是 40DFB630FF42BCFFB047046CF0134EE680CAC571（在 openpgp.org 驗証）。omarchy/omarchy-keyring 套件也包含它，並會被用來無磎地推展任何可能的更新。

你可以在任何 ISO 發行版的 URL 後加 .sig 找到它的簽章。例如 https://iso.omarchy.org/omarchy-x.x.x.iso.sig。

安裝在特定機器上

原文：Omarchy on...

Apple M1/M2 晶片

Asahi Alarm 是建基於 Asahi Linux 之上、給 Apple M1/M2 電腦用的 Arch 版本。你可以花點功夫在其上讓 Omarchy 跑起來。參見使用者自製的指南。

Apple 虛擬機器

你也可以在 Parallels VM 裡安裝 Omarchy。過程相當繁瑣，但同樣有使用者自製的指南。

VirtualBox

VirtualBox 是熱門的 VM 執行器。你也可以在其中跑 Omarchy。但效能大概不會太好。

Windows 11 上的 VMware Workstation

另一個 Windows 上熱門的 VM 執行器。Omarchy 也已在其中設定好了。

Steam Deck

Steam Deck 跑的是 Arch，這意味著你可以把 Omarchy 跑在你的 Steam Deck 上。Altynbek Orumbayev 有完整的設定指令碼與如何做的說明。多帥啊！

NixOS

Omarchy 其實就是 Arch + Hyprland，但 Henry Sipp 已把這套設定的精髄移植到 NixOS。所以如果你已經被 nix 洗腦，這是個好的起點。它可能不一定與最新 Omarchy 變更保持同步，但無損它的帥氣！

其他東西！

如果你正試著在非預設配置上讓 Omarchy 跑起來，你應該加入我們社群 Discord 的 #omarchy-on-other 頻道。

雙系統安裝

原文：Dual Boot Install

你可以把 Omarchy 安裝到單一分割區上，與 Windows 或其他安裝共存。

這種安裝方式預設仍然帶有該分割區的 LUKS 加密，所以它實際上與整顆硬碟安裝沒什麼不同，只是需要磁碟上有可用空間而已。

在 Windows 上騰出空間

要與 Windows 共存安裝，在開始功能表輸入 disk management，選擇 Create and format hard disk partitions 選項。

找到適當的分割區，右鍵點它，選擇 Shrink Volume。

輸入你想縮減的量。注意這會是你未來 Omarchy 安裝的大小，包含開機分割區。

完成後，你應該會看到類似這樣，其中 50GB 那一塊在這個例子裡就是我們要安裝 Omarchy 的地方。

安裝 Omarchy

Omarchy 的安裝流程其實與平常相同。你選好磁碟後，會得到 Free space install 選項。選它以免清空整顆磁碟。

確認一切都看起來沒問題，然後像平常一樣等待安裝完成。這也是你可以選擇不加密安裝（不推薦）的地方，跟整顆硬碟安裝一樣。

把其他安裝加到開機載入程式

當你完成 Omarchy 安裝，你會注意到 Limine 開機載入程式現在是預設。有了它，你也可以把其他安裝（例如 Windows）的選項加進 Limine。

要做到這點，執行 limine-scan 並照指示把你想要的任何專案加進你的 limine 設定。然後當你開機時，你會看到平常的 Omarchy 選項，以及 Windows Boot Manager 或其他東西。

BitLocker

重要的是要注意，這種安裝方式與 BitLocker 不相容，因為它加密的是整顆磁碟，而不只是分割區。如果你遇到錯誤說 BitLocker 已啟用，開機進 Windows，到 Settings -> Privacy & Security -> Device encryption 把 BitLocker 關掉。解密磁碟可能要花一些時間。

無人自動安裝

原文：Unattended Installs

Omarchy ISO 可以在無人在鍵盤前的情況下自行安裝。如果安裝器找到一顆標示為 cidata、攜帶其設定檔的第二顆磁碟，它就會把設定檔複製出來、完全跳過設定精靈，並自行重新開機進入完成後的系統。不需要特別建置 ISO、不需要額外開機選單專案——沒接上這樣的磁碟時，一切不變，你得到正常的精靈。

這讓 Omarchy 非常適合作為用則丟的開發環境的基礎映像檔：在 Proxmox 或用 Packer 建立 VM、開機、走人、SSH 進去。cidata 就是 cloud-init 的 NoCloud 標籤，所以所有常見的虛擬化工具都已知道如何接上這樣的磁碟。

設定檔

這些檔正是安裝器自己的精靈所寫的，所以取得起始檔案集最簡單的方法，就是跑一次互動式安裝（比如在 VM 裡），把它寫進 /root 的東西複製出來：

用 openssl passwd -6 "yourpassword" 產生 user_credentials.json 的密碼雜湊。

你也可以放一個叫 defer-provisioning 的空檔來取代 user_credentials.json。那會執行與互動式可觸發的為另一位擁有者準備安裝相同的流程：機器安裝時不帶任何個人資訊，而第一次開機的人會選自己的鍵盤並建立自己的使用者。那是給映像製作裝置的模式，那裡磁碟根本不應該攜帶任何人的憑証。

SSH 存取

當 authorized_keys 存在時，安裝會把金鑰設為使用者的 ~/.ssh/authorized_keys、啟用 sshd，並為它開放防火牆。（原廠 Omarchy 安裝出廠時 openssh 服務是停用的、連線埠是關的，所以一臺無人機器否則會無法觸及。）安裝只會加入你的金鑰——它不會放寬 SSH daemon 其他任何驗証設定。

當 tailscale_authkey 存在時，機器會在首次開機時加入你的 tailnet：Tailscale 從 ISO 繫結的套件安裝、防火牆允許 tailnet 介面，而一個背景任務會在機器真的有了網路時執行加入，失敗就重試直到成功。請使用可重複使用的預授權金鑰，讓一個磁碟映像能服務多臺機器。

建置 cidata 磁碟

任何帶有正確標籤的檔案系統都可以。一個小 ISO 是最簡單的做法：

mkdir cidata
cp user_configuration.json user_credentials.json authorized_keys cidata/
genisoimage -output cidata.iso -volid cidata -joliet -rock cidata/

然後把它與 Omarchy ISO 一起接到 VM 上。以下是一個完整的 Proxmox 範例：

qm create 101 --name my-omarchy \
  --bios ovmf --machine q35 --cpu host --cores 4 --memory 8192 \
  --ostype l26 --scsihw virtio-scsi-single \
  --efidisk0 local-lvm:0,efitype=4m,pre-enrolled-keys=0 \
  --scsi0 local-lvm:40,discard=on,iothread=1 \
  --net0 virtio,bridge=vmbr0 --vga virtio --serial0 socket \
  --ide2 local:iso/omarchy.iso,media=cdrom \
  --ide3 local:iso/cidata.iso,media=cdrom \
  --boot order='scsi0;ide2'

qm start 101

開機順序刻意把磁碟列在最前面：它在首次開機時會落空而落到 ISO，之後已安裝的系統就從磁碟開機。

兩個注意事項

加密的無人安裝並非完全無人——他們仍然得在首次開機時輸入 LUKS 通關語。而 user_configuration.json 中的 disk_encryption 區塊以明文攜帶那個通關語，所以請把用加密安裝建出來的 cidata 磁碟當作它本身就是的機密來對待。