bazzite/README-SPA.md
2024-01-04 22:33:36 -08:00

36 KiB

Bazzite

build-bazzite


Tabla de Contenidos


Acerca de y Características

Bazzite es una imagen OCI que sirve como un sistema operativo alterno para la Steam Deck, y como un sistema tipo SteamOS listo para jugar para computadoras de escritorio, computadoras para cine en casa (HTPC), y un sinnúmero de otras computadoras portátiles.

Bazzite es creado con ublue-os/main y ublue-os/nvidia usando tecnología de Fedora, lo que significa un soporte expandido de hardware y drivers incluidos. Adicionalmente, Bazzite añade las siguientes características:

  • Drivers propietarios de NVIDIA pre-instalados.
  • Soporte total de decodificación acelerada por hardware del codec de video H264.
  • Soporte completo para los tiempos de ejecución (runtimes) de ROCM OpenCL/HIP de AMD
  • Drivers xone, xpadneo, y xpad-noone para mandos de videojuegos de Xbox.
  • Soporte completo de DisplayLink.
  • Incluye los temas para KDE de SteamOS, hechos por Valve.
  • LatencyFleX, vkBasalt, MangoHud, y OBS VkCapture instalados y disponibles por defecto.
  • Soporte para Wallpaper Engine. (Solo en KDE)
  • Incluida la extensión de la shell para mostrar las propiedades de ROMs (usados para la emulación de consolas) en el navegador de archivos.
  • Soporte completo para Winesync/Fastsync/NTsync.
  • Distrobox pre-instalado con actualizaciones automáticas para los contenedores creados.
  • Servicios automatizados duperemove y rmlint incluidos para reducir el espacio de disco utilizados por los contenidos de los prefijos de WINE.
  • Soporte de HDMI CEC (para poder controlar todos los dispositivos conectados por HDMI) usando libCEC.
  • System76-Scheduler pre-instalado, proveyendo ajustes automáticos de la prioridad de procesos a tu aplicación actualmente en uso, manteniendo al mínimo el tiempo que tu procesador (CPU) trabaja con procesos de fondo.
  • Configuración personalizada del System76-Scheduler con reglas adicionales.
  • Uso del control de congestión TCP BBR hecho por Google por defecto.
  • Input Remapper pre-instalado y habilitado. (Disponible pero desactivado por defecto en la variante Deck, puede ser habilitado ejecutando el siguiente comando en una terminal: ujust enable-input-remapper)
  • El portal de Bazzite (Bazzite Portal) provee una manera fácil de instalar un sin fin de aplicaciones y ajustes, incluyendo la instalación de LACT (para mejor controlar tu GPU de AMD) y GreenWithEnvy (para mejor controlar tu GPU de NVIDIA).
  • Gestor de paquetes Nix con la opción de instalar Fleek usando el Bazzite Portal.
  • Opción para instalar el gestor de paquetes Brew usando el Bazzite Portal.
  • Waydroid pre-instalado para correr aplicaciones de Android. Para configurarlo, usa esta guía rápida (en inglés).
  • Administra tus aplicaciones usando Flatseal, Warehouse, y Gear Lever.
  • Drivers i2c-piix4 y i2c-nct6775 de OpenRGB incluidos para controlar las luces RGB de ciertas tarjetas madre (motherboards).
  • Drivers de OpenRazer incorporados, Sólo selecciona OpenRazer en el Bazzite Portal o ejecuta el comando ujust install-openrazer en una terminal para empezar a usarlos.
  • Reglas para udev de OpenTabletDriver incorporadas, con la suite completa de software siendo instalable usando el Bazzite Portal ó ejecutando el comando ujust install-opentabletdriver en una terminal.
  • Driver GCAdapter_OC para aumentar la frecuencia del reloj (overclocking) del adaptador para el mando de videojuegos del Gamecube de Nintendo para obtener una taza de sondeo (polling rate) de 1000hz.
  • Soporte fuera de la caja (out of the box) para los teclados hechos por Wooting.
  • Soporte incorporado de las GPU de las familias (HD 7000) y Sea Islands (HD 8000) de AMD bajo el driver amdgpu.
  • Un parche esta disponible para un bug en juegos de 32 bits que usen el motor Source 1(Por ejemplo: TF2) que provoca que el juego se bloqueé al ser iniciado, para aplicar el parche, ejecuta el siguiente comando en una terminal: ujust patch-source1-tcmalloc
  • XwaylandVideoBridge esta disponible para hacer posible compartir tu pantalla con Discord usando Wayland.
  • Webapp Manager esta disponible para crear aplicaciones de sitios web con una variedad de navegadores web, incluyendo Firefox.

Desktop

Common variant available as bazzite, suitable for desktop computers.

  • Automatic updates for the OS, Flatpaks, Nix packages (Via Fleek), and all Distrobox containers.

Important

**ISOs can be downloaded from our releases page here, and a helpful install guide can be found here. If you experience any issues with installing Bazzite, then check out our troubleshoot guide.

