blomarchy/docs/commands.md

# Commands

Generated by `blob-docs-commands` from the `# blob:summary=` line in each
file. Do not edit by hand.

Commands marked hidden are plumbing other commands call, and are left out
of the `blob` listing.


## audio

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-audio-availability` | Print PulseAudio sink availability for the shell | - |
| `blob-audio-input-mute` | Toggle microphone mute. Drives the hardware mic-mute LED on laptops that expose one. | - |
| `blob-audio-input-set` | Set the default audio input and move active streams | <node-id> <source-name> |
| `blob-audio-restart` | Restart audio services and recover stuck USB audio devices. | - |
| `blob-audio-sink` | Print the sink whose volume and mute a given output really uses | [sink-name] |
| `blob-audio-sink-set` | Set the default audio output and move active streams | <node-id> <sink-name> |
| `blob-audio-sink-switch` | Switch between audio outputs while preserving the mute status | - |
| `blob-audio-source-switch` | Cycle to the next media source and transfer playback when the current source is playing | [next\|previous] |
| `blob-audio-tuning` | Manage the speaker tuning for this laptop | <on\|off\|status\|match\|fronted-sink> [--force] |
| `blob-audio-volume` | Adjust output volume and show the Blob OSD | <raise\|lower\|mute-toggle\|+N\|-N> |

## bar

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-bar` | Configure the bar and its widget layout | use <id> \| reset \| defaults \| position <top\|bottom\|left\|right> \| transparent <true\|false\|toggle> \| put <id> [placement] \| move <id> [placement] \| set <id> <key> <value> [--json] [placement] |
| `blob-bar-color` | Choose a legible transparent bar text color (hidden) | - |

## battery

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-battery-low` | Send the low battery warning notification and run battery-low hooks. (hidden) | <percentage> |
| `blob-battery-status` | Returns a formatted battery status string with percentage and power draw/charge. | [--shell] |

## bg

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-bg-cache` | Cache background switcher thumbnails for the current theme | - |
| `blob-bg-current` | Show current background | - |
| `blob-bg-install` | Open the current theme's user background folder | - |
| `blob-bg-next` | Cycle to the next background for the current theme | - |
| `blob-bg-set` | Set the current background image | <path-to-image> |
| `blob-bg-switcher` | Open the Blob background switcher | - |

## bluetooth

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-bluetooth-device` | Control a Bluetooth device | [pair\|connect\|disconnect\|forget] <address> |
| `blob-bluetooth-power` | Turn Bluetooth on or off, remembered across reboots | <on\|off\|toggle\|is-on> |
| `blob-bluetooth-restart` | Unblock and restart the bluetooth service. | - |

## boot

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-boot` | - | - |

## branding

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-branding-about` | Edit, set, or reset About branding | <image\|text\|reset> |
| `blob-branding-screensaver` | Edit, set, or reset screensaver branding | <image\|text\|reset> |

## brightness

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-brightness-ddc` | Show or adjust DDC/CI display brightness for a Hyprland monitor. | <monitor> [+N%\|N%-\|N%] |
| `blob-brightness-display` | Show or adjust brightness on the focused display. | [--no-osd] [--monitor name] [+N%\|N%-\|N%\|off\|on] |
| `blob-brightness-display-apple` | Show or adjust Apple Studio Display and Apple XDR Display brightness using asdcontrol. | [--no-osd] [+N%\|N%-\|N%] |
| `blob-brightness-keyboard` | Adjust keyboard backlight brightness using available steps. | [--no-osd] <up\|down\|cycle\|off\|restore> |
| `blob-brightness-keyboard-mute` | Set the mic-mute indicator LED on laptops that expose a platform::micmute LED node. | <on\|off> |

