Omarchy

📘 คู่มือการใช้งาน Terminal บน Omarchy Linux (ฉบับสมบูรณ์)

ยินดีต้อนรับสู่คู่มือการใช้งานระบบคอมมานด์ไลน์ (CLI) ของ Omarchy Linux ซึ่งเป็น Arch Linux distribution ที่ทันสมัย สวยงาม และถูกตั้งค่ามาให้พร้อมใช้งานทันทีโดยใช้ Hyprland (Window Manager), Waybar (Status Bar), และ Walker (App Launcher)

คู่มือนี้ได้รับการออกแบบมาเพื่อเก็บไว้ใน Obsidian สำหรับใช้ค้นหาคำสั่งและการตั้งค่าระบบได้อย่างรวดเร็ว

---

🚀 1. สถาปัตยกรรม Omarchy CLI

Omarchy ถูกออกแบบมาให้ควบคุมผ่านคำสั่งเดียวที่เป็นศูนย์กลาง คือ:

omarchy <group> <action> [arguments]

คำสั่งภายใต้ omarchy จะทำการรันสคริปต์ย่อยของระบบโดยอัตโนมัติ ทำให้ผู้ใช้ไม่ต้องจำชื่อสคริปต์ยาว ๆ และยังมีความปลอดภัยสูง

NOTE

คำสั่งส่วนใหญ่ของ Omarchy สามารถเรียกดูวิธีใช้งานได้โดยใส่ --help ต่อท้าย เช่น:
omarchy theme --help หรือ omarchy update --help

---

⚠️ 2. กฎเหล็กในการปรับแต่งระบบ (Critical Security & Customization Rules)

เพื่อไม่ให้การอัปเดตระบบของ Omarchy ในอนาคตเขียนทับการตั้งค่าของคุณ หรือทำให้ระบบเสียหาย โปรดปฏิบัติตามหลักการต่อไปนี้อย่างเคร่งครัด:

🔴 ห้ามแก้ไขใน ~/.local/share/omarchy/ เด็ดขาด!

โฟลเดอร์นี้เป็นส่วนเก็บซอร์สโค้ดและค่าเริ่มต้นของระบบ (System Defaults) ที่ถูกควบคุมผ่าน Git หากคุณเข้าไปแก้ไข:

1. การเปลี่ยนแปลงจะหายไปทั้งหมดเมื่อรัน omarchy update ครั้งถัดไป
2. อาจเกิดความขัดแย้ง (Git conflicts) จนทำให้ระบบอัปเดตไม่ได้

🟢 แก้ไขได้เฉพาะในโฟลเดอร์ ~/.config/ เท่านั้น!

หากต้องการปรับแต่งพฤติกรรมหรือหน้าตาของส่วนต่าง ๆ ให้เข้าไปแก้ไขที่โฟลเดอร์ที่ปลอดภัยเหล่านี้:

ส่วนประกอบ	หน้าที่	โฟลเดอร์ตั้งค่า (Safe to Edit)
Hyprland	หน้าต่าง, คีย์ลัด, อนิเมชัน, หน้าจอ	~/.config/hypr/
Waybar	แถบสถานะด้านบน/ล่าง	~/.config/waybar/
Walker	เมนูค้นหาแอปและคีย์ลัด	~/.config/walker/
Mako	ป๊อปอัปแจ้งเตือน	~/.config/mako/
Terminals	คอนฟิกตัวจำลองเทอร์มินัล	~/.config/alacritty/, ~/.config/foot/, ~/.config/kitty/, ~/.config/ghostty/
Themes	โฟลเดอร์เก็บธีมปรับแต่งเอง	~/.config/omarchy/themes/
Hooks	สคริปต์รันอัตโนมัติเมื่อเกิดเหตุการณ์	~/.config/omarchy/hooks/

---

⌨️ 3. การปรับแต่งคีย์ลัด (Keyboard Bindings)

คีย์ลัดของระบบทั้งหมดจะอยู่ในไฟล์ ~/.config/hypr/bindings.conf

IMPORTANT

การผูกคีย์บอร์ดทับคีย์เดิม (Re-binding):

1. ตรวจสอบคีย์ลัดที่มีอยู่แล้วในระบบก่อนเสมอด้วยคำสั่ง:

   omarchy menu keybindings --print

2. หากคีย์ลัดนั้นถูกใช้งานอยู่แล้ว คุณต้องเขียนคำสั่ง unbind ก่อนบรรทัดผูกคีย์ใหม่ เพื่อป้องกันคีย์ชนกัน เช่น:

   # ทำการ Unbind คีย์ Super+F เดิมที่ใช้สำหรับ Fullscreen
   unbind = SUPER, F
   # ผูกคีย์ Super+F ใหม่เพื่อเปิดโปรแกรมจัดการไฟล์ Nautilus
   bind = SUPER, F, exec, nautilus

---

🎨 4. การจัดการธีมและ Wallpaper (Theme Management)

เปลี่ยนสไตล์ของหน้าจอได้ง่าย ๆ ผ่านคำสั่งกลุ่ม theme

# แสดงรายชื่อธีมทั้งหมดที่เครื่องรองรับ
omarchy theme list
 
# แสดงธีมปัจจุบันที่กำลังใช้อยู่
omarchy theme current
 
