About
iio-lock
iio-lock provides orientation controls for 2-in-1 devices, allowing automatic screen rotation to be locked and manual output transforms to be selected.
Plugin
| Field | Value |
|---|---|
| ID | nikolaj-zwergius/iio_lock |
| Entries | Bar widgets: iio-lock, lock-panel; panel: panel; shortcut: toggle; service: iio-service |
Requirements
The plugin supports Hyprland with iio-hyprland and hyprctl. Sway support
uses iio-sway and swaymsg and is currently experimental. The helper
commands pgrep and pkill must also be available on PATH.
Usage
Add the iio-lock widget to toggle the orientation lock with a left click and
open the transform panel with a right click. The lock-panel widget opens the
transform panel with a left click. You can also add the toggle shortcut under
Settings → Control Center shortcuts.
Open the transform panel directly with:
noctalia msg panel-toggle nikolaj-zwergius/iio_lock:panel
Locking stops the configured IIO rotation helper; unlocking starts it again. The panel applies the selected transform to the chosen output.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
iio |
select |
iio-hyprland |
Automatic rotation helper to start and stop. |
transform-order |
string |
0,1,2,3 |
Transform values shown by the panel, in order. |
vm |
select |
hyprland |
Selects the Hyprland or Sway command backend. |
locked |
glyph |
lock |
Glyph used while orientation is locked. |
unlocked |
glyph |
lock-open-2 |
Glyph used while orientation is unlocked. |
Notes
Hyprland is the tested backend. Verify the configured rotation helper works on its own before using the plugin, especially on Sway and similar compositors.
Versions
| Version | Plugin API | Updated |
|---|---|---|
| v1.0.0 latest | 3 | Jul 15, 2026 |
Older versions stay installable on a Noctalia release whose plugin API is below the latest version's.