## capture

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-capture-qr` | Decode a QR code from a screenshot region | - |
| `blob-capture-record` | Start or stop screen recording | [--fullscreen] [--with-desktop-audio] [--with-microphone-audio] [--with-webcam] [--webcam-device=<device>] [--webcam-size=<small\|medium\|large>] [--resolution=<size>] [--stop-recording] |
| `blob-capture-record-webcam` | Pick a webcam and start a screen recording with it | - |
| `blob-capture-region` | Pick a screen region over frozen screen content (hidden) | [region\|windows\|smart\|fullscreen] [--keep-freeze] [--match-monitor] \| --take-fullscreen \| --take-window \| --select-window <next\|prev\|left\|right\|up\|down> |
| `blob-capture-screenshot` | Take a screenshot | [smart\|region\|windows\|fullscreen] [slurp\|copy\|save] [--editor=<name>] |
| `blob-capture-text` | Extract text from a screenshot region with OCR | - |
| `blob-capture-webcam-list` | List webcam devices that support video capture (hidden) | - |
| `blob-capture-webcam-resize` | Resize the active webcam recording overlay | <smaller\|larger\|reset\|small\|medium\|large> |

## chromium

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-chromium-copy-url-host` | Native messaging host: copy a Chromium tab URL to the clipboard (hidden) | - |
| `blob-chromium-ytdlp-host` | Native messaging host: download the URL sent by the yt-dlp Chromium extension (hidden) | - |

## clipboard

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-clipboard-file` | Copy a file to the clipboard and paste it (hidden) | [--copy-only] <mime-type> <path> |
| `blob-clipboard-open` | Open a clipboard history entry (hidden) | --history-index <index> |
| `blob-clipboard-text` | Copy text to the clipboard and type or paste it (hidden) | [--shift-insert] [--copy-only] [--history-index <index>\|<text>] |

## cmd

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-cmd-cwd` | Print the current working directory of the active terminal window (hidden) | - |
| `blob-cmd-missing` | Check whether any required commands are missing | - |
| `blob-cmd-present` | Check whether all required commands are available | - |

## crash

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-crash-watch` | Watch for process crashes and offer an AI diagnosis (hidden) | - |

## default

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-default-browser` | Set the default browser for Blob and XDG handlers | [chromium\|chrome\|brave\|brave-origin\|edge\|firefox\|zen] |
| `blob-default-editor` | Set the default editor used by blob-launch-editor | [code\|cursor\|zed\|sublime_text\|helix\|vim\|emacs\|nvim] |
| `blob-default-terminal` | Set the default terminal used by xdg-terminal-exec | [alacritty\|foot\|ghostty\|kitty] |

## disk

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-disk-speedtest` | Measure live disk read and write speed | [target-dir] |

## display

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-display-size` | Scale text everywhere — blob shell, GTK apps, and terminals | [size\|reset] |
| `blob-display-state` | Print monitor panel state for the shell | - |

## docs

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-docs-commands` | Regenerate docs/commands.md from each command's own metadata (hidden) | - |
| `blob-docs-keybinds` | Regenerate docs/keybinds.md from the Hyprland Lua bindings (hidden) | - |

## drive

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-drive-info` | Print drive information such as size, model, and mount details | <drive> |
| `blob-drive-password` | Set a new encryption password for a drive selected. | - |
| `blob-drive-select` | Select a drive from a list with info that includes space and brand. Used by blob-drive-password. | - |

## file

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-file-select` | Pick files with the desktop file chooser | [--title <title>] [--multiple] [--directory] [--extensions "<ext ext...>"] |

## font

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-font-current` | Show current monospace font | - |
| `blob-font-list` | List available monospace fonts | - |
| `blob-font-set` | Set the system monospace font | <font-name> |

## games

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-games-retro-cores` | List installed RetroArch core names | - |
| `blob-games-retro-install` | Create a desktop launcher for a RetroArch game | [core path-to-game] |

## git

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-git-url-check` | Check that a git URL names a repository, not a transport helper (hidden) | <git-url> |

## hibernation

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-hibernation-available` | Check if hibernation is supported | - |

## hook

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-hook` | Run a named hook from ~/.config/blob/hooks/<name> and ~/.config/blob/hooks/<name>.d/. | [name] [args...] |

