---
name: "oniri"
section: "1"
platform: "linux"
package: "oniri"
version: "1.3.10-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/oniri"
---

# oniri(1)

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

## NAME

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

## DESCRIPTION

Oniri is a tool that automatically maximizes the **on**ly 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).

## SYNOPSIS

**oniri** \[OPTIONS\]

## 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.

## EXIT STATUS

**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.

## SEE ALSO

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

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

## BUGS

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

## AUTHOR

Robin Candau \<robincandau@mailbox.org\>