# เปลี่ยนไปใช้งานธีมที่คุณระบุ (โปรดพิมพ์ตัวสะกดตรงตามชื่อธีม)
omarchy theme set "Tokyo Night"
 
# สลับภาพพื้นหลัง (Wallpaper) ถัดไปในธีมปัจจุบัน
omarchy theme bg next
 
# ติดตั้งธีมใหม่จาก Git Repository
omarchy theme install <url-ของ-git-repo>

---

🔄 5. การกู้คืนการตั้งค่าและการปรับใช้การเปลี่ยนแปลง (Refresh & Restart)

เมื่อปรับแต่งไฟล์คอนฟิกใน ~/.config/ แล้ว การเปลี่ยนแปลงบางอย่างอาจยังไม่แสดงผล คุณต้องรีสตาร์ตบริการนั้น ๆ หรือต้องการกู้คืนค่าเริ่มต้น (Reset to defaults):

# รีสตาร์ต Waybar (แถบสถานะ) เพื่อใช้ค่าคอนฟิกใหม่
omarchy restart waybar
 
# รีสตาร์ต Terminal ทั้งหมดเพื่อปรับใช้ฟอนต์หรือสีใหม่
omarchy restart terminal
 
# รีสตาร์ตระบบเสียง PipeWire เมื่อเกิดปัญหาระบบเสียงเงียบ
omarchy restart pipewire
 
# กู้คืนคอนฟิกเฉพาะแอปกลับเป็นค่าเริ่มต้น (โปรดระมัดระวังเนื่องจากจะลบค่าปรับแต่งเดิม)
# ตัวอย่าง: รีเซ็ตคอนฟิก Waybar เป็นค่าตั้งต้น (จะมีการสำรองข้อมูลเก่าให้ก่อน)
omarchy refresh waybar

TIP

สำหรับระบบหน้าต่าง Hyprland โดยทั่วไปจะรีโหลดโดยอัตโนมัติเมื่อกดบันทึกไฟล์คอนฟิก หากต้องการบังคับรีโหลดและตรวจสอบความถูกต้อง สามารถใช้คำสั่ง:
hyprctl reload && hyprctl configerrors

---

🛠️ 6. ระบบกู้คืนระบบและการแก้ปัญหา (Troubleshooting & Diagnostics)

หากเกิดปัญหาในการใช้งาน เช่น ระบบค้าง แถบเครื่องมือหาย หรือคอมมานด์ไลน์แสดงข้อผิดพลาด:

# ดึงข้อมูลดีบักระบบทั้งหมด (ต้องรันด้วยธงหลีกเลี่ยงการติด sudo เสมอ)
omarchy debug --no-sudo --print
 
# ส่งออกล็อกของระบบเพื่อใช้ขอความช่วยเหลือหรือส่งผู้พัฒนา
omarchy upload log
 
# รีเซ็ตการตั้งค่าคอนฟิกทั้งหมดของ Omarchy กลับเป็นค่าเริ่มต้นจากโรงงาน (กู้คืนทุกแอป)
omarchy reinstall configs

---

📋 7. สรุปคำสั่ง Omarchy แยกตามหมวดหมู่ (All Commands by Groups)

นี่คือคำสั่งทั้งหมดที่มีอยู่บน Omarchy Linux จัดกลุ่มตามหน้าที่เพื่อให้ง่ายต่อการค้นหาและศึกษาเพิ่มเติม:

📂 การตรวจสอบการเสียบสายชาร์จ (AC Power) (ac)

คำสั่ง	หน้าที่และรายละเอียด
omarchy ac present	Returns true if AC power is connected.

📂 การควบคุมระบบเสียง (Audio Controls) (audio)

คำสั่ง	หน้าที่และรายละเอียด
omarchy audio input mute	Toggle microphone mute. Drives the hardware mic-mute LED on laptops that expose one.
omarchy audio output switch	Switch between audio outputs while preserving the mute status. By default mapped to Super + Mute.

📂 การตรวจสอบสถานะแบตเตอรี่ (Battery) (battery)

คำสั่ง	หน้าที่และรายละเอียด
omarchy battery capacity	Returns the battery full capacity in Wh (rounded to whole number).
omarchy battery present	Returns true if a battery is present on the system.
omarchy battery remaining	Returns the battery percentage remaining as an integer.
omarchy battery remaining time	Returns the battery time remaining (to empty or full) in a compact format.
omarchy battery status	Returns a formatted battery status string with percentage and power draw/charge.

📂 การจัดการ Git Branch ของ Omarchy (branch)

คำสั่ง	หน้าที่และรายละเอียด
omarchy branch set <master|rc|dev>	Set the branch for Omarchy’s git repository.

📂 การปรับแต่งภาพลักษณ์ระบบ (Branding & Logo) (branding)

คำสั่ง	หน้าที่และรายละเอียด
omarchy branding about <image|text|reset>	Edit, set, or reset About branding
omarchy branding screensaver <image|text|reset>	Edit, set, or reset screensaver branding

📂 การปรับความสว่างหน้าจอและคีย์บอร์ด (Brightness) (brightness)