## hw

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-hw-clamshell` | Returns true when clamshell mode is active (hidden) | - |
| `blob-hw-dell-xps-haptic-touchpad` | Match Dell XPS systems with the Synaptics haptic touchpad. | - |
| `blob-hw-display` | Print the most likely display backlight device. | - |
| `blob-hw-external` | Returns true when an external monitor is physically connected. | - |
| `blob-hw-fingerprint` | Returns true when a fingerprint reader is present (hidden) | - |
| `blob-hw-hybrid-gpu` | Detect whether the system has an active hybrid GPU configuration | - |
| `blob-hw-laptop` | Returns true when running on a laptop (has a lid or laptop chassis). | - |
| `blob-hw-laptop-closed` | Returns true when the laptop lid is closed (hidden) | - |
| `blob-hw-match` | Match against the computer's DMI product name or product family (case-insensitive). | <pattern> |
| `blob-hw-nvidia` | Detect whether the computer has an NVIDIA GPU. | - |
| `blob-hw-nvidia-gsp` | Detect whether the computer has an NVIDIA GPU with GSP firmware (Turing or newer). | - |
| `blob-hw-nvidia-without-gsp` | Detect whether the computer has an NVIDIA GPU without GSP firmware (Maxwell/Pascal/Volta). | - |
| `blob-hw-touchpad` | Print the detected Hyprland touchpad or trackpad device name | - |
| `blob-hw-touchscreen` | Print the detected Hyprland touchscreen or tablet device name | - |
| `blob-hw-webcam` | Check whether a webcam is available | - |

## hypr

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-hypr-focus` | Focus a Hyprland window by application identity | <app-name> |
| `blob-hypr-monitor-clamshell` | Apply clamshell display state to Hyprland monitors (hidden) | - |
| `blob-hypr-monitor-external` | Returns true when Hyprland has an active external monitor (hidden) | - |
| `blob-hypr-monitor-focused` | Print the name of the currently focused Hyprland monitor. | - |
| `blob-hypr-monitor-focused-apple` | Return success if the focused or named Hyprland monitor is an Apple display. | [monitor] |
| `blob-hypr-monitor-internal` | Enable, disable, toggle, or recover the internal laptop display | <on\|off\|toggle\|recover> |
| `blob-hypr-monitor-laptop` | Print the name of the built-in laptop display, including disabled outputs. | - |
| `blob-hypr-monitor-mirror` | Enable, disable, toggle, or recover mirroring the internal display to an external monitor | <on\|off\|toggle\|recover> |
| `blob-hypr-monitor-modeless` | Returns true when Hyprland has an enabled monitor with no mode (hidden) | - |
| `blob-hypr-monitor-scaling` | Show, set, or adjust focused Hyprland monitor scaling | [up\|down\|SCALE] |
| `blob-hypr-monitor-watch` | Watch Hyprland monitor events and recover monitor toggles when a monitor is removed | - |
| `blob-hypr-reload-guard` | Pause or resume Hyprland config auto-reload around package transactions. (hidden) | - |
| `blob-hypr-restart` | Reload hyprland configuration (used by the Blob theme switching). | - |
| `blob-hypr-session-locked` | Returns true when the compositor holds a session lock (hidden) | - |
| `blob-hypr-toggle` | Toggle permanent Hyprland flags by copying them into a directory that's sourced entirely. | <flag-name> [on\|off\|toggle] |
| `blob-hypr-toggle-disabled` | Check if a Hyprland toggle is currently disabled (missing). | <flag-name> |
| `blob-hypr-toggle-enabled` | Check if a Hyprland toggle is currently enabled. | <flag-name> |
| `blob-hypr-window-close-all` | Close all open windows | - |
| `blob-hypr-window-gaps-toggle` | Toggles the window gaps globally between no gaps and the default. | - |
| `blob-hypr-window-pop` | Toggle to pop-out a tile to stay fixed on a display basis. | [width height x y] |
| `blob-hypr-window-single-square-aspect-toggle` | Toggle single-window square aspect ratio. | - |
| `blob-hypr-window-tiled-fullscreen-toggle` | Toggle tiled fullscreen for the focused Hyprland window | - |
| `blob-hypr-window-transparency-toggle` | Toggles transparency for the currently focused window. | - |
| `blob-hypr-window-width` | Save or restore the focused Hyprland window width | <save\|restore> |
| `blob-hypr-workspace-layout-toggle` | Toggle the layout on the current active workspace between dwindle and scrolling | - |

