oniri(1) Oniri Manual oniri(1)

Oniri - A tool that automatically maximizes the only window of a niri workspace.

Oniri is a tool that automatically maximizes the only window of a niri workspace, whether it's the first one opened or the last remaining one after all the other windows got closed (this behavior is configurable, see OPTIONS below).

oniri [OPTIONS]

-F, --first-only

Only maximize the first window opened, do no act on the last remaining one.

-T, --tiling-layout

Unmaximize the first window when opening a second one, like in a tiling compositor.

-E, --edges-maximizing

Maximize windows to edges.

-R, --reclaim-space

Reclaim empty screen space left by closed windows.

-H, --height-tolerance <number>

Set the height size tolerance (in pixels) when comparing the window size to the output size to determine if the window is maximized or not (https://github.com/Antiz96/oniri/issues/3). Defaults to 150.

-W, --width-tolerance <number>

Set the width size tolerance (in pixels) when comparing the window size to the output size to determine if the window is maximized or not (https://github.com/Antiz96/oniri/issues/3). Defaults to 150.

-h, --help

Display the help message.

-V, --version

Display version information.

0 Ok.

1 Failed to create or acquire the lockfile.

2 Failed to initialize niri IPC socket connections.

3 Failed to initialize the output(s) map.

4 Failed to initialize the window(s) / workspace(s) map.

5 Failed to read events from the niri IPC.

https://niri-wm.github.io/niri

https://crates.io/crates/niri-ipc

Please report bugs to the GitHub page: https://github.com/Antiz96/oniri

Robin Candau <robincandau@mailbox.org>

2026-10-18 Oniri 1.3.8