{"slug": "proxmox-spice-client-setup-for-macos", "title": "Proxmox - SPICE Client setup for MacOS", "summary": "This article provides instructions for setting up a SPICE client on macOS to connect to Proxmox virtual machines. The process involves installing the `virt-viewer` tool via Homebrew, creating an Automator application to launch `remote-viewer` with SPICE files, and configuring the system to automatically open `.vv` files with this helper app. Once configured, users can double-click a VM in the Proxmox interface to automatically launch a remote-viewer session.", "body_md": "-\nInstall a working (and compiled) version of virt-viewer. You may view the homebrew package's upstream source on GitHub.\nbrew tap jeffreywildman/homebrew-virt-manager brew install virt-viewer\n-\nOnce that's installed should be able make a call\nremote-viewer\nwith a pve-spice.vv file downloaded from proxmox web interfaceremote-viewer pve-spice.vv\nCheck out this useful script for debugging. There are also several other cli tools like this one on GitHub that can be used to test the same sort of thing.\nWe want remote-viewer to automatically start and open the session when we double click the VM entry in proxmox. To do that we need to first create a small helper application.\n-\nLaunch\nAutomator\nand select Application from the dropdown list, when prompted. -\nSearch for\nshell\nand drag to the right. The contents:/usr/local/bin/remote-viewer \"$@\"\nMake sure to select\nas arguments\nfor passing the input. Save as~/Applications/pve-spice-launcher.app\n. -\nLocate a pve-spice.vv file and right click, and go to\nGet Info -> Open With -> Change All\n, look for the .app file you just made. -\nIn Chrome, click on the small arrow on the list of downloads at the bottom, and select \"Always open files of this type\"\n-\nIf everything is set up correctly you should be able to double-click on the VM in the left pane of Proxmox and remote-viewer should start up and take care of the rest.\nNote: the pve-spice.vv files will be automatically deleted by remote-viewer\nEnjoy!", "url": "https://wpnews.pro/news/proxmox-spice-client-setup-for-macos", "canonical_source": "https://gist.github.com/tomdaley92/789688fc68e77477d468f7b9e59af51c", "published_at": "2021-07-15 20:40:17+00:00", "updated_at": "2026-05-22 12:14:59.401908+00:00", "lang": "en", "topics": ["developer-tools", "open-source", "cloud-computing"], "entities": ["Proxmox", "SPICE", "MacOS", "virt-viewer", "homebrew", "Automator", "Chrome", "GitHub"], "alternates": {"html": "https://wpnews.pro/news/proxmox-spice-client-setup-for-macos", "markdown": "https://wpnews.pro/news/proxmox-spice-client-setup-for-macos.md", "text": "https://wpnews.pro/news/proxmox-spice-client-setup-for-macos.txt", "jsonld": "https://wpnews.pro/news/proxmox-spice-client-setup-for-macos.jsonld"}}