Skip to content

Instantly share code, notes, and snippets.

@felikcat

felikcat/README.adoc

Last active December 30, 2025 21:39
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save felikcat/b23f4c483bbf5390253f0bc562275639 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save felikcat/b23f4c483bbf5390253f0bc562275639 to your computer and use it in GitHub Desktop.
Download ZIP
Unmaintained instructions for the Linux section of my Resonite wiki
Raw
README.adoc
Table of Contents

Using Gamescope / a GNOME tip if you use fractional display scaling

Gamescope can be used to run Resonite at full resolution on say a 3840x2160 display, instead of 2560x1440 as mandated by 150% fractional scaling.
This 2560x1440 resolution limit on 4K displays without Gamescope is due to GNOME’s lack of support for native scaling through XWayland.

For Ubuntu 24.10, follow my instructions on how to compile and install Gamescope.

Through Steam’s library, here’s an example of the launch options you could give Resonite: gamescope -e -f -W 3840 -H 2160 -r 120 — %command% -LoadAssembly Libraries/ResoniteModLoader.dll -DoNotAutoLoadHome -SkipIntroTutorial

Tip
 -e = Steam integration
-f = fullscreen mode
-W = display width (X)
-H = display height (Y)
-r = display refresh rate

WiVRn

Run the profile builder once, install what it outputs, then install the additional required dependencies it missed:
sudo apt install libgstreamer-plugins-base1.0-dev libgl1-mesa-dev

Read LVRA’s wiki page on WiVRn, this is essential to ensuring a proper setup for yourself.

Calibrating SteamVR room setup on Debian and Ubuntu

Install SteamVR, run the Room Setup and then complete it.

Copy the files over to where Envision expects them to be:
cp -r ${HOME}/.local/share/Steam/config/* ${HOME}/.steam/steam/config/

How to support and use the Bigscreen Beyond 1/2/2e on Arch Linux

Sudo edit /etc/makepkg.conf and ensure that MAKEFLAGS=-j$(nproc), this will compile using all CPU cores while Arch’s build system is used.

This official Arch Wiki page has good instructions on how to build your own Linux kernel with the Bigscreen Beyond patch.

Need help on applying the patch? Append to source=():

bigscreenBeyond_6_11.patch

Then append to sha256sums:

'd1b35bea555bad792aac2f9a4e1b11cd85910c15336555a7d0b56720ed41638b'

Lastly, append to b2sums:

'c857994477429e9a2193b5e175879da2909bd4827eddf20110f3c28af43c49d0a6f798ee225633163a766053902832690b4387b083662ef367cfb591125a3e4f'

Ensure this patch is in the root of the 'linux-zen' folder, (sitting right by the PKGBUILD file in this instance).

Tip
 If there are PGP signatures that could not be verified, use gpg --recv-key THE_KEY and then try building the kernel again.

How to support and use the Bigscreen Beyond 1/2/2e on openSUSE Tumbleweed

Edit: customization.cfg

_distro="Suse"

mkdir linux615-tkg-userpatches

Install schedtool from the 'utilities' repository:
opi schedtool

Ignore missing ksym-provides tool and modprobe FATAL messages if they occur, the kernel will still work as intended:
chmod +x install.sh && ./install.sh install

Tip
 If you encounter dracut[F]: /usr/lib/modules/6.14.7_tkg_eevdf/modules.dep is missing. Did you run depmod?:
Run depmod, then run dracut -f --kver=6.14.7_tkg_eevdf.

Reboot, then install the 'Bigscreen Beyond Driver' on Steam, open SteamVR, and enjoy.

How to support and use the Bigscreen Beyond 1/2/2e on Ubuntu 24.10

Install the required and recommended dependencies:

  • curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

  • . "$HOME/.cargo/env"

  • sudo apt install git build-essential fakeroot libncurses5-dev libssl-dev ccache bison flex debhelper gawk bindgen dkms libtraceevent-dev libtracefs-dev libpci-dev python3-dev dwarves

Go to the ubuntu-kernel repository, and look at what’s the newest stable release. An example would be "Ubuntu-6.11.0-9.9":
git clone --depth 1 -b Ubuntu-6.11.0-9.9 https://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/oracular

Enter the newly downloaded directory:
cd oracular

Use the currently installed kernel configuration:
cp /boot/config-$(uname -r) .config

We do not have the certificate to sign kernel modules:

./scripts/config --file .config --set-str LOCALVERSION "-bigscreen-beyond"
./scripts/config --file .config --disable MODULE_SIG
./scripts/config --disable SYSTEM_TRUSTED_KEYS
./scripts/config --disable SYSTEM_REVOCATION_KEYS
./scripts/config --set-str CONFIG_SYSTEM_TRUSTED_KEYS ""
./scripts/config --set-str CONFIG_SYSTEM_REVOCATION_KEYS ""

patch -p1 -N < bigscreenBeyond.patch

patch -p1 -N < bigscreenBeyond_6_11.patch

Compile the kernel:
fakeroot make -j$(nproc)

Check if the build was successful; any value other than 0 indicates an error:
echo $?

Tip
 If compiling the kernel fails and the error doesn’t make sense (such as being non-descriptive), it could be that your CPU is unstable if it’s overclocked, while the second culprit would be the memory.
In my case however, I had to refund a 14900K CPU due to it being defective (13th to 14th i7 and i9 Intel CPUs commonly have this problem).

Install the kernel modules, then the kernel:
sudo make modules_install && sudo make install

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment