Flags
Complete CLI reference for sss — every flag, type, and default.
Capture targeting
| Flag | Type | Default | Description |
|---|
--current | bool | false | Capture the monitor under the cursor right now. |
--show-cursor | bool | false | Composite the mouse cursor into the frame. |
--screen | bool | false | Open the monitor selector (or capture current with --current). |
--screen-id <id> | name/id | — | Pick a screen directly. Omit value to open the picker. |
--area <spec> | "X,Y WxH" | — | Pick an area. Omit value to open the interactive selector. |
--window <spec> | id/title | — | Pick a window by id or title substring. Omit value to open the picker. |
--interactive | bool | false | Force the interactive selector even when a target was specified. |
Annotation overlay
| Flag | Type | Default | Description |
|---|
--no-toolbar | bool | false | Hide the annotation toolbar (slurp-mode behaviour). |
--remember-last-selection | bool | false | Persist the last selected area and pre-seed it on next run. |
Backend selection
| Flag | Type | Default | Description |
|---|
--capture-backend | enum | auto | One of auto, wayland, portal, x11, windows, macos. |
OCR
| Flag | Type | Default | Description |
|---|
--ocr | bool | true | Enable or disable the OCR overlay. |
--ocr-gpu | enum | auto | OCR execution provider: auto, cpu, cuda, tensorrt, coreml, directml, openvino, webgpu. |
Misc
| Flag | Type | Default | Description |
|---|
--verbose / -v | bool | false | Bump log level to info. |
--config <path> | path | XDG | Override the default config file location. |
Use sss --help for the version bundled with your binary. Flags are stable within a minor release.