คำสั่ง	หน้าที่และรายละเอียด
omarchy brightness display apple <+N%|N%-|N%>	Adjust the brightness on Apple Studio Displays and Apple XDR Displays using asdcontrol.
omarchy brightness display <+N%|N%-|N%|off|on>	Adjust brightness on the most likely display device.
omarchy brightness keyboard mute <on|off>	Set the mic-mute indicator LED on laptops that expose a platform::micmute LED node.
omarchy brightness keyboard <up|down|cycle|off|restore>	Adjust keyboard backlight brightness using available steps.

📂 การจับภาพหน้าจอและการอัดวิดีโอ (Screen Capture & OCR) (capture)

คำสั่ง	หน้าที่และรายละเอียด
omarchy capture screenrecording [--with-desktop-audio] [--with-microphone-audio] [--with-webcam] [--webcam-device=<device>] [--resolution=<size>] [--stop-recording]	Start or stop screen recording
omarchy capture screenshot [smart|region|windows|fullscreen] [slurp|copy|save] [--editor=<name>]	Take a screenshot
omarchy capture text extraction	Extract text from a screenshot region with OCR

📂 การจัดการเวอร์ชัน Channel (Stable/Dev/Edge) (channel)

คำสั่ง	หน้าที่และรายละเอียด
omarchy channel set <stable|rc|edge|dev>	Set the Omarchy channel, which dictates what git branch and package repository is used.

📂 การตรวจสอบความพร้อมของคำสั่งระบบ (Command Checks) (cmd)

คำสั่ง	หน้าที่และรายละเอียด
omarchy cmd missing	Check whether any required commands are missing
omarchy cmd present	Check whether all required commands are available

📂 การจัดการ EFI Boot Entry (config)

คำสั่ง	หน้าที่และรายละเอียด
omarchy config direct boot	Add or remove an EFI boot entry for the Omarchy UKI, allowing the system to boot directly

📂 การดีบักข้อมูลระบบ (Debugging) (debug)

คำสั่ง	หน้าที่และรายละเอียด
omarchy debug [--no-sudo] [--print]	Print debugging information

📂 การตั้งค่าแอปเริ่มต้น (Default Apps: Browser, Editor, Terminal) (default)

คำสั่ง	หน้าที่และรายละเอียด
omarchy default browser [chromium|chrome|brave|brave-origin|edge|firefox|zen]	Set the default browser for Omarchy and XDG handlers
omarchy default editor [code|cursor|zed|sublime_text|helix|vim|emacs|nvim]	Set the default editor for $EDITOR
omarchy default terminal [alacritty|foot|ghostty|kitty]	Set the default terminal used by xdg-terminal-exec

📂 คำสั่งสำหรับผู้พัฒนา Omarchy (Development Tools) (dev)

คำสั่ง	หน้าที่และรายละเอียด
omarchy dev add migration	Creates a new Omarchy migration named after the unix timestamp of the last commit.
omarchy dev benchmark [--repeat=<count>]	Measure Omarchy CLI response times
omarchy dev bin metadata [--json]	Show Omarchy bin metadata fields and defaults

📂 การจัดการข้อมูลไดรฟ์และรหัสผ่านเข้ารหัส (Drive Tools) (drive)

คำสั่ง	หน้าที่และรายละเอียด
omarchy drive info <drive>	Print drive information such as size, model, and mount details
omarchy drive password	Set a new encryption password for a drive selected.
omarchy drive select	Select a drive from a list with info that includes space and brand. Used by omarchy-drive-password.

📂 การรันระบบครั้งแรก (First Run) (first)

คำสั่ง	หน้าที่และรายละเอียด
omarchy first run	Finish the installation of Omarchy with items that can only be done after logging in.

📂 การเปลี่ยนฟอนต์ระบบ (Monospace Fonts) (font)

คำสั่ง	หน้าที่และรายละเอียด
omarchy font current	Show current monospace font
omarchy font list	List available monospace fonts
omarchy font set <font-name>	Set the system monospace font

📂 การตั้งค่าระบบจำศีล (Hibernation/Swap Setup) (hibernation)

คำสั่ง	หน้าที่และรายละเอียด
omarchy hibernation available	Check if hibernation is supported
omarchy hibernation remove	Remove hibernation setup including swap and boot resume settings
omarchy hibernation setup [--force] [--no-rebuild]	Set up hibernation with swap and boot resume configuration

📂 การจัดการ Hooks (Automation Scripts) (hook)

คำสั่ง	หน้าที่และรายละเอียด
omarchy hook install <type> <file>	Install a hook into ~/.config/omarchy/hooks/.d/
omarchy hook [name] [args...]	Run a named hook from ~/.config/omarchy/hooks/ and ~/.config/omarchy/hooks/.d/.

📂 การตรวจหาและปรับแต่งฮาร์ดแวร์เฉพาะ (Hardware Detection) (hw)