If you're on an existing Universal Blue image follow these instructions. To rebase an existing upstream Fedora Silverblue/Kinoite ostree system to this image:

rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite:latest

or for devices with Nvidia GPUs:

rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-nvidia:latest

For users with Secure Boot enabled: Run ujust enroll-secure-boot-key and enter the password ublue-os if prompted to enroll the required key.

Steam Deck/Home Theater PCs (HTPCs)

Important

Devices that are NOT the Steam Deck can still use the bazzite-deck images, but must use an AMD/Intel GPU.

Variant designed for usage as an alternative to SteamOS on the Steam Deck, and for a console-like experience on HTPCs, available as bazzite-deck:

  • Directly boots to Gamemode matching SteamOS's behavior.
  • Automatic duperemove greatly trims the size of compatdata.
  • Latest version of Mesa creates smaller shader caches and does not require them to prevent stutter.
  • Able to be booted even if the drive is full.
  • Support for every language supported by upstream Fedora.
  • Uses Wayland on the desktop with support for Steam input.
  • Features ported versions of most SteamOS packages, including drivers, firmware updaters, and fan controllers from the evlaV repository.
  • Patched Mesa for proper framerate control from Gamescope.
  • Comes with patches from SteamOS BTRFS for full BTRFS support for the SD card by default.
  • Ships with a ported copy of SDGyroDSU, enabled by default.
  • Option to install Decky Loader, EmuDeck, RetroDECK, and ProtonUp-Qt, among numerous other useful packages on installation.
  • Custom update system allows for the OS, Flatpaks, Nix packages (Via Fleek), and Distrobox images to be updated directly from the Gamemode UI.
  • Built in support for Windows dual-boot thanks to Fedora's installation of GRUB being left intact.
  • Update break something? Easily roll back to the previous version of Bazzite thanks to rpm-ostree's rollback functionality. You can even select previous images at boot.
  • Steam and Lutris preinstalled on the image as layered packages.
  • Discover Overlay for Discord pre-installed and automatically launches in both Gamemode and on the Desktop if Discord is installed. View the official documentation here.
  • Uses ZRAM(4GB) with the ZSTD compression algorithm by default with the option to switch back to a 1GB swap file and set a custom size for it if desired.
  • Kyber I/O scheduler to prevent I/O starvation when installing games or during background duperemove and rmlint processes.
  • Applies SteamOS's kernel parameters.
  • Color calibrated display profiles for matte and reflective Steam Deck screens included.
  • Default-disabled power-user features, including:
    • Service for low-risk undervolting of the Steam Deck via RyzenAdj and Ryzen SMU, see ryzenadj.service and /etc/default/ryzenadj.
    • Service for limiting the max charge level of the battery, see batterylimit.service and /etc/default/batterylimit. (Works even when the device is off)
    • Built in support for display overclocking. For example, add GAMESCOPE_OVERRIDE_REFRESH_RATE=40,70 to /etc/environment.
    • Ability to use X11 on the desktop if desired by editing /etc/default/desktop-wayland.
    • 32GB RAM mod your Steam Deck? Enjoy double the maximum VRAM amount, automatically applied. (Can you share your soldering skills?)
  • Steam Deck hardware-specific services can be disabled by running ujust disable-deck-services in the terminal, useful for trying this image on other handhelds or for use on HTPCs.
  • More information can be found here on the Bazzite Steam Deck images.

Warning

**Due to an upstream bug, Bazzite cannot be used on Steam Decks with 64GB eMMC storage at this time. Upgrading the storage resolves the issue.

Important

**ISOs can be downloaded from our releases page here, and a helpful install guide can be found here. If you experience any issues with installing Bazzite, then check out our troubleshoot guide.

If you're on an existing Universal Blue image follow these instructions. To rebase an existing upstream Fedora Silverblue/Kinoite ostree system to this image:

rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-deck:latest

GNOME

Builds with the GNOME desktop environment are available in both desktop and deck flavors. These builds come with the following additional features:

Important

**ISOs can be downloaded from our releases page here, and a helpful install guide can be found here. If you experience any issues with installing Bazzite, then check out our troubleshoot guide.

To rebase an existing ostree system to the desktop release:

rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-gnome:latest

To rebase an existing ostree system to the desktop with Nvidia drivers release:

rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-gnome-nvidia:latest

Warning

**Due to an upstream bug, Bazzite cannot be used on Steam Decks with 64GB eMMC storage at this time.

To rebase an existing ostree system to the Steam Deck/HTPC release:

rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-deck-gnome:latest

Features from Upstream

Universal Blue

  • Flathub is enabled by default.
  • ujust commands for convenience.
  • Multi-media codecs out of the box.
  • Rollback Bazzite from any build within the last 90 days.

Features from Fedora Linux (Kinoite & Silverblue)

  • A rock solid and stable base.
  • System packages stay relatively up to date.
  • Can layer Fedora packages to the image without losing them between updates.
  • Security focused with SELinux preinstalled and configured out of the box.
  • The ability to rebase to different Fedora libostree images, if desired, without losing user data.
  • Printing support thanks to CUPS being preinstalled.

