wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About

© 2026 winget.ragerworks.com

Loading...
Install cv4pve-pepper using Winget - wingetCollections
  1. Go back
  2. Packages
  3. cv4pve-pepper
cv4pve-pepper logo

cv4pve-pepper Corsinvest Srl

corsinvest proxmox proxmoxve remote-viewer spice virtualization vm
Use this command to install cv4pve-pepper:
winget install --id=Corsinvest.cv4pve.pepper -e

cv4pve-pepper is a tool designed to simplify SPICE remote-viewer connections to Proxmox VE virtual machines and containers, enabling seamless access for system administrators and DevOps professionals.

Key Features:

  • Proxmox VE API Integration: Connects directly to Proxmox VE clusters using the official API, eliminating the need for manual ticket handling or root access.
  • Automatic Ticket Management: Handles SPICE session tickets automatically, including generation and expiration, ensuring smooth connections without user intervention.
  • Cross-Platform Support: Available on Windows, Linux, and macOS, making it versatile for diverse environments.
  • Cluster Failover Support: Connects to the nearest available node in a Proxmox VE cluster, providing high availability and reliability.
  • Advanced Management Options: Includes features like VM auto-start or resume, session timeout handling, and support for API tokens (Proxmox VE 6.2+).

Audience & Benefit:

Ideal for system administrators and DevOps teams managing Proxmox VE environments who require quick, reliable access to virtual machines and containers. By automating SPICE connections and ticket management, cv4pve-pepper improves workflow efficiency and reduces manual overhead.

The tool can be installed via winget on Windows, ensuring seamless integration into existing workflows.

README

cv4pve-pepper

   ______                _                      __
  / ____/___  __________(_)___ _   _____  _____/ /_
 / /   / __ \/ ___/ ___/ / __ \ | / / _ \/ ___/ __/
/ /___/ /_/ / /  (__  ) / / / / |/ /  __(__  ) /_
\____/\____/_/  /____/_/_/ /_/|___/\___/____/\__/

Launching SPICE Remote Viewer for Proxmox VE (Made in Italy)

License Release Downloads

Quick Start

# Download latest release from: https://github.com/Corsinvest/cv4pve-pepper/releases
wget https://github.com/Corsinvest/cv4pve-pepper/releases/download/VERSION/cv4pve-pepper-linux-x64.zip
unzip cv4pve-pepper-linux-x64.zip
chmod +x cv4pve-pepper

# Launch SPICE viewer for VM
./cv4pve-pepper --host=YOUR_HOST --username=root@pam --password=YOUR_PASSWORD --vmid=100 --viewer=/usr/bin/remote-viewer

Features

Core Capabilities

Performance & Reliability

  • Native C# implementation
  • Cross-platform (Windows, Linux, macOS)
  • API-based operation (no root access required)
  • Cluster support with automatic failover
  • Ticket management (automatic handling of expiring tickets)

Advanced Management

  • API token support (Proxmox VE 6.2+)
  • Auto start/resume stopped or paused VMs
  • Proxy support for reverse proxy configurations
  • SSL validation options
  • Direct viewer options pass-through

Why cv4pve-pepper?

This tool simplifies SPICE client connections to Proxmox VE by:

  • No ticket expiration hassle - Handles Proxmox VE tickets automatically
  • No GUI required - Command-line execution
  • No manual .vv file downloads - Generates and launches automatically
Versions
1.9.0
Website
github.com
License
Last updated
1/13/2026
Download latest version
  • Simple workflow - Single command to connect

    • Installation

    Permission

    PermissionPurposeScope
    VM.ConsoleAccess VM consoleVirtual machines
    VM.AuditRead VM informationVirtual machines

    Linux Installation

    # Check available releases at: https://github.com/Corsinvest/cv4pve-pepper/releases
# Download specific version (replace VERSION with actual version like v1.9.0)
wget https://github.com/Corsinvest/cv4pve-pepper/releases/download/VERSION/cv4pve-pepper-linux-x64.zip

# Extract and make executable
unzip cv4pve-pepper-linux-x64.zip
chmod +x cv4pve-pepper

# Optional: Move to system path
sudo mv cv4pve-pepper /usr/local/bin/

    Windows Installation

    Option 1: Winget (Recommended)

    # Install using Windows Package Manager
winget install Corsinvest.cv4pve.pepper

    Option 2: Manual Installation

    # Check available releases at: https://github.com/Corsinvest/cv4pve-pepper/releases
# Download specific version (replace VERSION with actual version)
Invoke-WebRequest -Uri "https://github.com/Corsinvest/cv4pve-pepper/releases/download/VERSION/cv4pve-pepper.exe-win-x64.zip" -OutFile "cv4pve-pepper.zip"

# Extract
Expand-Archive cv4pve-pepper.zip -DestinationPath "C:\Tools\cv4pve-pepper"

# Add to PATH (optional)
$env:PATH += ";C:\Tools\cv4pve-pepper"

    macOS Installation

    # Check available releases at: https://github.com/Corsinvest/cv4pve-pepper/releases
# Download specific version (replace VERSION with actual version)
wget https://github.com/Corsinvest/cv4pve-pepper/releases/download/VERSION/cv4pve-pepper-osx-x64.zip
unzip cv4pve-pepper-osx-x64.zip
chmod +x cv4pve-pepper

# Move to applications
sudo mv cv4pve-pepper /usr/local/bin/

    Usage

    Basic Connection

    # Connect to VM using username/password
