gvnccapture(1)

📦
version 1.5.0 · 12 versions
, in alpine 3.24

💅 gvnccapture(1) — the VNC screenshot takerrr

okay so bestie, you know how you're staring at a remote desktop and you're like "omg I need a pic of this"? That's literally this whole tool. It lives in the VNC Tools family, and it's the glow-up your screenshot game deserved. ✨

🦋 NAME

gvnccapture — VNC screenshot capture. That's it, that's the vibe. 🎀

🌸 SYNOPSIS

gvnccapture [OPTION]... [HOST][:DISPLAY] FILENAME

💖 DESCRIPTION

So here's the deal: this bad boy captures a screenshot of the VNC desktop at HOST:DISPLAY and saves it to the image file FILENAME. Iconic behavior, honestly. 💅

And because the defaults are lowkey generous:

  • If HOST is omitted, it defaults to "localhost".
  • If :DISPLAY is omitted, it defaults to ":1".
  • FILENAME must end in a known image format extension (eg .png, .jpeg). No cap, it will not accept your weird made-up extension. 🙈

Supported options are… drumroll please 🥁

  • --help, -? — Display command line help information. Your little "what does this do again" bestie. 💖
  • --quiet, -q — Do not display information on the console when capturing the screenshot, with the exception of any password prompt. So it goes all stealth mode 🥷 — but the password prompt still shows up, because obviously you need to actually get in. 🔑
  • --debug, -d — Display verbose debugging information on the console. For when you're in your detective era and need to know everything. 🔍✨

💀 EXIT STATUS

The exit status is 0 upon successful screen capture, otherwise it is a non-zero integer. So like, 0 = slay, non-zero = something went wrong, check yourself bestie. 😭

🔥 EXAMPLES

# gvnccapture localhost:1 desktop.png
Password:
Connected to localhost:1
Saved display to desktop.png

Look at that. Clean. Gorgeous. It asked for the password, connected to localhost:1, and saved the display to desktop.png. Main character energy fr fr. 👑

👑 AUTHORS

Daniel P. Berrange <dan@berrange.com> — the legend themselves. 🫶

Copyright (C) 2010 Daniel P. Berrange <dan@berrange.com>.

License LGPLv2+: GNU Lesser GPL version 2 or later <http://gnu.org/licenses/gpl.html>.

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

⚠️ okay so read that last bit again — NO WARRANTY. Like, none. Zero. Nada. Don't come for anyone if it acts up, that's the deal you agreed to. 💀

🍓 SEE ALSO

that's the whole page bestie, you're officially a VNC screenshot expert now 💜

mwah 💋 — this was gtk-vnc-1.5.0, dated 2025-07-05, from the gvnccapture(1) manual. catch you in the next one! 🎀✨

📦 where this page comes from