Why

Bazzite started as a project to resolve some of the issues that plague SteamOS, mainly out of date packages (despite an Arch base) and the lack of a functional package manager.

Despite this project also being image-based, you are able to install any Fedora package straight from the command line. These packages will persist across updates (So go ahead and install that obscure VPN software you spent an hour trying to get working in SteamOS). Additionally, Bazzite is updated multiple times a week with packages from upstream Fedora, giving you the best possible performance and latest features - all on a stable base.

Bazzite ships with the latest Linux kernel and SELinux enabled by default with full support for secure boot (Run ujust enroll-secure-boot-key and enter the password ublue-os if prompted to enroll our key) and disk encryption, making this a sensible solution for general computing. (Yes, you can print from Bazzite)

Read the FAQ for details on what makes Bazzite stand out from other Linux operating systems.

Showcase

KDE Vapor Theme

KDE VGUI2 Theme

Steam Game Mode

Waydroid

Distrobox Terminals

GNOME Vapor Theme

GNOME VGUI2 Theme

Documentation & Newsletters

Find additional documentation surrounding the project here.

Check out our newsletters that get published on a regular basis for updates on the project.

Custom Packages

Ported SteamOS and ChimeraOS packages, among others used by Bazzite, are built on Copr in bazzite and bazzite-multilib.

Package Status
bluez Build Status
discover-overlay Build Status
ds-inhibit Build Status
duperemove Build Status
extest Build Status
gamescope Build Status
gamescope-session-plus Build Status
gamescope-session-steam Build Status
gamescope-shaders Build Status
galileo-mura Build Status
gnome-randr-rust Build Status
gnome-shell-extension-bazzite-menu Build Status
gnome-shell-extension-caribou-blocker Build Status
gnome-shell-extension-compiz-windows-effect Build Status
gnome-shell-extension-hanabi Build Status
gnome-shell-extension-hotedge Build Status
hhd Build Status
jupiter-fan-control Build Status
jupiter-hw-support-btrfs Build Status
mangohud Build Status
mesa Build Status
pipewire Build Status
powerbuttond Build Status
python3-hid Build Status
rmlint Build Status
ryzenadj Build Status
sdgyrodsu Build Status
steamdeck-dsp Build Status
steamdeck-gnome-presets Build Status
steamdeck-kde-presets Build Status
steamdeck-kde-presets-desktop Build Status
steam_notif_daemon Build Status
udisks2 Build Status
upower Build Status
vpower Build Status
wireplumber Build Status
xorg-x11-server-Xwayland Build Status

Additionally, the following packages are used from other Copr repos:

Package Status
gcadapter_oc-kmod Build Status
gnome-vrr Build Status
hl2linux-selinux Build Status
joycond Build Status
kernel-fsync Build Status
latencyflex-vulkan-layer Build Status
noise-suppression-for-voice Build Status
obs-vkcapture Build Status
prompt Build Status
rom-properties Build Status
steamdeck-kmod Build Status
system76-scheduler Build Status
VTFLib Build Status
wallpaper-engine-kde-plugin Build Status
webapp-manager Build Status

Verification

These images are signed with sigstore's cosign. You can verify the signature by downloading the cosign.pub key from this repo and running the following command:

cosign verify --key cosign.pub ghcr.io/ublue-os/bazzite

Contributor Metrics

Bazzite

Special Thanks

Bazzite is a community effort and wouldn't exist without everyone's support. Below are some of the people who've helped us along the way:

  • rei.svg - For creating our logo and overall branding.
  • evlaV - For making Valve's code available and for being this person.
  • ChimeraOS - For gamescope-session and for valuable support along the way.
  • Jovian-NixOS - For supporting us with technical issues and for creating a similar project. Seriously, go check it out. It's our Nix-based cousin.
  • sentry - For assistance with needed kernel patches and for creating the kernel-fsync repo we now use.
  • nicknamenamenick - For being the MVP nearly single-handedly upkeeping our documentation and support literature, and countless cases of helping users.
  • Steam Deck Homebrew - For choosing to support distributions other than SteamOS despite the extra work, and a special thanks to PartyWumpus for getting Decky Loader working with SELinux for us.
  • cyrv6737 - For the initial inspiration and the base that became bazzite-arch.

Build Your Own

Bazzite is built entirely in GitHub and creating your own custom version of it is as easy as forking this repository, adding a private signing key, and enabling GitHub actions.

Familiarize yourself on keeping secrets in github. You'll need to generate a new keypair with cosign. The public key can be in your public repo (Your users need it to check the signatures), and you can paste the private key in Settings -> Secrets -> Actions with the name SIGNING_SECRET.

We also ship a config for the popular pull app if you'd like to keep your fork in sync with upstream. Enable this app on your repo to keep track of Bazzite changes while also making your own modifications.

Join The Community

You can find us on the Universal Blue Discord and view the archive of support threads on our Answer Overflow.

Discuss and create user guides over at the Universal Blue Discourse Forums.

Follow Universal Blue on Mastodon.