### Install Waydroid Helper GUI

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Installing_and_Managing_Software/Waydroid_Setup_Guide.md

This command installs the Waydroid Helper application, a graphical user interface for advanced Waydroid configuration and control. It simplifies managing Waydroid installations.

```bash
ujust setup-waydroid helper
```

--------------------------------

### Redirect to Bazzite Installation Guide

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/General/Installation_Guide/Installing_Bazzite_for_Framework_Laptop_16.md

This JavaScript snippet handles the redirection of the current page to the Bazzite installation guide for the Framework Laptop 16. It's a simple client-side redirect, useful for ensuring users land on the most relevant documentation page.

```javascript
window.location.replace("https://guides.frame.work/Guide/Bazzite+Installation+on+the+Framework+Laptop+16/407");
```

--------------------------------

### Install and Enable ZeroTier

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/General/zerotier.md

Installs the ZeroTier One package using rpm-ostree and enables the systemd service to start on boot.

```bash
sudo rpm-ostree install zerotier-one
sudo systemctl enable --now zerotier-one
```

--------------------------------

### Setup Waydroid

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Installing_and_Managing_Software/Waydroid_Setup_Guide.md

This command initiates the setup process for Waydroid on the Bazzite system. It is the first step required before initializing or configuring Waydroid.

```bash
ujust setup-waydroid
```

--------------------------------

### Initialize Waydroid

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Installing_and_Managing_Software/Waydroid_Setup_Guide.md

This command launches the Waydroid initialization process, which is necessary for the first-time setup of Waydroid. It ensures that the Android container is properly prepared for use.

```bash
/usr/bin/waydroid-launcher
```

--------------------------------

### Edit Waydroid Configuration Files

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Installing_and_Managing_Software/Waydroid_Setup_Guide.md

Opens system configuration files for resolution and scaling adjustments. Requires root privileges via sudoedit.

```bash
sudoedit /etc/default/waydroid-launcher
sudoedit /etc/default/steamos-nested-desktop
```

--------------------------------

### Add ZeroTier Repository

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/General/zerotier.md

Creates a new yum repository configuration file for ZeroTier to allow package installation via rpm-ostree.

```bash
sudo tee >/dev/null /etc/yum.repos.d/zerotier.repo <<'EOF'
[zerotier]
name=ZeroTier, Inc. RPM Release Repository
baseurl=https://download.zerotier.com/redhat/fc/$releasever
enabled=1
gpgcheck=1
gpgkey=https://download.zerotier.com/contact@zerotier.com.gpg
EOF
```

--------------------------------

### Setup Windows Boot Shortcut in Steam

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/General/Installation_Guide/post-installation.md

Adds a script to the Steam library that allows users to reboot directly into the Windows partition. This is useful for dual-boot setups where users want to switch operating systems from within the Steam interface.

```bash
ujust setup-boot-windows-steam
```

--------------------------------

### Install MkDocs Dependencies

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/README.md

Installs the necessary dependencies for running and previewing the MkDocs documentation. This script is essential for setting up the local development environment.

```bash
bash utils/install-deps.sh
```

--------------------------------

### Install Dependencies with Just

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/GEMINI.md

Installs project dependencies using the 'just' command runner. This is a prerequisite for running other project commands.

```bash
just install_dependencies
```

--------------------------------

### Serve MkDocs Development Server

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/README.md

Starts the MkDocs development server, allowing you to preview the documentation locally as you make changes. This command requires the 'Just' tool.

```shell
just mkdocs serve
```

--------------------------------

### Markdown Admonition Example

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/GEMINI.md

Demonstrates how to use admonitions in Markdown for highlighting notes. Admonitions require specific syntax and indented content.

```markdown
!!! note "This is a note"

    This is the content of the note.
    It can have multiple lines.
```

--------------------------------

### Install Local RPM Files

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Installing_and_Managing_Software/rpm-ostree.md

Install a specific local .rpm binary to the host system. Note that these packages will not receive automatic updates.

```bash
rpm-ostree install /path/to/package.rpm
```