คำสั่ง	หน้าที่และรายละเอียด
omarchy hw asus expertbook b9406	Detect ASUS ExpertBook B9406 series laptops on Intel Panther Lake.
omarchy hw asus rog	Detect whether the computer is an Asus ROG machine.
omarchy hw asus zenbook ux5406aa	Detect ASUS Zenbook UX5406AA series laptops on Intel Panther Lake.
omarchy hw dell xps haptic touchpad	Match Dell XPS systems with the Synaptics haptic touchpad.
omarchy hw dell xps oled	Match Dell XPS systems with LG OLED panel on Intel Panther Lake (Xe3) GPU.
omarchy hw external monitors	Returns true when an external monitor is physically connected.
omarchy hw framework16	Detect whether the computer is a Framework Laptop 16.
omarchy hw hybrid gpu	Detect whether the system has an active hybrid GPU configuration
omarchy hw intel	Detect whether the computer has an Intel CPU.
omarchy hw intel ptl	Detect whether the computer has an Intel Panther Lake GPU.
omarchy hw match <pattern>	Match against the computer’s DMI product name or product family (case-insensitive).
omarchy hw nvidia gsp	Detect whether the computer has an NVIDIA GPU with GSP firmware (Turing or newer).
omarchy hw nvidia without gsp	Detect whether the computer has an NVIDIA GPU without GSP firmware (Maxwell/Pascal/Volta).
omarchy hw recover internal monitor	Clear the internal-monitor-disable toggle if no external display is connected.
omarchy hw surface	Detect whether the computer is a Microsoft Surface device.
omarchy hw touchpad	Print the detected Hyprland touchpad or trackpad device name
omarchy hw touchscreen	Print the detected Hyprland touchscreen or tablet device name
omarchy hw vulkan	Detect whether Vulkan is available.

📂 การจัดการหน้าจอและหน้าต่างของ Hyprland (hyprland)

คำสั่ง	หน้าที่และรายละเอียด
omarchy hyprland monitor focused apple	Return success if the focused Hyprland monitor is an Apple display.
omarchy hyprland monitor focused	Print the name of the currently focused Hyprland monitor.
omarchy hyprland monitor internal mirror <on|off|toggle|recover>	Enable, disable, toggle, or recover mirroring the internal display to an external monitor
omarchy hyprland monitor internal <on|off|toggle|recover>	Enable, disable, toggle, or recover the internal laptop display
omarchy hyprland monitor scaling cycle	Cycle focused Hyprland monitor scaling through 1x, 1.25x, 1.6x, 2x, 3x, and 4x
omarchy hyprland monitor watch	Watch Hyprland monitor events and recover monitor toggles when a monitor is removed
omarchy hyprland toggle disabled <flag-name>	Check if a Hyprland toggle is currently disabled (missing).
omarchy hyprland toggle enabled <flag-name>	Check if a Hyprland toggle is currently enabled.
omarchy hyprland toggle [--enabled-notification <text>] [--disabled-notification <text>] <flag-name>	Toggle permanent Hyprland flags by copying them into a directory that’s sourced entirely.
omarchy hyprland window close all	Close all open windows
omarchy hyprland window gaps toggle	Toggles the window gaps globally between no gaps and the default.
omarchy hyprland window pop [width height x y]	Toggle to pop-out a tile to stay fixed on a display basis.
omarchy hyprland window single square aspect toggle	Toggle single-window square aspect ratio.
omarchy hyprland window transparency toggle	Toggles transparency for the currently focused window.
omarchy hyprland workspace layout toggle	Toggle the layout on the current active workspace between dwindle and scrolling

📂 การติดตั้งแอปพลิเคชันและสภาพแวดล้อม (Install Environments/Gaming/VSCode) (install)

คำสั่ง	หน้าที่และรายละเอียด
omarchy install browser <chrome|brave|brave-origin|edge|firefox|zen>	Install a supported browser
omarchy install chromium google account	Allow Chromium to sign in to Google accounts by adding the required OAuth credentials
omarchy install dev-env <ruby|node|bun|deno|go|laravel|symfony|php|python|elixir|phoenix|rust|java|zig|ocaml|dotnet|clojure|scala>	Install a supported development environment
omarchy install docker dbs	Install one of the supported databases in a Docker container with the suitable development options.
omarchy install dropbox	Install and start the Dropbox service. Must then be authenticated via the web.
omarchy install gaming geforce now	Install and launch Geforce Now.
omarchy install gaming gpu lib32	Install lib32 graphics drivers (Vulkan + NVIDIA) for any detected GPUs.
omarchy install gaming heroic	Install Heroic Games Launcher (Epic, GOG, Amazon Prime Gaming) with graphics drivers.
omarchy install gaming lutris	Install Lutris with Wine + DXVK for running Windows games (Battle.net, EA, Ubisoft Connect, etc.)
omarchy install gaming moonlight	Install Moonlight (NVIDIA GameStream / Sunshine client) for streaming games to this PC.
omarchy install gaming retroarch	Install RetroArch with the full libretro core set plus FBNeo and a ~/Games ROM directory.
omarchy install gaming steam	Install Steam and graphics drivers selected for this system
omarchy install gaming xbox cloud	Install Xbox Cloud Gaming as a web app and launch it.
omarchy install gaming xbox controllers	Install support for using Xbox controllers with Steam/RetroArch/etc.
omarchy install helix	Install Helix and configure it to use the current Omarchy theme
omarchy install nordvpn	Install the NordVPN service with optional GUI.
omarchy install once	Install the ONCE service, enable its background service, and launch the TUI.
omarchy install tailscale	Install the Tailscale mesh VPN service and a web app for the Tailscale Admin Console.
omarchy install terminal <alacritty|foot|ghostty|kitty>	Install one of the approved terminals and set it as the default for Omarchy (Super + Return etc).
omarchy install vscode	Install VS Code and configure Omarchy defaults for secrets, updates, and theme
omarchy install zed	Install Zed Editor and configure it with the current Omarchy theme