## install

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-install-browser` | Install a supported browser | <chrome\|brave\|brave-origin\|edge\|firefox\|zen> |
| `blob-install-chromium-copy-url` | Install the native messaging host for the Copy URL Chromium extension | - |
| `blob-install-chromium-ytdlp` | Install the native messaging host for the yt-dlp Chromium extension | - |
| `blob-install-dev-env` | Install a supported development environment | <ruby\|node\|bun\|deno\|go\|laravel\|symfony\|php\|python\|elixir\|phoenix\|rust\|java\|zig\|ocaml\|dotnet\|clojure\|scala> |
| `blob-install-docker-dbs` | Install one of the supported databases in a Docker container with the suitable development options. | - |
| `blob-install-font` | Install a Nerd Font package and switch the system to it | <display-name> <package> <family> |
| `blob-install-gaming-battlenet` | Install Battle.net standalone via umu-launcher + GE-Proton (no Steam, no Lutris, no Heroic). | - |
| `blob-install-gaming-geforce-now` | Install and launch Geforce Now. | - |
| `blob-install-gaming-gpu-lib32` | Install lib32 graphics drivers (Vulkan + NVIDIA) for any detected GPUs. | - |
| `blob-install-gaming-heroic` | Install Heroic Games Launcher (Epic, GOG, Amazon Prime Gaming) with graphics drivers. | - |
| `blob-install-gaming-lutris` | Install Lutris with Wine + DXVK for running Windows games (Battle.net, EA, Ubisoft Connect, etc.) | - |
| `blob-install-gaming-retroarch` | Install RetroArch with the full libretro core set plus FBNeo and a ~/Games ROM directory. | - |
| `blob-install-gaming-steam` | Install Steam and graphics drivers selected for this system | - |
| `blob-install-gaming-xbox-cloud` | Install Xbox Cloud Gaming as a web app and launch it. | - |
| `blob-install-gaming-xbox-controllers` | Install support for using Xbox controllers with Steam/RetroArch/etc. | - |
| `blob-install-launch` | Install a packaged app and launch it once it finishes | <display-name> <packages> <desktop-id> |

## launch

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-launch-about` | Launch the fastfetch TUI that gives information about the current system. | - |
| `blob-launch-battlenet` | Launch the installed Battle.net client via umu-launcher + GE-Proton. | [--with-mangohud] |
| `blob-launch-browser` | Launch the default browser as determined by xdg-settings. | [url] |
| `blob-launch-config-editor` | Open a config file in the user's editor and surface a toast | <path> |
| `blob-launch-docker-tui` | Open the Docker TUI (lazydocker) with access to the Docker daemon (hidden) | - |
| `blob-launch-editor` | Launch the default editor selected via Blob defaults. | [--inline] <path> |

## launcher

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-launcher-remove` | Remove or uninstall the selected launcher entry (hidden) | <desktop-id> <name> |

## launch

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-launch-floating` | Launch a floating terminal with the Blob presentation wrapper | <command> |
| `blob-launch-or-focus` | Launch an app or focus an existing window matching a pattern | <window-pattern> <launch-command> |
| `blob-launch-or-focus-tui` | Launch a TUI or focus an existing terminal window for it | [--app-id=<app-id>] <command> [args...] |
| `blob-launch-or-focus-webapp` | Launch or focus on a given web app identified by the window-pattern. | <window-pattern> <url-and-flags...> |
| `blob-launch-screensaver` | Launch the Blob screensaver in the default terminal on the system with the correct font configuration. | - |
| `blob-launch-shell` | Launch the Blob shell with its log kept in the journal (hidden) | - |
| `blob-launch-tui` | Launch a TUI command in the default terminal with Blob styling | [--app-id=<app-id>] <command> [args...] |
| `blob-launch-webapp` | Launch a URL as a web app in the default supported browser | <url> |

