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
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
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 | reset | defaults | position <top|bottom|left|right> | transparent <true|false|toggle> | put [placement] | move [placement] | set [--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)
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-monitor	Assign a wallpaper to one monitor, leaving the others alone	<--list|--clear-all| | --clear>
blob-bg-next	Cycle to the next background for the current theme	-
blob-bg-set	Set the current background image
blob-bg-switcher	Open the Blob background switcher	-

bluetooth

Command	Does	Arguments
blob-bluetooth-device	Control a Bluetooth device	[pair|connect|disconnect|forget]
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.	[+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=] [--webcam-size=<small|medium|large>] [--resolution=] [--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=]
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]
blob-clipboard-open	Open a clipboard history entry (hidden)	--history-index
blob-clipboard-text	Copy text to the clipboard and type or paste it (hidden)	[--shift-insert] [--copy-only] [--history-index |]

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-arrange	Apply a monitor layout at runtime without touching monitors.lua	<list|apply ...|reset>
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
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