📂 การเปิดใช้งานแอปพลิเคชันและเมนู TUI (Launchers) (launch)

คำสั่ง	หน้าที่และรายละเอียด
omarchy launch about	Launch the fastfetch TUI that gives information about the current system.
omarchy launch audio	Launch the Omarchy audio controls TUI (provided by wiremix).
omarchy launch bluetooth	Launch the Omarchy bluetooth controls TUI (provided by bluetui).
omarchy launch browser [url]	Launch the default browser as determined by xdg-settings.
omarchy launch editor <path>	Launch the default editor as determined by $EDITOR (set via ~/.config/uwsm/default) (or nvim if missing).
omarchy launch floating terminal with presentation <command>	Launch a floating terminal with the Omarchy presentation wrapper
omarchy launch or focus <window-pattern> <launch-command>	Launch an app or focus an existing window matching a pattern
omarchy launch or focus tui <command> [args...]	Launch a TUI or focus an existing terminal window for it
omarchy launch or focus webapp <window-pattern> <url-and-flags...>	Launch or focus on a given web app identified by the window-pattern.
omarchy launch screensaver	Launch the Omarchy screensaver in the default terminal on the system with the correct font configuration.
omarchy launch tui <command> [args...]	Launch a TUI command in the default terminal with Omarchy styling
omarchy launch walker	Launch Walker and ensure its Elephant data provider is running
omarchy launch webapp <url>	Launch a URL as a web app in the default supported browser
omarchy launch wifi	Launch the Omarchy wifi controls (provided by the Impala TUI).

📂 การเปิดใช้งานเมนูค้นหาและเลือกตัวเลือก (Walker Menus) (menu)

คำสั่ง	หน้าที่และรายละเอียด
omarchy menu file label paths formats [walker args...]	Pick a file with Walker
omarchy menu input prompt [walker args...]	Prompt for text input with Walker
omarchy menu keybindings	Display Hyprland keybindings defined in your configuration using walker for an interactive search menu.
omarchy menu	Launch the Omarchy Menu or takes a parameter to jump straight to a submenu.
omarchy menu select prompt option... [-- walker args...]	Pick one option with Walker

📂 กลุ่มคำสั่ง: migrate (migrate)

คำสั่ง	หน้าที่และรายละเอียด
omarchy migrate	Run all pending migrations to bring the system in line with the installed version.

📂 การจัดการการแจ้งเตือน (Mako Notifications) (notification)

คำสั่ง	หน้าที่และรายละเอียด
omarchy notification dismiss <summary>	Dismiss a mako notification on the basis of its summary. Used by the first-run notifications to dismiss them after clicking for action.
omarchy notification send <glyph> <headline> [description] [notify-send options]	Send a desktop notification with Omarchy glyph and body spacing

📂 การติดตั้งและรันเครื่องมือ NPX (Node Packages) (npx)

คำสั่ง	หน้าที่และรายละเอียด
omarchy npx install <package> [command-name]	Install an npx wrapper for a given npm package.

📂 การจัดการแพ็กเกจระบบ (Arch Linux & AUR Packages) (pkg)

คำสั่ง	หน้าที่และรายละเอียด
omarchy pkg add <packages...>	Install Arch packages if they are missing
omarchy pkg aur accessible	Returns true if the AUR is up and available.
omarchy pkg aur add <packages...>	Add the named packages to the system from the AUR if they’re missing. Returns false if it couldn’t be done.
omarchy pkg aur install	Show a fuzzy-finder TUI for picking new AUR packages to install.
omarchy pkg drop <packages...>	Remove all the named packages from the system if they’re installed (otherwise ignore).
omarchy pkg install	Show a fuzzy-finder TUI for picking new Arch and OPR packages to install.
omarchy pkg missing <packages...>	Returns true if any of the named packages are missing from the system (or false if they’re all there).
omarchy pkg present <packages...>	Returns true if all of the named packages are installed on the system (or false if any of them are missing).
omarchy pkg remove	Show a fuzzy-finder TUI for picking packages installed on the system to be removed.

📂 การปรับแต่งหน้าจอตอนบูตระบบ (Plymouth Boot Theme) (plymouth)

คำสั่ง	หน้าที่และรายละเอียด
omarchy plymouth preview <background-hex> <text-hex> <path-to-logo.png> <output-path>	Preview a Plymouth boot screen with custom colors and logo
omarchy plymouth reset	Restore the default Omarchy Plymouth boot theme and SDDM login screen
omarchy plymouth set by theme <theme-name>	Set the Plymouth boot theme from an Omarchy theme
omarchy plymouth set <background-hex> <text-hex> <path-to-logo.png>	Set the Plymouth boot theme colors and logo

📂 การจัดการโหมดพลังงาน (Power Profiles) (powerprofiles)

คำสั่ง	หน้าที่และรายละเอียด
omarchy powerprofiles init	Set the correct power profile on boot based on current AC/battery state.
omarchy powerprofiles list	Returns a list of all the available power profiles on the system.
omarchy powerprofiles set [autodetect|ac|battery]	Set the power profile to the requested level, falling back to balanced

