.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "oniri" "1" "2026\-10\-18" "Oniri 1.3.8" "Oniri Manual"
.PP
.SH NAME
.PP
\fBOniri\fR \- A tool that automatically maximizes the only window of a niri workspace.\&
.PP
.SH DESCRIPTION
.PP
Oniri is a tool that automatically maximizes the \fBon\fRly window of a \fBniri\fR 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 \fBOPTIONS\fR below).\&
.PP
.SH SYNOPSIS
.PP
\fBoniri\fR [OPTIONS]
.PP
.SH OPTIONS
.PP
\fB\-F, \-\-first\-only\fR
.RS 4
Only maximize the first window opened, do no act on the last remaining one.\&
.PP
.RE
\fB\-T, \-\-tiling\-layout\fR
.RS 4
Unmaximize the first window when opening a second one, like in a tiling compositor.\&
.PP
.RE
\fB\-E, \-\-edges\-maximizing\fR
.RS 4
Maximize windows to edges.\&
.PP
.RE
\fB\-R, \-\-reclaim\-space\fR
.RS 4
Reclaim empty screen space left by closed windows.\&
.PP
.RE
\fB\-H, \-\-height\-tolerance\fR <number>
.RS 4
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.\&
.PP
.RE
\fB\-W, \-\-width\-tolerance\fR <number>
.RS 4
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.\&
.PP
.RE
\fB\-h, \-\-help\fR
.RS 4
Display the help message.\&
.PP
.RE
\fB\-V, \-\-version\fR
.RS 4
Display version information.\&
.PP
.RE
.SH EXIT STATUS
.PP
\fB0\fR Ok.\&
.PP
\fB1\fR Failed to create or acquire the lockfile.\&
.PP
\fB2\fR Failed to initialize niri IPC socket connections.\&
.PP
\fB3\fR Failed to initialize the output(s) map.\&
.PP
\fB4\fR Failed to initialize the window(s) / workspace(s) map.\&
.PP
\fB5\fR Failed to read events from the niri IPC.\&
.PP
.SH SEE ALSO
.PP
https://niri\-wm.\&github.\&io/niri
.PP
https://crates.\&io/crates/niri\-ipc
.PP
.SH BUGS
.PP
Please report bugs to the GitHub page: https://github.\&com/Antiz96/oniri
.PP
.SH AUTHOR
.PP
Robin Candau <robincandau@mailbox.\&org>