--------------------------------

### Configure ZeroTier Routing

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/General/zerotier.md

Commands to identify the network interface and add a host route to ensure ZeroTier traffic is routed correctly for gaming.

```bash
ifconfig -a
sudo route add -host 255.255.255.255 dev <interface name>
```

--------------------------------

### Uninstall ZeroTier

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/General/zerotier.md

Disables the service, removes the package via rpm-ostree, and deletes the repository configuration file.

```bash
sudo systemctl disable zerotier-one.service
sudo rpm-ostree uninstall zerotier-one
sudo rm -fv /etc/yum.repos.d/zerotier.repo
```

--------------------------------

### Install Flatpak Application via Terminal

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Installing_and_Managing_Software/Flatpak.md

This command allows users to install Flatpak applications directly from the terminal. It requires the application name as an argument. This is an alternative to using the graphical Bazaar app store.

```bash
flatpak install <application>
```

--------------------------------

### Configure Arctis Manager Autostart

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Advanced/arctis-manager.md

Creates the necessary directory and desktop entry file to launch the Arctis Manager system tray application automatically upon user login.

```bash
mkdir -p ~/.config/autostart/
nano ~/.config/autostart/lam-gui-tray.desktop
```

```ini
[Desktop Entry]
Categories=Utility;Application;
Exec=/usr/bin/sh -c '$HOME/.local/bin/lam-gui --systray >/dev/null 2>&1'
Icon=arctis-manager
Name=Arctis Manager (system tray)
StartupNotify=true
Terminal=false
Type=Application
```

--------------------------------

### Guild Wars 2 ArcDPS Updater Script Example

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Advanced/scopebuddy.md

This example demonstrates how to create a ScopeBuddy configuration file for Guild Wars 2 that disables GameScope, modifies the launch command, and executes a custom script to update the ArcDPS DLL. The script itself checks for updates and prompts the user before downloading the latest version.

```bash
# Guild Wars 2
# Do not use gamescope for this title
SCB_NOSCOPE=1
# Use ArenaNet login instead of Steam
command += " -provider Portal"

# Get the game directory from the expanded %command% variable from steam
GAMEDIR=$(echo $command | awk -F '" "' '{ print $12 }' | sed 's/\/Gw2-64.exe//')
# Run the arcdps updater script before game starts
"$SCB_CONFIGDIR/scripts/dl-arcdps" "$GAMEDIR"
```

```bash
#!/bin/bash
# Get the directory passed to the script
GW2_DIR=$1
# Get the latest md5sum for arcdps
NEWMD5SUM=$(wget -qO- https://www.deltaconnected.com/arcdps/x64/d3d11.dll.md5sum | awk '{print $1}')
# Get installed arcdps md5sum
MD5SUM=$(md5sum "$GW2_DIR/d3d11.dll" 2>/dev/null | awk '{print $1}')
# If they do not match, ask to update arcdps
if [ "$MD5SUM" != "$NEWMD5SUM" ]; then
    if zenity --question --text="Update ArcDPS?\nNew MD5: $NEWMD5SUM\nOld MD5: $MD5SUM"; then
        # Use wget to download arcdps as curl does not work in the steam environment
        wget -O "$GW2_DIR/d3d11.dll" https://www.deltaconnected.com/arcdps/x64/d3d11.dll
    fi
fi
```

--------------------------------

### Enable Proton Launch Logging

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Gaming/Common_gaming_issues.md

Configures Steam to generate a log file when launching a game, which is useful for diagnosing why a game fails to start. The log file is created in the user's home directory.

```bash
PROTON_LOG=1 %command%
```

--------------------------------

### Stop Waydroid Session

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Installing_and_Managing_Software/Waydroid_Setup_Guide.md

This command is used to stop a running Waydroid session. It is a prerequisite for performing configuration changes or updates to the Waydroid container.

```bash
waydroid session stop
```

--------------------------------

### Build Documentation with Just

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/GEMINI.md

Builds the static HTML documentation site using MkDocs. The output is generated in the 'book/' directory.

