Looking Glass Host¶
Building¶
For Windows on Windows¶
Download and install msys2 x86_64 from http://www.msys2.org/ following the setup instructions provided
Run the MSYS2 shell.
Download build dependencies with pacman
pacman -Fy
pacman -Sy git make mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake
Checkout the project
git clone https://github.com/gnif/LookingGlass.git
Configure the project and build it
mkdir LookingGlass/host/build
cd LookingGlass/host/build
cmake -G "MSYS Makefiles" ..
make
For Linux on Linux¶
Make a host/build direstory, then run cmake
cd host
mkdir build
cd build
cmake ..
make
For Windows cross compiling on Linux¶
Like For Linux on Linux, but specifying the mingw64 toolchain in cmake for building.
cd host
mkdir build
cd build
cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain-mingw64.cmake ..
make
Building the Windows installer¶
Build the host for Linux.
Install
nsis
apt-get install nsis
Use
makensisto build the installer.
cd host/build/platform/Windows
makensis installer.nsi
This will build looking-glass-host-setup.exe under
host/build/platform/Windows/looking-glass-host-setup.exe
Questions and Answers¶
Where is the log?¶
The log file for the host application is located at:
%ProgramData%\Looking Glass (host)\looking-glass-host.txt
You can also find out where the file is by right clicking on the tray icon and selecting “Log File Location”.
The log file for the looking glass service is located at:
%ProgramData%\Looking Glass (host)\looking-glass-host-service.txt
This is useful for troubleshooting errors related to the host application not starting.
High priority capture using DXGI and Secure Desktop (UAC) capture support¶
By default Windows gives priority to the foreground application for any
GPU work which causes issues with capture if the foreground application
is consuming 100% of the available GPU resources. The looking glass host
application is able to increase the kernel GPU thread to realtime
priority which fixes this, but in order to do so it must run as the
SYSTEM user account. To do this, Looking Glass needs to run as a
service. This can be accomplished by either using the NSIS installer
which will do this for you, or you can use the following command to
Install the service manually:
looking-glass-host.exe InstallService
To remove the service use the following command:
looking-glass-host.exe UninstallService
This will also enable the host application to capture the secure desktop which includes things like the lock screen and UAC prompts.
Why does this version require Administrator privileges?¶
This is intentional for several reasons.
NvFBC requires a system wide hook to correctly obtain the cursor position as NVIDIA decided to not provide this as part of the cursor updates.
NvFBC requires administrator level access to enable the interface in the first place. (WIP)
DXGI performance can be improved if we have this. (WIP)