cv4pve-pepper is a tool for launching SPICE remote-viewer to connect to Proxmox VE virtual machines and containers.
Features:
Launch SPICE remote-viewer for VMs and containers
Simple and easy to use
Integration with Proxmox VE API
What's new in 2.0.1
Documentation - Documentation site. The documentation moved from the README to corsinvest.github.io/cv4pve-pepper: getting started, permissions, options, SPICE and VNC, desktop shortcut and troubleshooting, each checked against the code and on a test cluster, including which viewer to use, also for VNC (#43). The README is now a short overview Fixed - --debug and --log-level now control all diagnostic output the same way: pepper's own lines (viewer command, VNC bridge, start/resume) go through the logger instead of the console, so --log-level shows them too - Secrets are masked in diagnostic output: the VNC ticket in the WebSocket URL and the SPICE password - --dry-run no longer leaves a .vv file with a valid ticket in the temp folder - Errors are reported as ERROR: … like the other cv4pve tools, with the stack trace when --debug is set - --start-or-resume stops with the real reason when the start or resume fails, instead of trying to open the console of a stopped VM; the result of the start task is checked - Windows release builds are now WinExe, as intended in 2.0.0: no console window when launched from a shortcut (the release is built on Linux, so the output type now follows the target runtime) - --proxy help and README: the SPICE proxy is an IP address or host name reached on port 3128, not a URL - Packaging license was MIT; the project is GPL-3.0-only Changed - Updated Corsinvest.ProxmoxVE.Api.Console to 9.2.3 - Product icon (Lucide monitor-play) and Windows executable icon - Project metadata, symbols and Source Link aligned with the other cv4pve tools What's Changed - ci: use shared cv4pve-tools CI workflow and declare publish permissions by @franklupo in #44 - Fix diagnostic output and error handling, align project with cv4pve tools by @franklupo in #45 - Documentation site by @franklupo in #46 - Release 2.0.1 by @franklupo in #47 Full Changelog: v2.0.0...v2.0.1
Added - VNC console support via --vnc flag — connect to any running VM or container without SPICE display configuration - No extra console window on Windows when launched from a desktop shortcut or file manager Fixed - Password file with plaintext content was rejected — now works correctly alongside encrypted files - VNC connection was using the wrong API endpoint for QEMU VMs and LXC containers - Viewer was launched even when the API returned an error — now shows the error and exits cleanly What's Changed - Add cv4pve-vdi reference for desktop experience by @franklupo in #41 - Add VNC support and bump to v2.0.0 by @franklupo in #42 Full Changelog: v1.9.0...v2.0.0
1.9.0Jan 7, 2026
Frequently asked questions
Is cv4pve-pepper free?
Yes. cv4pve-pepper is free and open-source software released under the GPL-3.0 license.
What is the latest version of cv4pve-pepper?
The latest version is 2.0.1, released on Sep 29, 2026.
Is it safe to download cv4pve-pepper?
The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with fd67d72e420918e54abc5c2e515e1a07d0eecb6e3b5182e8dc3bb29c1add961b.
Which Windows versions does cv4pve-pepper support?
cv4pve-pepper runs on Windows and is available for 32-bit (x86), 64-bit (x64), ARM64 systems.
How do I uninstall cv4pve-pepper?
Open Settings › Apps › Installed apps, find cv4pve-pepper and select Uninstall. From the command line, run winget uninstall --id=Corsinvest.cv4pve.pepper -e.
Is there a portable version of cv4pve-pepper?
Yes. cv4pve-pepper is available as a portable ZIP archive (cv4pve-pepper.exe-win-x64.zip, 64-bit (x64)) that runs without installation. Copy it to any folder or USB drive and run it from there.
Alternatives to cv4pve-pepper
Other Development kits programs for Windows from different developers.