How to use ujust Convenience Commands on Bazzite
March 19 2025 8:24pm • Est. Read Time: 4 MINujust is a command-line utility included in Universal Blue-based operating systems (like Bazzite) that provides a series of scripts and configuration tweaks. These commands allow you to customize, fix, or enhance various aspects of your system. Each ujust
command is designed to address a specific use case, such as enabling driver support, configuring system services, or adjusting performance settings.
Why Use ujust
?
The ujust
tool simplifies many advanced or repetitive tasks. Rather than manually editing system files or installing packages one by one, you can run a single ujust
command that automatically applies the relevant changes or installs the necessary components. This approach is especially useful for new Bazzite users or those who want a streamlined method to tailor their system.
How to Use ujust
- Check Available Commands: Run
ujust
(with no arguments) to see a list of available subcommands and their short descriptions. - Run a Specific Command: Use
sudo ujust <command-name>
to apply a fix, enable a driver, or configure your system. - Follow Any Prompts: Some commands may ask for confirmation or additional details (e.g., a username for
add-users-to-input-group
). - Reboot or Logout (if prompted): Certain changes may require a reboot or logout to take effect fully.
Below is a comprehensive list of commands shown in the attached text file, along with explanations of what each does.
ujust
Command Reference
Note: Some of these commands are Framework Specific (designed especially for Framework Computers), while others are generalized and applicable to all Bazzite systems.
Examples of "not for Framework" would be NVIDIA, wake-on-LAN functionality as two examples.
- add-user-to-input-group Add user to the "input" group required by certain controller drivers.
- bazzite-cli Bazzite CLI mod for Bluefin style CLI-bing (modified copy of ublue-bling script).
- benchmark Run a one-minute system benchmark.
- bios Boot into this device's BIOS/UEFI screen.
- bios-info Show BIOS information.
- changelogs Show the stable changelog. (Alias: changelog)
- changelogs-testing Show the testing (pre-release) changelog.
- check-idle-power-draw Measure idle power draw.
- check-local-overrides Check for local overrides.
- clean-system Clean up old/unused Podman images, volumes, Flatpak packages, and rpm-ostree content.
- configure-auto-power-profile Change automatic power profile switching behavior. (Usage: ACTION="help")
- configure-broadcom-wl Configure the Broadcom WL driver (enabling WL may break other Wi-Fi adapters). (Alias: broadcom-wl; Usage: ACTION="prompt")
- configure-grub Configure GRUB bootmenu visibility. Pass action 'help' for more info.
- configure-nvidia Configure the NVIDIA driver. (Alias: nvidia; Usage: ACTION="prompt")
- configure-nvidia-optimus Configure NVIDIA Optimus.
- configure-snapshots Configure snapshotting for /var/home.
- configure-watchdog Configure watchdog (default: enabled, recovers the system in the event of a malfunction).
- device-info Gather device info and output to a pastebin.
- distrobox-assemble Create distroboxes from a defined manifest. (Alias: assemble; Usage: CONTAINER="prompt" ACTION="create" FILE="/etc/distrobox/distrobox.ini")
- distrobox-new Create a new custom distrobox. (Alias: distrobox; Usage: IMAGE="prompt" NAME="prompt" HOMEDIR="")
- enable-deduplication Enable BTRFS deduplication.
- enable-displaylink Enable support for DisplayLink.
- enable-framework-fan-control (Framework Specific) Enable Framework Fan Control for managing fan speeds on Framework Laptops.
- enable-rmlint Reenable rmlint trim feature. (Usage: ACTION="")
- enable-tailscale Enable support for Tailscale.
- enroll-secure-boot-key Enroll Nvidia driver & KMOD signing key for secure boot (enter password "universalblue" if prompted).
- fix-gmod Patch GMod's 64-bit beta to work properly on Linux. (Alias: patch-gmod)
- fix-proton-hang Kill all processes related to Wine and Proton to force a restart when launching a game (may require pressing STOP in Steam).
- fix-reset-steam Reset the Steam folder back to a fresh state.
- get-decky-bazzite-buddy Install the Bazzite Buddy plugin to easily access changelogs in game mode.
- get-framegen Set up DLSS-Enabler Upscaling and Framegen mod. (Usage: ACTION="prompt")
- get-logs Retrieve logs for the current and previous boot, output as pastebin links for troubleshooting.
- get-webapp Add various streaming services as Electron web apps to Steam. (Usage: service="")
- install-adwaita-for-steam Install the Adwaita-for-Steam theme for CSS Loader.
- install-boxtron Install Boxtron, a Steam Play compatibility tool to run DOS games using native Linux DOSBox.
- install-coolercontrol Install CoolerControl, a GUI for viewing system sensors and creating custom fan/pump profiles.
- install-docker Install Docker for building, sharing, and running container applications.
- install-emudeck Install EmuDeck.
- install-lact Install LACT for overclocking and undervolting AMD GPUs.
- install-openrazer Install OpenRazer for Razer gaming hardware.
- install-openrgb Install OpenRGB.
- install-opentabletdriver Install OpenTabletDriver, an open source, cross-platform tablet driver.
- install-oversteer Install Oversteer for Logitech steering wheels.
- install-resilio-sync Install Resilio Sync, a file synchronization utility powered by BitTorrent.
- install-resolve Install or update DaVinci Resolve. (Alias: install-resolve-studio)
- install-scrcpy Install scrcpy to mirror Android devices (video and audio) via USB or TCP/IP.
- install-steamcmd Install SteamCMD. (Alias: get-steamcmd)
- install-wootility Install Wootility for configuring Wooting Keyboards. (Alias: get-wootility)
- logs-last-boot Show all messages from the last boot.
- logs-this-boot Show all messages from the current boot.
- ptyxis-transparency Set Ptyxis terminal transparency. (Usage: opacity="0.95")
- regenerate-grub Regenerate GRUB configuration, useful for dual-boot scenarios where a second OS isn’t listed.
- remove-luks-tpm-unlock Disable automatic LUKS unlock via TPM.
- remove-opentabletdriver Remove OpenTabletDriver.
- restart-pipewire Restart PipeWire.
- restore-gnome-de-settings Restore Bazzite-customized Desktop Environment settings.
- restore-gnome-folders Restore Bazzite-customized applications folders.
- setup-boot-windows-steam Add a script in Steam to boot Windows, useful for dual-boot setups.
- setup-cdemu Set up and configure CDEmu Daemon and Client plus GUI apps. (Usage: ACTION="")
- setup-decky Install and configure Decky Loader and plugins for alternative handhelds. (Usage: ACTION="install")
- setup-distrobox-app Install specialized application containers (e.g., brew). (Usage: CONTAINER="prompt")
- setup-distrobox-git Install or uninstall distrobox-git.
- setup-luks-tpm-unlock Enable automatic LUKS unlock via TPM.
- setup-sunshine Set up and configure the Sunshine game streaming host.
- setup-virtual-channels Add virtual audio channels/sinks (e.g., Game, Voice, Browser, Music) for use with OBS and other applications.
- setup-virtual-surround Set up a virtual 7.1 surround sink for headphones using the PipeWire Spatializer module.
- setup-virtualization Set up and configure virtualization and VFIO.
- setup-waydroid Launch the Waydroid configuration helper. (Alias: configure-waydroid; Usage: ACTION="")
- toggle-bt-mic Toggle Bluetooth headset profile mode to control microphone availability.
- toggle-i915-sleep-fix Toggle fix for i915 sleep issues.
- toggle-nvk Switch between NVIDIA image and NVK.
- toggle-password-feedback Toggle password prompt feedback in terminal (displaying asterisks). (Usage: ACTION="")
- toggle-ssh Toggle SSH availability on boot.
- toggle-updates Turn automatic updates on or off. (Alias: auto-update; Usage: ACTION="prompt")
- toggle-user-motd Toggle display of the user Message of the Day in terminal.
- toggle-wol Enable or disable wake-on-LAN functionality.
- toolbox-assemble Create toolbox containers from a defined manifest. (Usage: CONTAINER="prompt" ACTION="create" FILE="/etc/toolbox/toolbox.ini")
- toolbox-new Create a new custom toolbox. (Usage: IMAGE="prompt" NAME="prompt")
- update Update system, Flatpaks, and containers all at once. (Alias: upgrade)
Best Practices
- Check the Documentation: Always run
ujust
by itself or consult the Bazzite docs to see any updates or additional usage notes for each command. - Reboot When Instructed: Some commands only take full effect after a reboot or logout in some instances.
Summary
The ujust
utility in Bazzite provides a convenient, centralized way to configure your system, apply fixes, and enable hardware or software features. By offering an extensive list of commands—ranging from driver support to advanced system tweaks—ujust
helps you tailor Bazzite to your needs without the hassle of manual configuration.
Whether you’re setting up game streaming with Sunshine or adjusting system performance for gaming, ujust
simplifies these tasks into one-liner commands that are easy to remember and quick to apply.