## menu

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-menu` | Control the Blob menu (toggle / summon / close / refresh) | [toggle\|summon\|close\|refresh\|ping] [route] |
| `blob-menu-emoji` | Launch emojis | - |
| `blob-menu-emoji-insert` | Insert an emoji into the focused application (hidden) | <emoji> |
| `blob-menu-file` | Pick a file from a menu | label paths formats [menu args...] |
| `blob-menu-images` | Open a generic image selector menu | [--selected <image>] [--print-name] [--show-labels] [--filterable] [--lazy-thumbnails] [--preload] [--cache-only] <image-dir>... |
| `blob-menu-keybindings` | Display Hyprland keybindings defined in your configuration using an interactive search menu. | - |
| `blob-menu-plugin` | Pick a shell plugin to enable, disable, clone, or remove | <enable\|disable\|clone\|remove> |
| `blob-menu-select` | Pick one option from a menu | prompt [option...] [-- menu args...] |
| `blob-menu-share` | Share clipboard, files, or folders with LocalSend | <clipboard\|file\|folder> [path...] |
| `blob-menu-timezone` | Select and set the system timezone | - |

## network

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-network-band` | Show or pin the Wi-Fi band for the active connection | [auto\|2.4\|5\|6] |
| `blob-network-dns` | Show or configure the system DNS provider | [Cloudflare\|Google\|DHCP\|Custom] |
| `blob-network-iwd` | - | - |
| `blob-network-password` | Print the active Wi-Fi connection's password | <interface> |
| `blob-network-qr` | Generate a Wi-Fi QR matrix for the shell | [--meta] [interface] |
| `blob-network-restart` | Unblock and restart the Wi-Fi service. | - |
| `blob-network-speedtest` | Measure live internet speed for one direction | [down\|up] |
| `blob-network-status` | Print active network status for the shell | [--verbose] |

## notification

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-notification-battery` | Show the current battery status notification | - |
| `blob-notification-time` | Show the current time and date notification | - |
| `blob-notification-wait` | Wait for the desktop notification server to accept notifications (hidden) | [timeout-seconds] |
| `blob-notification-weather` | Toggle the current weather panel | - |

## notify

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-notify-dismiss` | Dismiss a notification by summary substring. Used by the first-run notifications to dismiss them after clicking for action. | <summary> |
| `blob-notify-send` | Send an Blob desktop notification | [--app-name <app-name>] [-g <glyph>] [-u <low\|normal\|critical>] [-i <icon>] [-t <ms>] [-r <id>] [-p] [--image <path-or-uri>] <headline> [description] [--exec <program> [args...]] |

