AlexandClaude Opus 4.8
f72f84e011
Post-0.15.0 review of the 0.15.0..HEAD range surfaced regressions and
bugs. This restores backward compatibility for existing configs/CSS,
fixes confirmed defects, and repairs the scdoc man-page build break on
master. Pango-markup tooltips are intentional and were kept.
Backward-compat restorations:
- AModule: honor legacy numeric Gdk::CursorType cursor values (int overload)
- memory: correct GiB divisor (was ~2.3% low); round bare {} placeholders
- wireplumber: scale max-volume into the linear domain so the cap works again
- idle_inhibitor: gate right/middle-click deactivate & scroll on dynamic-timeouts;
accept both dynamic-timeout(s); widen timeout to double (no fractional truncation)
- custom: keep #custom-<name>.<class> CSS selectors working (classes on box_)
- image: don't wordexp-split a single path; fall back to the literal path
- niri/window: restore hide-when-empty (new show-empty opt-in); escape tooltip
- wlr/taskbar: plain-text tooltip when markup is disabled
Bug fixes:
- tray: fix use-after-free in onAdd; guard the watcher retry timeout
- hyprland: clamp max-windows iterator (OOB); drop duplicate language tooltip block
- niri/window: supply {col}/{max_col} args in the empty branch (fmt::format_error)
- mpris: escape {dynamic}/{player} tooltip; fix dangling player; albumArtist source
- mango: fix use-after-free race (dispatch under callback_mutex_)
- mpd: contain throwing checkErrors in noexcept idle paths (no std::terminate/UAF)
- keyboard_state: always render every lock label, with guarded defaults
- bluetooth: bound GATT ReadValue timeout, opt-in + services-resolved gating,
preserve authoritative Battery1 percentage
- wireplumber: fix WpDevice reference leak / NULL handling
- battery, clock, dwl, wayfire, graph, custom_graph, transform, river: assorted
crash/logic fixes
Man page / build:
- niri-workspaces: fix scdoc "indented by an amount greater than 1"
(workspace-taskbar sub-options were mis-indented; breaks man-page build)
- document new show-empty (niri/window); correct network {txBitrate}/{rxBitrate}
Not compiled locally (no gtkmm on this host); C++ build relies on CI.
Man pages validated with scdoc 1.11.4.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
203 lines
4.8 KiB
Scdoc
203 lines
4.8 KiB
Scdoc
waybar-idle-inhibitor(5)
|
|
|
|
# NAME
|
|
|
|
waybar - idle_inhibitor module
|
|
|
|
# DESCRIPTION
|
|
|
|
The *idle_inhibitor* module can inhibit the idle behavior such as screen blanking, locking, and
|
|
screensaver, also known as "presentation mode".
|
|
|
|
# CONFIGURATION
|
|
|
|
*format*: ++
|
|
typeof: string ++
|
|
The format, how the state should be displayed.
|
|
|
|
*format-icons*: ++
|
|
typeof: array ++
|
|
Based on the current state, the corresponding icon gets selected.
|
|
|
|
*rotate*: ++
|
|
typeof: integer ++
|
|
Positive value to rotate the text label (in 90 degree increments).
|
|
|
|
*max-length*: ++
|
|
typeof: integer ++
|
|
The maximum length in character the module should display.
|
|
|
|
*min-length*: ++
|
|
typeof: integer ++
|
|
The minimum length in characters the module should accept.
|
|
|
|
*align*: ++
|
|
typeof: float ++
|
|
The alignment of the label within the module, where 0 is left-aligned and 1 is right-aligned. If the module is rotated, it will follow the flow of the text.
|
|
|
|
*justify*: ++
|
|
typeof: string ++
|
|
The alignment of the text within the module's label, allowing options 'left', 'right', or 'center' to define the positioning.
|
|
|
|
*on-click*: ++
|
|
typeof: string ++
|
|
Command to execute when clicked on the module. A click also toggles the state (enable only if dynamic timeouts are enabled).
|
|
|
|
*on-click-middle*: ++
|
|
typeof: string ++
|
|
Command to execute when middle-clicked on the module using mousewheel. (reset the timeout to the initial value if dynamic timeouts are enabled).
|
|
|
|
*on-click-right*: ++
|
|
typeof: string ++
|
|
Command to execute when you right-click on the module. (deactivate the inhibit if dynamic timeouts are enabled).
|
|
|
|
*on-update*: ++
|
|
typeof: string ++
|
|
Command to execute when the module is updated.
|
|
|
|
*on-scroll-up*: ++
|
|
typeof: string ++
|
|
Command to execute when scrolling up on the module. (increase the timeout if dynamic timeouts are enabled).
|
|
|
|
*on-scroll-down*: ++
|
|
typeof: string ++
|
|
Command to execute when scrolling down on the module. (decrease the timeout if dynamic timeouts are enabled).
|
|
|
|
*smooth-scrolling-threshold*: ++
|
|
typeof: double ++
|
|
Threshold to be used when scrolling.
|
|
|
|
*start-activated*: ++
|
|
typeof: bool ++
|
|
default: *false* ++
|
|
Whether the inhibit should be activated when starting waybar.
|
|
|
|
*timeout*: ++
|
|
typeof: double ++
|
|
The number of minutes the inhibition should last.
|
|
|
|
*timeout-step*: ++
|
|
typeof: double ++
|
|
default: 10 ++
|
|
The number of minutes to add or subtract when scrolling (when dynamic timeouts are enabled).
|
|
|
|
*dynamic-timeouts*: ++
|
|
typeof: bool ++
|
|
default: false ++
|
|
Option to enable dynamic timeouts.
|
|
|
|
*wait-for-activity*: ++
|
|
typeof: bool ++
|
|
default: *false* ++
|
|
When enabled, the idle inhibitor remains active as long as there is keyboard or mouse activity on the bar. If there is no activity for the duration specified in *timeout*, the inhibitor will automatically toggle off. This option requires *timeout* to be set.
|
|
|
|
*signal*: ++
|
|
typeof: integer ++
|
|
The signal number used to toggle the idle inhibitor externally. ++
|
|
The number is valid between 1 and N, where *SIGRTMIN+N* = *SIGRTMAX*. ++
|
|
Use `pkill -SIGRTMIN+N waybar` to toggle the idle inhibitor from scripts or keybindings.
|
|
|
|
*tooltip*: ++
|
|
typeof: bool ++
|
|
default: true ++
|
|
Option to disable tooltip on hover.
|
|
|
|
*tooltip-format-activated*: ++
|
|
typeof: string ++
|
|
This format is used when the inhibit is activated.
|
|
|
|
*tooltip-format-deactivated*: ++
|
|
typeof: string ++
|
|
This format is used when the inhibit is deactivated.
|
|
|
|
*menu*: ++
|
|
typeof: string ++
|
|
Action that popups the menu. Cannot be "on-click".
|
|
|
|
*menu-file*: ++
|
|
typeof: string ++
|
|
Location of the menu descriptor file. There need to be an element of type
|
|
GtkMenu with id *menu*
|
|
|
|
*menu-actions*: ++
|
|
typeof: array ++
|
|
The actions corresponding to the buttons of the menu.
|
|
|
|
*expand*: ++
|
|
typeof: bool ++
|
|
default: false ++
|
|
Enables this module to consume all left over space dynamically.
|
|
|
|
# FORMAT REPLACEMENTS
|
|
|
|
*{status}*: status (*activated* or *deactivated*)
|
|
|
|
*{icon}*: Icon, as defined in *format-icons*
|
|
|
|
*{timeout}*: Timeout in minutes
|
|
|
|
*{timeleft}*: Time left in minutes
|
|
|
|
# EXAMPLES
|
|
|
|
Basic usage with timeout:
|
|
|
|
```
|
|
"idle_inhibitor": {
|
|
"format": "{icon}",
|
|
"format-icons": {
|
|
"activated": "",
|
|
"deactivated": ""
|
|
},
|
|
"timeout": 30.5
|
|
}
|
|
```
|
|
|
|
With dynamic timeouts (scroll to adjust the timeout):
|
|
|
|
```
|
|
"idle_inhibitor": {
|
|
"format": "{status} {timeleft}/{timeout}",
|
|
"format-icons": {
|
|
"activated": "",
|
|
"deactivated": ""
|
|
},
|
|
"timeout": 480,
|
|
"dynamic-timeouts": true,
|
|
"timeout-step": 10
|
|
}
|
|
```
|
|
|
|
With external control via signals (can be toggled with `pkill -SIGRTMIN+8 waybar`):
|
|
|
|
```
|
|
"idle_inhibitor": {
|
|
"format": "{icon}",
|
|
"format-icons": {
|
|
"activated": "",
|
|
"deactivated": ""
|
|
},
|
|
"signal": 8
|
|
}
|
|
```
|
|
|
|
With wait-for-activity feature:
|
|
|
|
```
|
|
"idle_inhibitor": {
|
|
"format": "{icon}",
|
|
"format-icons": {
|
|
"activated": "",
|
|
"deactivated": ""
|
|
},
|
|
"timeout": 5.0,
|
|
"wait-for-activity": true
|
|
}
|
|
```
|
|
|
|
# STYLE
|
|
|
|
- *#idle_inhibitor*
|
|
- *#idle_inhibitor.activated*
|
|
- *#idle_inhibitor.deactivated*
|