cv4pve-pepper

cv4pve-pepper 2.0.1

Launching SPICE remote-viewer for Proxmox VE

Download for Windows

About cv4pve-pepper

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

Full release notes »

Technical details

PublisherCorsinvest Srl
Version2.0.1
Release date2026-09-29
LicenseGPL-3.0
Installer typezip
Architecturex86, x64, arm64
Package IDCorsinvest.cv4pve.pepper

Install cv4pve-pepper from the command line

Install with Windows Package Manager
winget install --id=Corsinvest.cv4pve.pepper -e
Update to the latest version
winget upgrade --id=Corsinvest.cv4pve.pepper -e
Uninstall
winget uninstall --id=Corsinvest.cv4pve.pepper -e

corsinvestproxmoxproxmoxveremote-viewerspicevirtualizationvm

cv4pve-pepper version history

2.0.0 Apr 14, 2026

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.0 Jan 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.