NIRI-IPCEXT(1)

📦 version 5.0.0, in ubuntu stonking

💖 NIRI-IPCEXT 💖

okay bestie, so this is a page from the niri-companion manual, and it's literally the cutest lil' config-tweaking tool you've ever met. it's niri-ipcext — the niri-companion IPC-like configuration tool. yes you read that right, IPC-like. periodt. 💅

✨ SYNOPSIS ✨

niri-ipcext [OPTIONS] COMMAND [ARGS]...

🦋 DESCRIPTION 🦋

so here's the tea: niri-ipcext simulates IPC behavior by directly modifying the niri configuration file. not me, not your other bestie — it literally goes in and edits the file itself. 😭

which means it's so useful for making temporary visual changes (like borders or gaps, the fun stuff 🌸) without manually editing files. no opening a text editor at 3am, no panicking over whether you broke something. iconic behavior honestly.

🎀 OPTIONS 🎀

  • -h, --help — Show help message and exit. that's it, that's the whole list. go off king 👑

👑 COMMANDS 👑

💜 replace OLD NEW 💜

Surgically replaces a string in the config file.

surgically — yes, like a lil' scalpel, no cap. precision girlboss energy.

  • OLD — The exact text to find. Must match spaces and indentation perfectly. like, perfectly perfectly. if your indentation is off by one single space it will not find it and you will be sad. keep that in mind bestie 🙈
  • NEW — The replacement text. the glow-up. the before-and-after. ✨

🌈 restore 🌈

Wipes manual changes and restores the config to its base state by running niri-genconfig generate.

so this is the big reset button. all your lil' temporary chaos? gone. it wipes those manual changes and puts the config back to its base state, and the way it does that is by running niri-genconfig generate. factory reset but make it fashion 💅

🍓 EXAMPLES 🍓

changing border width from 2 to 10:

> niri-ipcext replace `width 2' `width 10'

resetting all temporary changes:

> niri-ipcext restore

see? easy. ate that fr fr 🔥

🧚 NOTES 🧚

okay important note, bestie — this tool modifies the file defined in general.output_path. that's the one it touches. 💖

and here's the slay part: because niri reloads its config when the file is touched, your changes take effect immediately. no restart, no waiting, no "did it work?" — it just works. highkey the best part of the whole vibe check. ⭐

🌸 SEE ALSO 🌸

k byeee, this has been niri-ipcext — page 4.0.1, from May 2026 🫶 go touch some config files (carefully, with the right indentation) mwah 💋

📦 where this page comes from