oniri(1)

📦 version 1.3.10, in arch rolling

💖 oniri(1) 💖

okay so bestie, welcome to the oniri(1) manual — this is the page for Oniri, the tool that's literally about to make your niri workspace life SO much easier, no cap ✨

🌸 NAME 🌸

Oniri — a tool that automatically maximizes the only window of a niri workspace. that's it, that's the whole vibe 💅

🦋 DESCRIPTION 🦋

okay so picture this: Oniri is a tool that automatically maximizes the only window of a niri workspace. and when I say "the only window" I mean it handles both cases — whether it's the first one opened, or the last remaining one after all the other windows got closed. the way it just knows?? iconic. 🎀

but lowkey, that last-window behavior is configurable — see OPTIONS below, iykyk 👑

✨ SYNOPSIS ✨

oniri [OPTIONS]

💜 OPTIONS 💜

  • -F, --first-only — only maximize the first window opened, and like, do nothing to the last remaining one. simple. restrained. we respect it 🫶
  • -T, --tiling-layout — unmaximize the first window when you open a second one, just like a tiling compositor would. yes bestie, it's giving tiling energy fr fr 🔥
  • -E, --edges-maximizing — maximize windows to the edges. maximize, but make it edge-to-edge 🌈
  • -R, --reclaim-space — reclaim that empty screen space left behind by closed windows. not the wasted pixels 😭 Oniri's got you, it'll scoop that space right back up 🍓
  • -H, --height-tolerance <number> — set the height size tolerance (in pixels) used when comparing the window size to the output size, to figure out if the window is maximized or not (https://github.com/Antiz96/oniri/issues/3). defaults to 150. the tolerance is for the height, bestie, don't mix it up 🧚
  • -W, --width-tolerance <number> — set the width size tolerance (in pixels) used when comparing the window size to the output size, to figure out if the window is maximized or not (https://github.com/Antiz96/oniri/issues/3). defaults to 150. same energy, but for the width 💫
  • -h, --help — display the help message. the classic. the icon 👑
  • -V, --version — display version information. know your version, love your version ⭐

🌟 EXIT STATUS 🌟

so here's the tea on exit codes, because we love a status that tells us what went down:

  • 0 — Ok. we slayed, everything worked 💚
  • 1 — Failed to create or acquire the lockfile. the lockfile said "no thanks" 😭
  • 2 — Failed to initialize niri IPC socket connections. the sockets were not socketing 🙈
  • 3 — Failed to initialize the output(s) map. the output map refused to map 🎀
  • 4 — Failed to initialize the window(s) / workspace(s) map. windows and workspaces said "not today" 💀
  • 5 — Failed to read events from the niri IPC. couldn't hear a single event, tragic fr fr 🦋

🔗 SEE ALSO 🔗

go read up, bestie, knowledge is power 💅

🐛 BUGS 🐛

found a bug? don't suffer in silence — please report bugs to the GitHub page: https://github.com/Antiz96/oniri. we'll fix it together, team effort 🫶

👑 AUTHOR 👑

Robin Candau <robincandau@mailbox.org> — the main character who made this happen 💜

and that's a wrap, bestie! this was Oniri 1.3.10, dated 2026-10-25, and it's the oniri(1) manual. go maximize those windows, you've got this 🌈✨🦋

📦 where this page comes from