NVIM-QT(1)

💖 NAME 💖

nvim-qt — the Neovim GUI, bestie. like, Neovim but make it ✨graphical✨

---

🌸 SYNOPSIS 🌸

nvim-qt [options] [file...] [-- nvim_args]

okay so that's the whole vibe right there: options first, then the files you wanna edit, and then optionally a lil -- moment where everything after it gets yeeted straight to Neovim. slay.

---

👑 OPTIONS 👑

one bullet per flag, no skips, no cap. every single one is here because you deserve the full menu 🫶

• --nvim <nvim_path> — tells it where your nvim executable actually lives. like, the path to it. that's it, that's the flag.
• --timeout <ms> — throws an error if nvim just... doesn't respond after count milliseconds. a whole patience timer. iconic honestly.
• --geometry <width>x<height> — sets the initial window geometry. so like, how big the window is when it first pops up ✨
• --stylesheet <stylesheet> — applies a qss stylesheet from a file. glow-up via stylesheet, periodt.
• --maximized — window starts out maximized. full send on the screen real estate.
• --fullscreen — opens the window in fullscreen on startup. main character energy, edge to edge 💅
• --embed — communicates with Neovim over stdin/out. it's giving embedded.
• --server <addr> — connects to an existing Neovim instance. no new one, just sliding into the one that's already there 🦋
• --spawn — treats the positional arguments as the nvim argv. (so your files/args go to nvim, not to the GUI wrapper. iykyk)
• -v, --version — displays version information. classic.
• -h, --help — displays help on commandline options. the og "what do i even do" button.
• --help-all — displays help including Qt specific options. the deluxe version, more options than the regular help, because Qt has opinions.
• --nofork — runs in the foreground. no backgrounding, it stays right there with you 🫂

🍓 Arguments: 🍓

• file — edit specified file(s). yes plural, you can pass more than one, go off.
• -- [nvim_args] — additional arguments are forwarded to Neovim. the example is literally right there and it's a good one:

nvim-qt -- -u NONE

⚠️ heads up bestie: everything after that -- is Neovim's business, not the GUI's. so don't be shocked when your GUI flags stop working past that point. that's the whole point of the --. 💀

---

💜 SEE ALSO 💜

there's no SEE ALSO section in this page, so consider this your honorary one: go read the Neovim docs, they're right there, you got this 🌈

---

and that's the whole page!! 💖 this is nvim-qt version 0.2.19, dated February 2025, and it lives in the User Commands corner of your man pages. go open a window and edit something gorgeous, bestie 🎀🦋✨