## osd

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-osd` | Show the Blob Quickshell on-screen display | [-i\|--icon <icon>] [-m\|--message <text>] [-p\|--progress <0-100>] [-d\|--duration <ms>] |

## pkg

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-pkg-add` | Install Arch packages if they are missing | <packages...> |
| `blob-pkg-aur` | Returns true if the AUR is up and available. | - |
| `blob-pkg-aur-add` | Add the named packages to the system from the AUR if they're missing. Returns false if it couldn't be done. | <packages...> |
| `blob-pkg-aur-install` | Show a fuzzy-finder TUI for picking new AUR packages to install. | - |
| `blob-pkg-drop` | Remove all the named packages from the system if they're installed (otherwise ignore). | <packages...> |
| `blob-pkg-install` | Show a fuzzy-finder TUI for picking new Arch and OPR packages to install. | - |
| `blob-pkg-missing` | Returns true if any of the named packages are missing from the system (or false if they're all there). | <packages...> |
| `blob-pkg-present` | Returns true if all of the named packages are installed on the system (or false if any of them are missing). | <packages...> |
| `blob-pkg-remove` | Show a fuzzy-finder TUI for picking packages installed on the system to be removed. | - |

## plugin

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-plugin-add` | Add a shell plugin from git | [git-url] [--enable] [--yes] |
| `blob-plugin-catalog` | Emit every first-party and user plugin manifest as JSON (hidden) | - |
| `blob-plugin-clone` | Clone a built-in Blob shell plugin into your own config | <source-id> [--edit] |
| `blob-plugin-enable` | Enable a shell plugin | <id> [placement] |
| `blob-plugin-list` | List discovered shell plugins | [--json] |
| `blob-plugin-remove` | Remove an installed shell plugin | [id] [--yes] |
| `blob-plugin-validate` | Validate a plugin folder against the Blob plugin manifest schema | <plugin-folder> |

## plymouth

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-plymouth-set` | Set the Plymouth boot theme colors and logo | <background-hex> <text-hex> <path-to-logo.png> |

## power

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-power-list` | Returns a list of all the available power profiles on the system. | [--active-state] |

## powerprofiles

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-powerprofiles-init` | Set the correct power profile on boot based on current AC/battery state. | - |

## power

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-power-set` | Set and remember the power profile for AC or battery use | [autodetect\|ac\|battery] [power-saver\|balanced\|performance] |

## refresh

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-refresh-config` | Copy a shipped user config from $BLOB_PATH/config into ~/.config (backs up your version). | <config-path> |
| `blob-refresh-hyprland` | Overwrite all the user Hyprland Lua configs in ~/.config/hypr with the Blob defaults. | - |
| `blob-refresh-hyprsunset` | Overwrite the user config for hyprsunset with the Blob default and restart the service. | - |
| `blob-refresh-plymouth` | Overwrite the user config for the Plymouth drive decryption and boot sequence with the Blob default and rebuild it. | - |
| `blob-refresh-shell` | Reset shell.json to Blob defaults | - |

## reminder

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-reminder` | Set and show lightweight desktop notification reminders | [-i\|--interactive] \| <minutes> [message] \| show [-j\|--json] \| clear |

## remove

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-remove-browser` | Remove a supported browser and clean up Blob browser defaults | <chrome\|brave\|brave-origin\|edge\|firefox\|zen> |
| `blob-remove-dev-env` | Remove a development environment that was previously installed via blob-install-dev-env. | <ruby\|node\|bun\|deno\|go\|php\|laravel\|symfony\|python\|elixir\|phoenix\|zig\|rust\|java\|dotnet\|ocaml\|clojure\|scala> |
| `blob-remove-gaming-battlenet` | Remove Battle.net, its Proton prefix, installed games, and desktop entry. | - |
| `blob-remove-gaming-geforce-now` | Remove the GeForce NOW Flatpak app and its data. | - |
| `blob-remove-gaming-heroic` | Remove Heroic Games Launcher and its game libraries, configs, and caches. | - |
| `blob-remove-gaming-lutris` | Remove Lutris, Wine, umu-launcher, and all their configs and caches. | - |
| `blob-remove-gaming-minecraft` | Remove the Minecraft launcher along with its worlds, mods, and caches. | - |
| `blob-remove-gaming-retroarch` | Remove RetroArch, all libretro cores, and its config/saves. Leaves ~/Games/roms and ~/Games/bios alone. | - |
| `blob-remove-gaming-steam` | Remove Steam and all of its game libraries, configs, and caches. | - |
| `blob-remove-gaming-xbox-cloud` | Remove the Xbox Cloud Gaming web app. | - |
| `blob-remove-gaming-xbox-controllers` | Remove the xpadneo Xbox controller driver and undo its module/blacklist config. | - |
| `blob-remove-security-fido2` | Remove FIDO2 authentication from sudo and polkit | - |
| `blob-remove-security-sudoless-docker` | Disable sudoless Docker by removing your user from the docker group | - |

## restart

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-restart-app` | Restart an application by killing it and relaunching via uwsm. | <application-name> [application-args...] |
| `blob-restart-btop` | Reload btop configuration (used by the Blob theme switching). | - |
| `blob-restart-gum` | Export the current theme's gum styling into the environment (hidden) | - |
| `blob-restart-hyprsunset` | Restart the hyprsunset service (used for blue light filtering/night light). | - |
| `blob-restart-terminal` | Reload supported terminal emulators after config changes | - |
| `blob-restart-trackpad` | Reset the trackpad by unbinding and rebinding its driver. | - |
| `blob-restart-xcompose` | Restart the XCompose input method service (fcitx5) to apply new compose key settings. | - |

## screensaver

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-screensaver` | Run the Blob screensaver using random effects from TTE. | - |

## secret

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-secret` | - | - |

## setup

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-setup-direct-boot` | Add or remove an EFI boot entry for the Blob UKI, allowing the system to boot directly | - |
| `blob-setup-security-fido2` | Set up FIDO2 authentication for sudo and polkit | - |
| `blob-setup-security-fingerprint` | Set up fingerprint authentication for sudo, polkit, and lock screen | - |
| `blob-setup-security-sshd` | Set up the OpenSSH server, open the firewall, and authorize an SSH key | [--key=<public-key>] |
| `blob-setup-security-sudoless-docker` | Enable sudoless Docker by adding your user to the docker group (root-equivalent!) | - |

## shell

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-shell` | Send an IPC call to the running Blob shell | [-q] <target> <method> [args...] |
| `blob-shell-config` | Shared helpers for editing ~/.config/blob/shell.json (source this, don't run it). (hidden) | - |
| `blob-shell-restart` | Restart the Blob shell | - |

## show

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-show-done` | Display a "Done!" message and wait for user to press any key. | - |
| `blob-show-logo` | Display the Blob logo in the terminal using green color. | - |

## state

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-state` | Manage persistent state files for Blob toggles and settings. (hidden) | <set\|clear> <state-name-or-pattern> |

## sudo

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-sudo-docker` | Succeed when Docker needs sudo, fail when it can be used directly (hidden) | [--configured] |
| `blob-sudo-keepalive` | Prompt for sudo once and keep the credential alive in the background. | - |
| `blob-sudo-passwordless` | Toggle passwordless sudo for the current user. | [MINUTES] |

## system

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-system-lid` | Lock and reconcile displays when the laptop lid closes (hidden) | - |
| `blob-system-lock` | Lock the computer and turn off the display | - |
| `blob-system-logout` | Log out after closing application windows | - |
| `blob-system-reboot` | Reboot after closing application windows | - |
| `blob-system-shutdown` | Shut down after closing application windows | - |
| `blob-system-sleep` | Lock before suspend and wait for the session lock to become secure (hidden) | - |
| `blob-system-sleep-monitor` | Monitor sleep preparation and lock before suspend (hidden) | - |
| `blob-system-stats` | Print CPU and memory stats for the shell | [--bar-widget] |
| `blob-system-wake` | Wake displays and restore brightness after idle | - |

## tablet

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-tablet-follow` | - | - |

## theme

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-theme-browser` | Apply the current theme color to Chromium, Chrome, Edge, and Brave (hidden) | - |
| `blob-theme-browser-policy` | Write the current theme color into the browser policy directories (hidden) | <rrggbb> |
| `blob-theme-color` | Resolve semantic colors from an Blob theme colors.toml (hidden) | [--file <colors.toml>] (--all \| --raw \| <key> [fallback]) |
| `blob-theme-contrast` | - | - |
| `blob-theme-current` | Show current theme | - |
| `blob-theme-dir` | Print the directory holding a theme, preferring a user-installed copy | <theme-name> |
| `blob-theme-dynamic` | Apply the pywal-generated theme built from the current wallpaper | - |
| `blob-theme-extras` | List the user-installed themes that came from a git clone | - |
| `blob-theme-foot` | Apply current Blob theme colors to running Foot terminals (hidden) | - |
| `blob-theme-import` | Generate a theme's colors.toml from its alacritty.toml palette (hidden) | <theme-dir> |
| `blob-theme-install` | Install a theme from a git repository | [git-repo-url] |
| `blob-theme-list` | List available themes | - |
| `blob-theme-menu` | Pick a color theme from the local and bundled sets | [--mode\|--print] |
| `blob-theme-osc` | Print OSC sequences for an Blob color theme (hidden) | - |
| `blob-theme-refresh` | Refresh the current theme from its templates. | - |
| `blob-theme-remove` | Remove a user-installed theme | [theme-name] |
| `blob-theme-set` | Apply an Blob theme | <theme-name> |
| `blob-theme-share` | Fetch a shared theme by link or id and apply it as blob-dynamic | <share-link-or-id> |
| `blob-theme-switcher` | Open the Blob theme switcher | - |
| `blob-theme-templates` | Generate themed config files from Blob templates (hidden) | - |
| `blob-theme-update` | Update user-installed git themes | - |

## toggle

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-toggle` | Toggle Blob features between enabled and disabled | <flag-name> [toggle\|on\|off] |
| `blob-toggle-bar` | Toggle bar visibility without killing the Blob shell | [toggle\|on\|off] |
| `blob-toggle-crash-capture` | Toggle crash capture notifications | - |
| `blob-toggle-enabled` | Check if a toggle is enabled (flag file exists) | <flag-name> |
| `blob-toggle-glass` | - | - |
| `blob-toggle-hybrid-gpu` | Toggle dedicated vs integrated GPU mode via supergfxd (for hybrid gpu laptops, like Asus G14). | - |
| `blob-toggle-idle` | Toggle idle behavior so the system either idles normally or stays awake | [toggle\|stay-awake\|allow-idle\|status] |
| `blob-toggle-input` | Enable, disable, or toggle a Hyprland input device (hidden) | <touchpad\|touchscreen> [on\|off\|toggle] |
| `blob-toggle-nightlight` | Toggle nightlight screen temperature | [--status] |
| `blob-toggle-screensaver` | Toggle screensaver availability | - |
| `blob-toggle-silencing` | Toggle notification do-not-disturb mode | - |
| `blob-toggle-tablet` | - | - |
| `blob-toggle-touchpad` | Enable, disable, or toggle the touchpad | [on\|off\|toggle] |
| `blob-toggle-touchscreen` | Enable, disable, or toggle the touch functionality of the screen | [on\|off\|toggle] |

## transcode

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-transcode` | Transcode pictures and videos for sharing | [--path path] [input] [format] [resolution] |
| `blob-transcode-ascii` | Transcode an image into ASCII/Unicode art text | <input-image.svg\|png> <output-path> [--width <columns>] [--height <rows>] [--mode <braille\|block>] [--threshold <percent>] [--invert] |

## tui

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-tui-install` | Create a desktop launcher for a terminal UI app | [name command window-style icon-url-or-name] |
| `blob-tui-remove` | Remove a terminal UI desktop launcher | [name] |
| `blob-tui-remove-all` | Remove all TUIs installed via blob-tui-install. | - |

## update

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-update` | Update system and AUR packages | [--no-confirm] |
| `blob-update-available` | Print the number of pending package updates (hidden) | - |
| `blob-update-firmware` | Update system firmware using fwupd. Ensures the fwupd EFI binary is installed | - |
| `blob-update-time` | Restart system time synchronization | - |

## wallpaper

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-wallpaper-set` | Set a wallpaper from ~/wallpapers and recolor the desktop from it | [--menu\|<file>] |

## weather

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-weather-card` | Print a one-line weather summary for the quick settings card (hidden) | - |
| `blob-weather-icon` | Returns a weather condition icon, adjusted for live sunrise and sunset. | - |
| `blob-weather-location` | Show or set the location used for weather reports | - |
| `blob-weather-status` | Returns a formatted weather status string with temperature and wind speed. | - |

## webapp

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-webapp-handler-hey` | Open HEY webmail and translate mailto links | [url] |
| `blob-webapp-handler-zoom` | Open Zoom web meetings from browser protocol links | [url] |
| `blob-webapp-install` | Create a desktop launcher for a web app | [name url icon-url-or-name [custom-exec] [mime-types]] |
| `blob-webapp-remove` | Remove a web app desktop launcher | [name] |

## windows

| Command | Does | Arguments |
| --- | --- | --- |
| `blob-windows-vm` | Install, launch, stop, inspect, or remove the Windows VM | <install\|remove\|launch\|stop\|status> [options] |

## Totals

290 commands.