Skip to content

Latest commit

 

History

History
347 lines (223 loc) · 11.7 KB

Bazzite.md

File metadata and controls

347 lines (223 loc) · 11.7 KB

Bazzite

Description

Bazzite is an OCI image that serves as an alternative operating system for the Steam Deck, and a ready-to-game SteamOS-like for desktop computers and living room home theatre PCs.

Directory

References

Installation

Description

This details how to install Bazzite and some things that need to be done.

References

Steps

  1. Follow the referenced Installing Bazzite and Initial Setup guide for Bazzite OS installation. Do note that an internet connection is needed.

  2. When given the choice (in GRUB) upon attempting to boot into the installer, choose the option to install bazzite-deck for a Steam Deck-like experience.

  3. Upon the initial boot into the desktop, before proceeding with Bazzite's First Boot Setup, generate a GPG Key first.

  4. Once a GPG key has successfully been generated, proceed with the first boot setup.

  5. During the first boot setup, simply follow all the prompts, and select any applications you may wish to install. I recommend:

    • EmuDeck
    • DeckyLoader
    • LibreOffice
    • Thunderbird
    • VLC
    • Google Chrome

  6. By default, Bazzite should run in a Wayland session. If you wish for Bazzite to run in an X.Org/X11 session by default, you can toggle this by running the following command:

    ujust _toggle_wayland

  7. Once you're done, you can now reboot - which will then boot you into Steam's Gaming Mode.

  8. Go through the setup on Gaming mode, I also recommend changing your hostname (device name) through the Settings while you're in Gaming mode.

  9. In Gaming mode, you have access to the Steam Menu via the Ctrl + 1 key, and the Quick Access Menu via the Ctrl + 2 key.

  10. After a reboot, if you have more things to setup in Desktop Mode, head to Power in the Steam menu and click the Switch to Desktop option.

Toggle Wayland

Description

Bazzite defaults to a Wayland session, this details how to toggle between a Wayland and X.Org/X11 session.

References

Steps

To toggle between a Wayland and X.Org/X11 session, simply run the following command:

ujust _toggle_wayland

Update

Description

This details how to update and maintain a Bazzite system.

References

Steps

  1. To update the system, simply run the following command:

    just update

    This simple command will update the system, update the Flatpak apps, as well as Distrobox containers like so:

    rpm-ostree update
flatpak update -y
distrobox upgrade -a

  2. If a major upgrade is required (i.e. Bazzite goes through an overhaul or if something is broken), perform a rebase with the following command:

    rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-deck:latest

    [!NOTE]
    This rebase is for the bazzite-deck image (i.e. for Steam Deck/HTPC devices). Replace the image name with the appropriate Bazzite image of your choosing.

  3. Reboot the system after the update or rebase is complete.

Fish Shell

This details on how to make Fish the default shell for the user, and setting an ideal configuration or profile for the Fish shell.

References

Notes

  • Since Bazzite is immutable, some of the dependencies required for the recommended configuration that were not preinstalled must either be installed manually (i.e. by downloading and installing their binary release from their source) or through Distrobox using an Arch Linux based container with yay installed.

  • Opting for podman over docker as the default container runtime is highly recommended for immutable systems due to its rootless nature.

  • In your Fish config.fish file, you may comment the entire # Package manager block since it does not apply for the Bazzite system.

Default Applications

From Desktop mode, this details on how to configure default applications of various types on KDE Plasma.

Plasma Discover Usage

This details how to use the Plasma Discover application to search, install, update, or uninstall packages graphically.

Plasma Desktop Quality of Life Improvements

This details on some things that could be done to improve the experience of using the desktop mode.

Plasma Desktop Theme Customisations

This details some customisation options for the Plasma desktop.

Mounting Remote Directory

This details how to mount a remote directory to our local machine using Samba.

Notes

  • It's potentially recommended to use a path within our user directory as the mounting point for the remote directory to avoid potential issues with the system's immutability. If you still wish to mount it outside of the user directory, be sure to only mount it from within /mnt.

Remote Access

This details how we can enable remote access into our system from other devices in the same network or externally.

EmuDeck

This details how to install, setup, and maintain EmuDeck on Bazzite.

Custom Emulator Configurations

This details on certain configuration options for several emulators.

Custom Game Emulation Configurations

This details on certain configuration options or fixes for several games of various emulation systems.

Install Applications/Libraries via Distrobox

This details how we can install certain applications or libraries not present in your system via Distrobox.

Wake on LAN or Wireless

This details on how to enable, setup and use Wake on LAN (WoL) or Wake on Wireless (WoWLAN) on our system.

References

Make Flatpak Apps Respect KDE Theme

This solves the issue of (some) Flatpak apps not looking native in KDE, and defaulting to a GTK theme instead.

Backing up with Vorta

This details installing and setting up Vorta to have it backup our personal files, and restoring them when needed.

References

Notes

  • These are our source folders and files to backup specific to the Bazzite system:

     ~/.config
 ~/.local/share/Steam/steamapps/common/Stardew Valley
 ~/.local/share/Steam/steamapps/compatdata
 ~/.local/share/Steam/steamapps/userdata
 ~/.var/app/io.github.shiiion.primehack/data/dolphin-emu/GC
 ~/.var/app/io.github.shiiion.primehack/data/dolphin-emu/StateSaves
 ~/.var/app/io.github.shiiion.primehack/data/dolphin-emu/Wii
 ~/.var/app/org.citra_emu.citra/data/citra-emu/sdmc
 ~/.var/app/org.citra_emu.citra/data/citra-emu/states
 ~/.var/app/org.DolphinEmu.dolphin-emu/data/dolphin-emu/GC
 ~/.var/app/org.DolphinEmu.dolphin-emu/data/dolphin-emu/StateSaves
 ~/.var/app/org.DolphinEmu.dolphin-emu/data/dolphin-emu/Wii
 ~/.var/app/org.libretro.RetroArch/config/retroarch/saves
 ~/.var/app/org.libretro.RetroArch/config/retroarch/states
 ~/.var/app/org.ppsspp.PPSSPP/config/ppsspp/PSP/PPSSPP_STATE
 ~/.var/app/org.ppsspp.PPSSPP/config/ppsspp/PSP/SAVEDATA
 ~/Applications
 ~/emudeck
 ~/ES-DE
 ~/homebrew
 ~/Pictures/Screenshots
 /run/media/mmcblk0p1/Emulation/roms/wiiu/mlc01/usr/save
 /run/media/mmcblk0p1/Emulation/saves/duckstation
 /run/media/mmcblk0p1/Emulation/saves/MAME
 /run/media/mmcblk0p1/Emulation/saves/pcsx2
 /run/media/mmcblk0p1/Emulation/saves/ryujinx
 /run/media/mmcblk0p1/Emulation/saves/scummvm
 /run/media/mmcblk0p1/Emulation/storage/rpcs3/dev_hdd0/home/00000001/savedata
 /run/media/mmcblk0p1/Emulation/storage/yuzu/nand/user/save

    This backs up some personal files and game-related files, including game saves and emulator configurations. Make necessary adjustments to the list based on your needs.

KDE Connect

This details installing and setting up KDE Connect on your system as a means to share files and other data wirelessly between devices on the same network.

Link's Awakening DX HD

This details how to install and run the Link's Awakening DX HD port.

Ocarina of Time

This details how to install and run the Ocarina of Time PC port, Ship of Harkinian.

Majora's Mask

This details how to install and run the Majora's Mask PC port, 2 Ship 2 Harkinian.

Wayland

This details specific configurations, fixes, and tips for systems running on Wayland.

References