cv4pve-pepper --host=192.168.1.100 --username=root@pam --password=secret --vmid=100 --viewer=/usr/bin/remote-viewer

# Connect using API token (recommended)
cv4pve-pepper --host=192.168.1.100 --api-token=user@pve!token1=uuid-here --vmid=100 --viewer=/usr/bin/remote-viewer

    Advanced Options

    # Auto-start stopped VM and connect
cv4pve-pepper --host=pve.local --username=root@pam --password=secret --vmid=100 --viewer=/usr/bin/remote-viewer --start-or-resume

# Connect with fullscreen viewer
cv4pve-pepper --host=pve.local --api-token=user@pve!token=uuid --vmid=100 --viewer=/usr/bin/remote-viewer --viewer-options="-f"

# Connect using VM name instead of ID
cv4pve-pepper --host=pve.local --username=root@pam --password=secret --vmid=webserver --viewer=/usr/bin/remote-viewer

# Use with reverse proxy
cv4pve-pepper --host=pve.local --username=root@pam --password=secret --vmid=100 --viewer=/usr/bin/remote-viewer --proxy=https://spice.company.com:3128

    High Availability Cluster

    # Multiple hosts for HA failover
cv4pve-pepper --host=pve1.local:8006,pve2.local:8006,pve3.local:8006 --api-token=user@pve!token=uuid --vmid=100 --viewer=/usr/bin/remote-viewer

    Using Parameter Files

    # Create parameter file
cat > vm-connection.conf <
<strong>Linux (Debian/Ubuntu)</strong>

```bash
sudo apt-get update
sudo apt-get install virt-viewer

    Path: /usr/bin/remote-viewer

    Linux (RHEL/CentOS/Fedora)

    sudo dnf install virt-viewer
# or
sudo yum install virt-viewer

    Path: /usr/bin/remote-viewer

    Windows

    Download from SPICE Space

    Typical Path: C:\Program Files\VirtViewer v?.?-???\bin\remote-viewer.exe

    Minimum Version: virt-viewer 0.5.6 or higher

    macOS

    Download from SPICE Space macOS Client

    Minimum Version: virt-viewer 0.5.7 or higher

    Note: macOS support may have limitations

    Viewer Options

    Pass options directly to the SPICE viewer using --viewer-options:

    OptionDescriptionExample
    -fFullscreen mode--viewer-options="-f"
    -tSet window title--viewer-options="-t 'My VM'"
    --debugEnable viewer debug--viewer-options="--debug"

    Command Reference

    Authentication Options

    ParameterDescriptionExample
    --hostProxmox host(s) (required)--host=pve.local:8006
    --usernameUsername@realm--username=root@pam
    --passwordPassword or file--password=secret or --password=file:/etc/cv4pve/password
    --api-tokenAPI token--api-token=user@realm!token=uuid

    VM Selection

    ParameterDescriptionExample
    --vmidVM/CT ID or name--vmid=100 or --vmid=webserver

    SPICE Options

    ParameterDescriptionRequired
    --viewerPath to remote-viewer executableYes
    --viewer-optionsOptions to pass to viewerNo
    --proxySPICE proxy server URLNo

    VM Control

    ParameterDescriptionDefault
    --start-or-resumeStart stopped or resume paused VMfalse
    --wait-for-startupSeconds to wait for VM startup5

    Security Options

    ParameterDescriptionDefault
    --validate-certificateValidate SSL certificatefalse

    Output Options

    ParameterDescription
    --debugEnable debug output
    --versionShow version information
    -h, --helpShow help and usage

    Troubleshooting

    Common Issues

    Error: "no spice port"

    Cause: Display hardware not configured for SPICE

    Solution:

    1. Open VM hardware settings in Proxmox VE
    2. Change Display to "SPICE (qxl)"
    3. Restart the VM
    4. Try connecting again

    Error: "Authentication failed"

    Solution:

    # Verify credentials
cv4pve-pepper --host=pve.local --username=root@pam --password=test --vmid=100 --viewer=/usr/bin/remote-viewer --debug

# Check API token format
cv4pve-pepper --host=pve.local --api-token=user@realm!tokenid=uuid --vmid=100 --viewer=/usr/bin/remote-viewer --debug

    Error: "Connection timeout"

    Check connectivity:

    # Test network connectivity
ping pve.local
telnet pve.local 8006

# Try with IP address instead
cv4pve-pepper --host=192.168.1.100 --username=root@pam --password=secret --vmid=100 --viewer=/usr/bin/remote-viewer

# Enable SSL validation if needed
cv4pve-pepper --host=pve.local --username=root@pam --password=secret --validate-certificate --vmid=100 --viewer=/usr/bin/remote-viewer

    Viewer not found

    Find viewer path:

    # Linux
which remote-viewer
# Common path: /usr/bin/remote-viewer

# Windows (PowerShell)
Get-Command remote-viewer
# Common path: C:\Program Files\VirtViewer v*\bin\remote-viewer.exe

    Debug Mode

    Enable detailed logging:

    cv4pve-pepper --host=pve.local --username=root@pam --password=secret --vmid=100 --viewer=/usr/bin/remote-viewer --debug

    Support

    Professional support and consulting available through Corsinvest.

    Part of cv4pve suite | Made with ❤️ in Italy by Corsinvest

    Copyright © Corsinvest Srl