📂 การรีเซ็ตการตั้งค่าแอปต่าง ๆ กลับเป็นค่าเริ่มต้น (refresh)

คำสั่ง	หน้าที่และรายละเอียด
omarchy refresh applications	Ensure all default .desktop, web apps, TUIs, and npx wrappers are installed.
omarchy refresh chromium	Refresh the ~/.config/chromium-flags.conf file from the Omarchy defaults.
omarchy refresh config <config-path>	Copies the named config from ~/.local/share/omarchy/config/X/Y/Z -> ~/.config/X/Y/Z.
omarchy refresh fastfetch	Overwrite the user config for fastfetch with the Omarchy default.
omarchy refresh hypridle	Overwrite the user config for hypridle with the Omarchy default and restart the service.
omarchy refresh hyprland	Overwrite all the user configs in ~/.config/hypr with the Omarchy defaults.
omarchy refresh hyprlock	Overwrite the user config for hyprlock with the Omarchy default.
omarchy refresh hyprsunset	Overwrite the user config for hyprsunset with the Omarchy default and restart the service.
omarchy refresh limine	Overwrite the user config for the Limine bootloader and rebuild it.
omarchy refresh pacman	Overwrite the package configuration for /etc/pacman with the Omarchy default of using its dedicated mirrors and repositories, then update all packages.
omarchy refresh plymouth	Overwrite the user config for the Plymouth drive decryption and boot sequence with the Omarchy default and rebuild it.
omarchy refresh sddm	Refresh the SDDM theme from default
omarchy refresh swayosd	Overwrite the user configs for swayosd (controls on-screen feedback for changing volume/songs etc) with the Omarchy defaults and restart the service.
omarchy refresh tmux	Overwrite the user tmux config with the Omarchy default and reload tmux.
omarchy refresh walker	Overwrite the user configs for the Walker application launcher (which also powers the Omarchy Menu) and restart the services.
omarchy refresh waybar	Reset Waybar config to Omarchy defaults

📂 การติดตั้งแอปและค่าคอนฟิกเริ่มต้นซ้ำ (Reinstall) (reinstall)

คำสั่ง	หน้าที่และรายละเอียด
omarchy reinstall configs	Reset all Omarchy user configs to the defaults
omarchy reinstall git	Reinstall the Omarchy source directory from git
omarchy reinstall	Reinstall Omarchy packages and reset default configs
omarchy reinstall pkgs	Reinstall all default Omarchy packages from the stable channel

📂 ระบบแจ้งเตือนความจำส่วนตัว (Reminders) (reminder)

คำสั่ง	หน้าที่และรายละเอียด
omarchy reminder <minutes> [message] | show | clear	Set and show lightweight desktop notification reminders

📂 การลบแอปพลิเคชันและสภาพแวดล้อมการทำงาน (Uninstallers) (remove)

คำสั่ง	หน้าที่และรายละเอียด
omarchy remove browser <chrome|brave|brave-origin|edge|firefox|zen>	Remove a supported browser and clean up Omarchy browser defaults
omarchy remove dev env <ruby|node|bun|deno|go|php|laravel|symfony|python|elixir|phoenix|zig|rust|java|dotnet|ocaml|clojure|scala>	Remove a development environment that was previously installed via omarchy-install-dev-env.
omarchy remove gaming geforce now	Remove the GeForce NOW Flatpak app and its data.
omarchy remove gaming heroic	Remove Heroic Games Launcher and its game libraries, configs, and caches.
omarchy remove gaming lutris	Remove Lutris, Wine, umu-launcher, and all their configs and caches.
omarchy remove gaming minecraft	Remove the Minecraft launcher along with its worlds, mods, and caches.
omarchy remove gaming moonlight	Remove Moonlight and its configs and caches.
omarchy remove gaming retroarch	Remove RetroArch, all libretro cores, and its config/saves. Leaves ~/Games/roms and ~/Games/bios alone.
omarchy remove gaming steam	Remove Steam and all of its game libraries, configs, and caches.
omarchy remove gaming xbox cloud	Remove the Xbox Cloud Gaming web app.
omarchy remove gaming xbox controllers	Remove the xpadneo Xbox controller driver and undo its module/blacklist config.
omarchy remove preinstalls	Remove preinstalled Omarchy applications (web apps, TUIs, and selected packages).
omarchy remove security fido2	Remove FIDO2 authentication from sudo and polkit
omarchy remove security fingerprint	Remove fingerprint authentication from sudo, polkit, and lock screen

📂 การรีสตาร์ตบริการและแอปพลิเคชันหลังจากแก้ไขคอนฟิก (restart)

