Samuel Onoja
eb84104940
Publish the guides from this repository to the GitHub Wiki. Organize them into Usage, Configuration and Development, with 15 separate configuration topics and redirects for the former website guide URLs. Add a tabbed-windows guide covering grouping, switching tabs and taking windows out. Document the scrolling indicator's defaults and limits, and link the guide from the README, shortcuts and IPC pages. Update from main, including the latest tabbed-layout changes. Separate Activities setup, configuration and publishing documentation. Review the guide prose with the unslop skill, keeping existing examples and heading links. The wiki workflow uses GitHub's built-in token to publish documentation changes on main. Validation: - 20 documentation tests pass, including README links and Activities/tab-indicator field coverage. - The publisher builds 46 wiki pages; the site build and Python syntax checks pass. - All 115 code examples from main are preserved. - The Python suite passes: 90 tests passed and 31 opt-in integration tests skipped, with the system GI module available.
43 lines
1.8 KiB
Markdown
43 lines
1.8 KiB
Markdown
# Idle inhibition
|
|
|
|
Ferese keeps the session awake during fullscreen playback when an application
|
|
reports `Playing` through MPRIS. Pausing or stopping playback releases this
|
|
automatic inhibition. A window must have content visible on an awake display;
|
|
switching away, closing it, locking the session or sleeping its display releases
|
|
inhibition too.
|
|
|
|
Disable the default fullscreen playback policy with:
|
|
|
|
```kdl
|
|
idle-inhibit {
|
|
fullscreen-playback #false
|
|
}
|
|
```
|
|
|
|
Use window rules for presentations, games or other apps that should keep the
|
|
session awake while visible:
|
|
|
|
```kdl
|
|
window-rule app-id="org.example.Presentation" idle-inhibit="visible"
|
|
```
|
|
|
|
| `idle-inhibit` rule | Behavior |
|
|
| --- | --- |
|
|
| `visible` | Inhibit while visible, regardless of playback state |
|
|
| `fullscreen` | Inhibit while visible and fullscreen |
|
|
| `playing` | Inhibit while visible and its MPRIS player reports `Playing` |
|
|
| `fullscreen-playing` | Inhibit while visible, fullscreen and its MPRIS player reports `Playing` |
|
|
| `none` | Disable automatic inhibition for this window |
|
|
|
|
MPRIS identifies an application, not an individual video window. Ferese matches
|
|
the player's process ID first, then its `DesktopEntry` against the window's app
|
|
ID. If several windows match, automatic playback inhibition stays off. MPRIS
|
|
also does not distinguish audio from video, so fullscreen audio playback can
|
|
inhibit too. Players without MPRIS can request inhibition through the existing
|
|
Wayland or portal protocols; a fullscreen window alone does not prove playback.
|
|
|
|
These settings control automatic inhibition. They do not override an
|
|
application's own Wayland or portal request, and they do not block manual
|
|
locking or suspend. Run `feresectl idle-inhibition` to inspect the current
|
|
inhibition state and discovered players. Changes take effect on config reload.
|