From 2ecafddd1c3f7282fa90e5ac272409ae963b63f1 Mon Sep 17 00:00:00 2001 From: MacDue Date: Tue, 18 Jul 2023 21:15:45 +0100 Subject: [PATCH] Documentation: Add a rough guide on setting up SPICE on Ubuntu Only covers Ubuntu for now (since that's what I use), thought it might be good to put this somewhere, since I had to search around for the setup. --- Documentation/SpiceIntergration.md | 38 ++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 Documentation/SpiceIntergration.md diff --git a/Documentation/SpiceIntergration.md b/Documentation/SpiceIntergration.md new file mode 100644 index 0000000000..a5c6a4997d --- /dev/null +++ b/Documentation/SpiceIntergration.md @@ -0,0 +1,38 @@ +# Setting up SPICE integrations + +# Ubuntu + +1. Build QEMU via `Toolchain/BuildQemu.sh` +2. Install virt-viewer 8.0 + * On 23.04+ just do `sudo apt-get install virt-viewer` + * For earlier versions you need to build it from source (see below). +3. export SERENITY_SPICE=1 +4. Meta/serenity.sh run + +## Building + installing `virt-viewer` + +**Note:** If you installed an old version from `apt` uninstall that first (`sudo apt-get purge virt-viewer`). + + +Install the build dependencies: +``` +sudo apt-get install libvirt-glib-1.0 libvirt-dev spice-client-gtk-3.0 spice-client-glib-2.0 intltool +``` + +Fetch and extract the sources: +``` +wget https://releases.pagure.org/virt-viewer/virt-viewer-8.0.tar.gz +tar -xvf virt-viewer-8.0.tar.gz +``` + +Configure and build: +``` +cd ./virt-viewer-8.0 +./configure --with-spice-gtk +make +``` + +Install: +``` +sudo make install +```