99
edits
Changes
Jump to navigation
Jump to search
* binutils-devThese required libraries and tools should be installed first. ===== Required Dependencies =====
Links to sections in the same page are now relative links
==== Installing Build Dependencies ====
* cmake
* gcc | clang
* fonts-freefont-ttf
* libegl-dev
* libgl-dev
* libfontconfig1-dev
* libgmp-dev
* libsdl2-dev
* libsdl2-ttf-dev
* libspice-protocol-dev
* libfontconfig1-dev* libx11-devmake
* nettle-dev
* pkg-config
====== May be disabled ======
These dependencies are required by default, but may be omitted if their feature is disabled when running [[#Building|cmake]].
* Disable with <code>cmake -DENABLE_BACKTRACE=no</code>
** binutils-dev
* Disable with <code>cmake -DENABLE_X11=no</code>
** libx11-dev
** libxfixes-dev
** libxi-dev
** libxss-dev
* Disable with <code>cmake -DENABLE_WAYLAND=no</code>
** libwayland-bin
** libwayland-dev
** wayland-protocols
===== Debian (and maybe Ubuntu) =====
<syntaxhighlight lang=bash>
apt-get install binutils-dev cmake fonts-freefont-ttf libfontconfig1-dev libsdl2-dev libsdl2-ttf-dev libspice-protocol-dev libfontconfig1-dev libx11-dev nettle-devwayland-protocols
</syntaxhighlight >
===== Fedora 29+ =====
<!-- Dependencies must match Debian's order, and extra dependencies must be on another line, with a consistent order -->
<syntaxhighlight lang=bash>
dnf install make binutils-devel cmake binutilstexlive-gnu-freefont fontconfig-devel SDL2-devel SDL2_ttf-devel nettle-devel spice-protocol fontconfig-devel libX11-devel egl-waylandnettle-devel wayland-devel mesa-libGLUprotocols-devel mesa-libGLES\ gcc libXScrnSaver-devel mesa-libGLlibXfixes-devel mesa-libEGLlibXi-devel libXfixes-devel libXiwayland-devel
</syntaxhighlight >
===== OpenSuSE Leap 15.0+ =====
<!-- Dependencies must match Debian's order, and extra dependencies must be on another line, with a consistent order -->
<syntaxhighlight lang=bash>
zypper install binutils-devel make cmake binutilsfontconfig-devel libSDL2-devel libSDL2_ttf-devel spice-protocol-devel libX11-devel libnettle-devel nettle spicewayland-protocolprotocols-devel fontconfig\ libconfig-devel libX11libXi-devel libconfiglibXss-devel libwayland-egl-devel libXi-develnettle
</syntaxhighlight >
===== Arch Linux / Manjaro =====
<!-- Dependencies must match Debian's order, and extra dependencies must be on another line, with a consistent order -->
<syntaxhighlight lang=bash>
pacman -Syu binutils sdl2 sdl2_ttf libx11 nettle fontconfig cmake spice-protocol gnu-free-fontsfontconfig sdl2 sdl2_ttf spice-protocol libx11 nettle \ gcc make pkgconf glu
</syntaxhighlight>
===== Void Linux =====
<!-- Dependencies must match Debian's order, and extra dependencies must be on another line, with a consistent order -->
<syntaxhighlight lang=bash>
xbps-install -Syu binutils-devel cmake freefont-ttf fontconfig-devel SDL2-devel SDL2_ttf-devel spice-protocol fontconfig-devel libX11-devel nettle-devel\ gcc make pkg-config
</syntaxhighlight>
First set up the necessary USE flags if needed:
<syntaxhighlight lang=bash>
echo "media-libs/libsdl2 glesgles2" >> /etc/portage/package.use/libsdl2
echo "media-libs/nettle gmp" >> /etc/portage/package.use/nettle
</syntaxhighlight>
Then fetch the packages:
<!-- Dependencies must match Debian's order, and extra dependencies must be on another line, with a consistent order -->
<syntaxhighlight lang=bash>
emerge sys-devel/binutils mediadev-libsutil/libsdl2 cmake media-libsfonts/sdl2-ttf devfreefonts media-libs/nettle libsdl2 media-libs/fontconfig devsdl2-util/cmake ttf app-emulation/spice-protocol \ media-fontslibs/fontconfig dev-libs/freefonts nettle \ media-libs/glu
</syntaxhighlight>
This list can also be placed into a setfile in /etc/portage/sets/ so that they can be updated with
</syntaxhighlight>
;NOTE: The most common compile error is related to backtrace support. This can be disabled by adding the following option to the cmake command. : '''-DENABLE_BACKTRACE=0''', however, if you disable this and need support for a crash please be sure to use gdb to obtain a backtrace manually or there is nothing that can be done to help you.
Should this all go well you should be left with the file '''looking-glass-client'''. Before you run the client you will first need to configure either Libvirt or Qemu (whichever you prefer) and then set up the Windows side service.
----
This article assumes you already have a fully functional libvirt VM with PCI Passthrough working on a dedicated monitor. If you do not please ensure this is configured before you proceed.
If you use virt-manager, this guide also applies to you, since it uses libvirt.
'''If you are using QEMU directly, this does not apply to you.'''
</syntaxhighlight>
The memory size (show as 32 in the example above ) may need to be adjusted as per [[Installation#Determining_Memory|Determining Memory]] section.
==== Spice Server ====If you would like to use Spice to give you keyboard and mouse input along with clipboard sync support be , make sure to also do the followingyou have a <code><graphics type='spice'></code> device, then:
* Add a QXL Find your <code><video ></code> device, but in the type field and set <code><model type `='none` (on '></code>** If you can't find it, make sure you have a <code><graphics></code> device, save and edit again** On older libvirt versions , just disable the device in Windows Device Manager)* Be sure to remove Remove the virtual <code><input type='tablet pointing '/></code> device., if you have one* Be sure to add the virtual PSCreate an <code><input type='mouse'/></2 Mouse code> device, and the Virtio if you don't already have one* Create an <code><input type='keyboard ' bus='virtio'/></code> device.to improve keyboard usage* Be sure that there is also a Spice Display configured (* This requires the ''vioinput'' driver from [https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/ virtio-win] to be installed in addition to the video device)guest
If you want clipboard synchronization please see [[FAQ#How to enable clipboard synchronization via SPICE]]
=== Qemu Commands ===
----
'''If you are using virt manager /libvirt then this does not apply to you.'''
Add the following to the commands to your QEMU command line, adjusting the bus to suit your particular configuration:
</syntaxhighlight>
The memory size (show as 32 in the example above ) may need to be adjusted as per [[Installation#Determining_Memory|Determining Memory]] section.
=== Determining Memory ===
== Looking Glass Service (Windows) ==
You must first run the Windows VM with the changes noted above in either the [[Installation#libvirt_Configuration|libvirt]] or [[Installation#Qemu_Commands|Qemu]] sections.
=== Installing the IVSHMEM Driver ===
=== Using the Windows Host Application ===
----
Start by downloading the correct version for your release from https://looking-glass.hostfission.comio/downloads. You can either choose between '''Official Releases''' which is is stable or '''Release Candidates''' that tries to be stable but has new features. '''Note:''' If your '''looking-glass-client''' was created by building from the '''master branch''' you have to pick the '''Bleeding Edge''' version. Next, extract the zip archive. Then, run the "looking-glass-host-setup.exe" installer and click through it. By default, the installer will install a service that automatically starts the host application at boot. The installer can also be installed in silent mode with the "/S" switch. Other command line options for the installer are documented by running it with the "/h" switch. There is also an unofficial Chocolatey package available, install with "choco install looking-glass-host --pre"
The windows host application captures the windows desktop and stuffs the frames into the shared memory via the shared memory virtual device, without this Looking Glass will not function. It is critical that the version of the host application matches the version of the client application, as differing versions can be, and usually are, incompatible.
'''Note:''' As of 2020-10-23, Microsoft Defender is known to mark the Looking-Glass host executable as a virus and in some cases will automatically delete the file.
'''Note:''' As of 2020-08-12 (commit dc4d1d49fac2361e60c9bb440bc88ce05f6c1cbd), the below instructions are deprecated. The host application now has an installer that installs a system-wide service to run the Looking Glass host application. When upgrading please be sure to remove the scheduled task if you have already created one.
<div class="toccolours mw-collapsible mw-collapsed">
Instructions for versions prior to 2020-08-12.
<div class="mw-collapsible-content">
To get the Windows-Host-Application running after restart you need to run it as a privileged task we do that by starting '''cmd.exe''' as '''administrator''' and running a command in it which creates a windows task.
Now you simply need to hit enter in to the cmd shell and restart the vm to test if it worked.
</div></div>
== Running the Client ==
