Skip to content

Installing

Madman10K edited this page Jul 26, 2024 · 13 revisions

Gentoo Linux users

Subscribe to the UntitledDesktopOverlay. After that, install the package:

root # emerge untitled-game-system-manager

Preparing for installation

Users that don't have a package in their distribution's repositories have to compile it from source. You're going to need the following dependencies:

  1. CMake
  2. GNU make
  3. A C++ 17 compiler with a compatible standard library(GCC, clang)
  4. Have the glxinfo utility installed
  5. You need to be running PulseAudio
  6. You need to be running X11
  7. You need to be running a modern Intel, AMD, or Nvidia GPU
  8. Bash
  9. Golang

Compiling the manager

  1. Install Incus
    1. On Gentoo: root # emerge incus
    2. On Arch: root # pacman -S incus
    3. On Debian/Ubuntu: root # apt install incus

This is a standard UntitledImGuiFramework project. Building instructions can be found here.

Before compiling the project, make sure you have compiled the incus bindings using Golang by executing the following commands:

cd IncusBindings || exit
go get . || exit
go build -o libUGM_Incus_InternalFuncs.so -buildmode=c-shared . || exit
cd .. || exit

Using the CLI installer

  1. If it's your first time configuring Incus, we have a handy script that will configure it for you automatically. Simply run root # ./ugm-cli-prepare-install.sh. It can be found under the $installprefix/share/config/UntitledGameSystemManager/Dist/
  2. Add the following to the PATH environment variable export PATH=~/.config/UntitledGameSystemManager/scripts/:$PATH
  3. You might have some audio and networking problems. Restart your computer and go to the Troubleshooting entry if they persist
  4. Now, open the game manager and create a container using the GUI
  5. By the end of the installation script, you would have a fully functional system and can move to using the manager. As always, if there are any problems go to Troubleshooting, and if they aren't listed here, create an issue on GitHub.