```bash
just mkdocs build
```

--------------------------------

### Toggle Waydroid Background Input

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Installing_and_Managing_Software/Waydroid_Setup_Guide.md

Configures Waydroid to ignore or accept input devices when the window is unfocused. Requires the Waydroid service to be active.

```command
waydroid prop set persist.waydroid.uevent false
```

--------------------------------

### Configure Mouse to Touch Input Mapping

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Installing_and_Managing_Software/Waydroid_Setup_Guide.md

Maps mouse clicks to touchscreen taps for specific Android applications. Requires the package name and a restart of the target application.

```command
waydroid prop set persist.waydroid.fake_touch "PACKAGE_NAME_HERE"
# To revert:
waydroid prop set persist.waydroid.fake_touch ""
```

--------------------------------

### Common Steam Launch Option Patterns

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Gaming/launch-options-env-variables.md

Demonstrates the general structure for Steam launch options, which typically involve setting environment variables before the game command. The `%command%` placeholder is essential and represents the game's executable. This pattern allows for enabling features like logging or disabling specific modes.

```bash
PROTON_LOG=1 %command%
SteamDeck=0 %command%
PROTON_ENABLE_NGX_UPDATER=1 %command%
```

--------------------------------

### Regenerate GRUB for Dual-Boot

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/General/Installation_Guide/post-installation.md

Updates the GRUB bootloader configuration to include both Windows and Bazzite installations. This command is intended for users dual-booting Bazzite with Windows to ensure both operating systems appear in the boot menu.

```bash
ujust regenerate-grub
```

--------------------------------

### Reset Steam Installation on Bazzite OS

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Handheld_and_HTPC_edition/quirks.md

This command-line utility is used to reset the Steam installation when Gaming Mode or Steam itself is broken. It's accessible via a host terminal or a TTY session.

```bash
ujust fix-reset-steam
```

--------------------------------

### Configure ScopeBuddy global defaults

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Advanced/scopebuddy.md

Shows how to define environment variables and default gamescope arguments in the ~/.config/scopebuddy/scb.conf file to simplify per-game launch commands.

```bash
export XDG_DEFAULT_LAYOUT=no
SCB_GAMESCOPE_ARGS="-f -w 2560 -h 1440 -W 2560 -H 1440 -r 180"
```

--------------------------------

### Append Launch Options in AppID Configuration

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Advanced/scopebuddy.md

Add custom launch options to the game's command line within an AppID configuration file using the '+=' operator. Ensure a leading space after the opening quote for correct parsing.

```bash
command+=" --launcher-skip --some-other-parameter"
```

--------------------------------

### Install Arctis Manager via Distrobox

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Advanced/arctis-manager.md

Executes a remote shell script to prepare the Distrobox container, build the application, and configure host system permissions.

```bash
curl -LsSf https://raw.githubusercontent.com/elegos/Linux-Arctis-Manager/refs/heads/develop/scripts/distrobox.sh | sh
```

--------------------------------

### Configure and install bazzite-cli for specific shells

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Advanced/bazzite-cli.md

This command allows users to install or update the bazzite-cli toolset while specifying the target shell environment. By overriding the SHELL variable, users can ensure the necessary shell-specific configurations are applied for fish or zsh.

```bash
SHELL=fish ujust bazzite-cli
SHELL=zsh ujust bazzite-cli
# Or do it all at once from bash with
ujust bazzite-cli && SHELL=fish ujust bazzite-cli && SHELL=zsh ujust bazzite-cli
```

--------------------------------

### Bazzite DLSS Swapper Launch Options

Source: https://github.com/ublue-os/docs.bazzite.gg/blob/main/src/Gaming/launch-options-env-variables.md

Explains Bazzite's shortcuts for enabling DLSS presets using the `dlss-swapper` utility. These shortcuts simplify the process of applying advanced DLSS settings, including the NGX updater, which can significantly improve performance and visual quality in supported games. The `dlss-swapper-dll` variant skips the NGX updater.

```bash
dlss-swapper %command%
dlss-swapper-dll %command%
```