คำสั่ง	หน้าที่และรายละเอียด
omarchy restart app <application-name> [application-args...]	Restart an application by killing it and relaunching via uwsm.
omarchy restart bluetooth	Unblock and restart the bluetooth service.
omarchy restart btop	Reload btop configuration (used by the Omarchy theme switching).
omarchy restart helix	Reload Helix configuration
omarchy restart hyprctl	Reload hyprland configuration (used by the Omarchy theme switching).
omarchy restart hypridle	Restart the hypridle service (used for idle detection and auto-lock).
omarchy restart hyprsunset	Restart the hyprsunset service (used for blue light filtering/night light).
omarchy restart mako	Reload mako configuration (used by the Omarchy theme switching).
omarchy restart opencode	Reload opencode configuration (used by the Omarchy theme switching).
omarchy restart pipewire	Restart the PipeWire audio service to fix audio issues or apply new configuration.
omarchy restart swayosd	Restart the SwayOSD server
omarchy restart terminal	Reload supported terminal emulators after config changes
omarchy restart tmux	Restart tmux if running with the latest configuration
omarchy restart trackpad	Reset the trackpad by unbinding and rebinding its driver.
omarchy restart walker	Restart Walker and related user services
omarchy restart waybar	Restart Waybar
omarchy restart wifi	Unblock and restart the Wi-Fi service.
omarchy restart xcompose	Restart the XCompose input method service (fcitx5) to apply new compose key settings.

📂 การรันภาพพักหน้าจอ (Screensaver) (screensaver)

คำสั่ง	หน้าที่และรายละเอียด
omarchy screensaver	Run the Omarchy screensaver using random effects from TTE.

📂 การตั้งค่าความปลอดภัยและ DNS (Fingerprint, FIDO2, DNS) (setup)

คำสั่ง	หน้าที่และรายละเอียด
omarchy setup dns [Cloudflare|Google|DHCP|Custom]	Configure the system DNS provider
omarchy setup security fido2	Set up FIDO2 authentication for sudo and polkit
omarchy setup security fingerprint	Set up fingerprint authentication for sudo, polkit, and lock screen

📂 การแชร์ไฟล์และโฟลเดอร์ในเน็ตเวิร์ก (LocalSend) (share)

คำสั่ง	หน้าที่และรายละเอียด
omarchy share <clipboard|file|folder> [path...]	Share clipboard, files, or folders with LocalSend

📂 การแสดงข้อความสถานะและโลโก้ใน Terminal (show)

คำสั่ง	หน้าที่และรายละเอียด
omarchy show done	Display a “Done!” message with a spinner and wait for user to press any key.
omarchy show logo	Display the Omarchy logo in the terminal using green color.

📂 การสำรองและกู้คืนระบบ (Snapper Snapshots) (snapshot)

คำสั่ง	หน้าที่และรายละเอียด
omarchy snapshot <create|restore>	Create or restore system snapshots with snapper

📂 การจัดการสิทธิ์ Sudo (Passwordless / Keepalive) (sudo)

คำสั่ง	หน้าที่และรายละเอียด
omarchy sudo keepalive	Prompt for sudo once and keep the credential alive in the background.
omarchy sudo passwordless [MINUTES]	Toggle passwordless sudo for the current user.
omarchy sudo reset	Reset the sudo lockout/faillock for the current user.

📂 การควบคุมการแสดงผลบนหน้าจอเมื่อกดปุ่มฟังก์ชัน (SwayOSD Client) (swayosd)

คำสั่ง	หน้าที่และรายละเอียด
omarchy swayosd brightness <0-100>	Display brightness level using SwayOSD on the current monitor.
omarchy swayosd client <swayosd-client-args...>	Wrapper for swayosd-client that targets the currently focused monitor.
omarchy swayosd kbd brightness <0-100>	Display keyboard brightness level using SwayOSD on the current monitor.

📂 การล็อกเครื่อง ล็อกเอาต์ รีบูต และปิดเครื่อง (System Power) (system)

คำสั่ง	หน้าที่และรายละเอียด
omarchy system lock	Lock the computer and turn off the display
omarchy system logout	Log out after closing application windows
omarchy system reboot	Reboot after closing application windows
omarchy system shutdown	Shut down after closing application windows
omarchy system wake	Wake displays and restore brightness after idle

📂 การตั้งค่าและเปลี่ยนธีมของระบบ (Theme Management) (theme)

คำสั่ง	หน้าที่และรายละเอียด
omarchy theme bg install	Open the current theme’s user background folder
omarchy theme bg next	Cycle to the next background for the current theme
omarchy theme bg set <path-to-image>	Set the current background image
omarchy theme current	Show current theme
omarchy theme install [git-repo-url]	Install a theme from a git repository
omarchy theme list	List available themes
omarchy theme refresh	Refresh the current theme from its templates.
omarchy theme remove [theme-name]	Remove a user-installed theme
omarchy theme set <theme-name>	Apply an Omarchy theme
omarchy theme update	Update user-installed git themes

📂 การเปิด-ปิดฟังก์ชันต่าง ๆ ของระบบชั่วคราว (Toggle Controls) (toggle)

คำสั่ง	หน้าที่และรายละเอียด
omarchy toggle enabled <flag-name>	Check if a toggle is enabled (flag file exists)
omarchy toggle hybrid gpu	Toggle dedicated vs integrated GPU mode via supergfxd (for hybrid gpu laptops, like Asus G14).
omarchy toggle idle	Toggle hypridle idle locking
omarchy toggle nightlight	Toggle nightlight screen temperature
omarchy toggle notification silencing	Toggle notification do-not-disturb mode
omarchy toggle [--enabled-notification <text>] [--disabled-notification <text>] <flag-name>	Toggle Omarchy features between enabled and disabled
omarchy toggle screensaver	Toggle screensaver availability
omarchy toggle suspend	Toggle suspend availability in the system menu
omarchy toggle touchpad [on|off|toggle]	Enable, disable, or toggle the touchpad
omarchy toggle touchscreen [on|off|toggle]	Enable, disable, or toggle the touch functionality of the screen
omarchy toggle waybar	Toggle Waybar visibility

