|
|
|
@@ -0,0 +1,559 @@
|
|
|
|
|
# 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> |
|
|
|
|
|
|
|
|
|
|
## 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> |
|
|
|
|
|
|
|
|
|
|
## 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-font` | Install a Nerd Font package and switch the system to it | <display-name> <package> <family> |
|
|
|
|
|
| `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-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-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...] |
|
|
|
|
|
|
|
|
|
|
## 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-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-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. | - |
|
|
|
|
|
|
|
|
|
|
## Totals
|
|
|
|
|
|
|
|
|
|
252 commands.
|
