skills.rest
agentydragon
agentydragonCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

hetzner_vnc_screenshot

Fetch Hetzner Cloud VNC credentials and capture console screenshots as PNG images.

4|1|Updated May 19, 2025
Search Tags:#automation#hetzner#screenshot#websocket#vnc#cloud-console#infra-debugging
One-click install
npx skills add https://github.com/agentydragon/ducktape --skill hetzner-vnc-screenshot
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hetzner_vnc_screenshot
Source: https://github.com/agentydragon/ducktape/tree/main/nix/home/claude_code/skills/hetzner_vnc_screenshot
Command: npx skills add https://github.com/agentydragon/ducktape --skill hetzner-vnc-screenshot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires asyncvnc>=1.3.0, pillow>=10.0.0, typer>=0.9.0, hcloud>=2.0.0, websockets>=12.0, numpy>=1.26.0.

What problem does it solve?

This tool lets you capture screenshots of Hetzner Cloud VNC consoles to quickly verify server boot states and diagnose console-related issues.

Core Features & Use Cases

  • Connects to Hetzner Cloud VNC via WebSocket, authenticates with a password or API token, and captures the framebuffer as a PNG.
  • Supports fetching credentials by server name using HCLOUD_TOKEN or using explicit --url and --password, enabling flexible workflows for remote servers.
  • Useful for debugging boot issues, verifying BIOS/GRUB menus, and monitoring server console output when network access is unavailable.

Quick Start

Run the tool with a server name to automatically fetch credentials and capture a screenshot.

Frequently Asked Questions about hetzner_vnc_screenshot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I capture a Hetzner Cloud VNC screenshot to debug a server boot failure?▼

You can capture a Hetzner Cloud VNC screenshot by fetching console credentials via HCLOUD_TOKEN or an explicit WebSocket URL and password. The tool connects via WebSocket to capture the framebuffer and saves it as a PNG image.

Can I take a VNC screenshot of a Hetzner server when network access is unavailable?▼

Yes, VNC screenshots are useful for monitoring server console output when network access is unavailable. The tool uses asyncvnc and Pillow to connect to the WebSocket VNC session and capture the screen state.

Do I need an HCLOUD_TOKEN to automate Hetzner VNC screenshots?▼

No, you do not need an HCLOUD_TOKEN if you supply an explicit WebSocket URL and password. The tool supports fetching credentials by server name using the token or using direct credentials for flexible workflows.

What is the best way to view BIOS or GRUB screens on a Hetzner Cloud server?▼

The best way to view BIOS or GRUB screens is to capture a VNC console screenshot. The tool fetches Hetzner Cloud VNC credentials and captures the framebuffer as a PNG to verify boot sequences and diagnose console issues.

Does capturing Hetzner VNC console screenshots work with Python automation scripts?▼

Yes, capturing VNC screenshots works with Python automation. The tool uses asyncvnc, Pillow, and hcloud dependencies to authenticate and capture the console framebuffer programmatically.

Why is my Hetzner server inaccessible and how can a VNC screenshot help?▼

A Hetzner server may be inaccessible due to boot errors or network misconfiguration. A VNC screenshot helps diagnose server accessibility by capturing the console output or BIOS/GRUB state for inspection.

Related Skills

Explore More Software Engineering Skills→
tomspiegltomspiegl

hetzbot-snapshot-host

Create on-demand Hetzner Cloud snapshots of a specific host.

Community
Advanced
Wesley1600Wesley1600

python-script-skill

Execute Python scripts from the CLI with JSON or text output.

Community
Basic
evolv3aievolv3ai
3

admin-infra-hetzner

Automate Hetzner Cloud server provisioning with configurable types and locations.

Community
Advanced
miminashimiminashi
18

perc-raid

Manage Dell PERC RAID controllers remotely via VNC and CLI commands.

Community
Advanced