📂 การแปลงไฟล์สื่อและรูปภาพ (Transcoding & SVG-to-ASCII) (transcode)

คำสั่ง	หน้าที่และรายละเอียด
omarchy transcode ascii <input-image.svg|png> <output-path> [--width <columns>] [--height <rows>] [--mode <braille|block>] [--threshold <percent>] [--invert]	Transcode an image into ASCII/Unicode art text
omarchy transcode [--path path] [input] [format] [resolution]	Transcode pictures and videos for sharing

📂 การสร้างทางลัดเข้าเมนู Terminal UI (TUI Launcher Creator) (tui)

คำสั่ง	หน้าที่และรายละเอียด
omarchy tui install [name command window-style icon-url]	Create a desktop launcher for a terminal UI app
omarchy tui remove all	Remove all TUIs installed via omarchy-tui-install.
omarchy tui remove [name...]	Remove terminal UI desktop launchers

📂 การตั้งค่าโซนเวลา (Timezone) (tz)

คำสั่ง	หน้าที่และรายละเอียด
omarchy tz select	Select and set the system timezone

📂 การอัปเดตระบบปฏิบัติการและแพ็กเกจ (System Updates) (update)

คำสั่ง	หน้าที่และรายละเอียด
omarchy update analyze logs	Check the update log for known failure conditions
omarchy update aur pkgs	Update AUR packages if any are installed
omarchy update available	Get remote tag
omarchy update available reset	Ensure Waybar icon offering the available update is removed
omarchy update branch <branch>	Switch Omarchy branches and update from the selected branch
omarchy update confirm	Prompt for confirmation before starting an update
omarchy update firmware	Update system firmware using fwupd. Ensures the fwupd EFI binary is installed
omarchy update git	Pull the latest Omarchy git changes
omarchy update keyring	Ensure the Omarchy and Arch keyring packages are installed and populated
omarchy update [-y]	Update Omarchy and system packages
omarchy update orphan pkgs	Remove orphaned system packages after updates
omarchy update perform	Run the full Omarchy update pipeline
omarchy update restart	Prompt for required reboot or service restarts after updates
omarchy update system pkgs	Update system packages with pacman
omarchy update time	Restart system time synchronization

📂 การตรวจสอบเวอร์ชันและสถานะของ Omarchy (version)

คำสั่ง	หน้าที่และรายละเอียด
omarchy version branch	Print the current Omarchy git branch
omarchy version channel	Print the active Omarchy mirror and package channel
omarchy version	Print the installed Omarchy version
omarchy version pkgs	Print when system packages were last upgraded

📂 การติดตั้งและตั้งค่าระบบพิมพ์ด้วยเสียง AI (Voxtype Dictation) (voxtype)

คำสั่ง	หน้าที่และรายละเอียด
omarchy voxtype config	Open the Voxtype configuration file
omarchy voxtype install	Install and configure Voxtype dictation
omarchy voxtype model	Open Voxtype AI model setup
omarchy voxtype remove	Remove Voxtype dictation and its configuration
omarchy voxtype status	Clean up the voxtype —follow child when Waybar reloads

📂 การตรวจสอบสภาพอากาศสด (Weather Status) (weather)

คำสั่ง	หน้าที่และรายละเอียด
omarchy weather icon	Returns a weather condition icon, adjusted for live sunrise and sunset.
omarchy weather status	Returns a formatted weather status string with temperature and wind speed.

📂 การแปลงเว็บไซต์เป็นแอปพลิเคชันเครื่อง (Web App Launcher Creator) (webapp)

คำสั่ง	หน้าที่และรายละเอียด
omarchy webapp handler hey [url]	Open HEY webmail and translate mailto links
omarchy webapp handler zoom [url]	Open Zoom web meetings from browser protocol links
omarchy webapp install [name url icon [custom-exec] [mime-types]]	Create a desktop launcher for a web app
omarchy webapp remove all	Remove all web apps installed via omarchy-webapp-install.
omarchy webapp remove [name...]	Remove web app desktop launchers

📂 การตั้งค่าประหยัดพลังงาน Wi-Fi (wifi)

คำสั่ง	หน้าที่และรายละเอียด
omarchy wifi powersave <on|off>	Set Wi-Fi power save mode on wireless interfaces

📂 การจัดการ Windows VM บน Linux (windows)

คำสั่ง	หน้าที่และรายละเอียด
omarchy windows vm <install|remove|launch|stop|status> [options]	Install, launch, stop, inspect, or remove the Windows VM

🔗 คำสั่งย่อ (Aliases)

คำสั่งลัดที่ผูกไว้ในระบบเพื่อความรวดเร็วในการพิมพ์:

คำสั่งย่อ	คำสั่งเต็ม
omarchy omarchy	logout omarchy system logout
omarchy omarchy	reboot omarchy system reboot
omarchy omarchy	screenrecord omarchy capture screenrecording
omarchy omarchy	screenshot omarchy capture screenshot
omarchy omarchy	shutdown omarchy system shutdown