- Sobre & Recursos
- Porquê
- Imagens
- Documentação & Newsletters
- Pacotes Customizados
- Verificação
- Secure Boot
- Métricas de Contribuição
- Histórico de Estrelas
- Agradecimentos Especiais
- Faça Sua Própria
- Junte-se à Comunidade
Entre no nosso site para ler uma explicação do Bazzite mais amigável a iniciantes. Este README é uma explicação aprofundada.
Bazzite é uma imagem OCI que serve como sistema operacional alternativo para o Steam Deck, e um parecido com o SteamOS e pronto pra jogar para computadores desktop e PCs centros de mídia.
O Bazzite é feito a partir do ublue-os/main e do ublue-os/nvidia utilizando tecnologia Fedora, o que significa que suporte expandido a hardware e drivers estão inclusos. Suplementarmente, o Bazzite traz os seguintes recursos:
- Usa o kernel fsync para suportar mais hardware e HDR, dentre outros vários patches.
- HDR disponível no Game mode.
- NVK disponível em versões não-Nvidia.
- Suporte completo à decodificação de hardware em codecs H264.
- Suporte completo aos run-times OpenCL/HIP ROCM da AMD.
- Driver xone para controles de Xbox.
- Suporte completo a DisplayLink.
- Inclui os temas do SteamOS para KDE da Valve.
- Inclui temas GTK3/4 semelhantes ao Vapor e VGUI2 do SteamOS. Instale o Gradience para usá-los.
- LatencyFleX, vkBasalt, MangoHud, e OBS VkCapture instalados e disponíveis por padrão
- Switcheroo-Control com patches que consertam a troca entre iGPU/dGPU em casos em que é quebrada por padrão.
- Suporte a Wallpaper Engine. (Só no KDE)
- Extensão do shell ROM Properties Page inclusa.
- Suporte completo a Winesync/Fastsync/NTsync.
- Distrobox pré-instalado com atualizações automáticas pra containers criados pelo usuário.
- Ptyxis Terminal é utilizado como terminal padrão em todas as imagens. Esse terminal é feito especialmente para o workflow em containers que você deve usar no Bazzite. Se desejar restaurar o terminal padrão do Fedora, execute
ujust _restore-original-terminal - Serviço
duperemoveautomatizado para reduzir o espaço em disco usado por arquivos em prefixos do wine. - Suporte a HDMI CEC via libCEC.
- Usa o controle de congestionamento TCP BBR da Google por padrão.
- Input Remapper pré-instalado e habilitado. (Disponível mas desabilitado por padrão na versão Deck, ative executando
ujust _restore-input-remapper) - O Bazzite Portal traz um jeito simples de instalar múltiplos aplicativos e ajustes, incluindo a instalação do LACT.
- Waydroid pré-instalado para rodar aplicativos Android. Confira esse guia rápido para configurá-lo.
- Gerencie aplicativos usando o Flatseal, Warehouse, e Gear Lever.
- Drivers i2c-piix4 e i2c-nct6775 pra OpenRGB para controlar o RGB em certas placas-mãe.
- Drivers OpenRazer inclusos, Selecione OpenRazer no Bazzite Portal ou rode
ujust install-openrazerno terminal para começar a usá-lo. - Regras de udev para OpenTabletDriver inclusas, com a instalalção completa disponível via Bazzite Portal ou rodando
ujust install-opentabletdriverno terminal. - Suporte por padrão a teclados Wooting.
- Suporte por padrão a GPUs Southern Islands (HD 7000) e Sea Islands (HD 8000) da AMD por meio do driver
amdgpu. - XwaylandVideoBridge disponível pra compartilhamento de tela no Discord em Wayland.
- Webapp Manager incluso para criar aplicativos a partir de sites com vários browsers, inclusive o Firefox.
Imagem genérica disponível como bazzite, própria para computadores desktop.
- Atualiza automaticamente o sistema, Flatpaks, e todos os containers Distrobox - via ublue-update e topgrade.
Important
ISOs podem ser baixadas do nosso site, com um guia de instalação conveniente disponível aqui.
Rebaseie de uma instalação existente de Fedora Atômico para esta imagem se você quiser Drivers de GPU Open Source: (Nota: A solução Open Source Mesa para GPUs NVIDIA, NVK ainda é propensa a erros quando esta orientação é redigida, pra qualquer problema pertinente à NVK por favor mande um relatório ao projeto Mesa, não ao Ublue/Bazzite)
rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite:stableou para dispositivos com GPUs Nvidia caso os Drivers Proprietários da NVIDIA convirem:
rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-nvidia:stableUsuários com o Secure Boot ativado: Sigam nossa documentação para secure boot antes do rebase.
Important
Dispositivos que NÃO SÃO o Steam Deck também podem usar as imagens bazzite-deck, mas precisam ter uma GPU recente da AMD. GPUs Arc da Intel também foram confirmadas como funcionando.
Imagem feita pra ser utilizada como alternativa ao SteamOS no Steam Deck, e para uma experiência semelhante a consoles em HTPCs, disponível como bazzite-deck:
- Inicializa diretamente no Game mode, assim como o SteamOS.
duperemoveautomático reduz bastante o tamanho da compatdata.- A última versão do Mesa cria caches de shader menores e não requer seu uso pra prevenir travamentos.
- Inicia mesmo se o disco estiver cheio.
- Suporte a todos os idiomas suportados pelo Fedora.
- Usa o desktop em Wayland com suporte a Steam Input.
- Inclui o HHD para suporte expandido de entrada pra portáteis que não são da Valve.
- Contém versões da maioria dos pacotes nativos do SteamOS, incluindo drivers, atualizadores de firmware, e controladores de ventoinha do repositório evlav.
- Mesa com patches pra suportar controle de taxa de quadros via Gamescope.
- Vem com patches do SteamOS BTRFS pra suporte completo a BTRFS no cartão SD por padrão.
- Inclui uma versão do SDGyroDSU, habilitada por padrão.
- Opções pra instalar o Decky Loader, EmuDeck, RetroDECK, e ProtonUp-Qt, entre outros vários programas úteis na instalação.
- Um sistema de atualização customizado permite que o sistema, Flatpaks e imagens Distrobox sejam atualizados diretamente pela interface do Game mode via ublue-update e topgrade.
- Suporte padrão a dual-boot com Windows já que a instalação de GRUB do Fedora é mantida intacta.
- Uma atualização quebrou alguma coisa? Volte facilmente pra versão anterior do Bazzite graças à funcionalidade de rollback do
rpm-ostree. Você pode até selecionar imagens anteriores na sequência de boot. - Steam e Lutris pré-instalados via pacotes sobrepostos na imagem.
- Discover Overlay pra Discord pré-instalado e iniciado automaticamente tanto no Game mode quanto no Desktop se o Discord estiver instalado. Confira a documentação oficial aqui.
- Usa ZRAM(4GB) com o algoritmo de compressão ZSTD por padrão com a opção de trocar de volta para um arquivo de swap de 1GB e definir um tamanho arbitrário pra ele se desejado.
- Scheduler de I/O Kyber para prevenir inanição de I/O ao instalar jogos ou durante o processo de
duperemoverodando em segundo plano. - Aplica os parâmetros de kernel do SteamOS.
- Perfis de cor calibrada para as telas padrão e antirreflexo do Steam Deck inclusos.
- Recursos para usuários avançados e desabilitados por padrão, incluindo:
- Um serviço para undervolt de baixo risco do Steam Deck assim como laptops Framework com AMD via RyzenAdj e Ryzen SMU, vide
ryzenadj.servicee/etc/default/ryzenadj. - Um serviço para limitar o nível máximo da carga da bateria, vide
batterylimit.servicee/etc/default/batterylimit. (Funciona mesmo se o dispositivo estiver desligado) - Suporte a overclocking de tela. Por exemplo, escreva
GAMESCOPE_OVERRIDE_REFRESH_RATE=40,70em/etc/environment. - Modificou seu Steam Deck pra ter 32GB de RAM? Aproveite o dobro da quantia máxima de VRAM, aplicada automaticamente. (Quer emprestar esse talento com solda?)
- Um serviço para undervolt de baixo risco do Steam Deck assim como laptops Framework com AMD via RyzenAdj e Ryzen SMU, vide
- Serviços específicos para o hardware do Steam Deck podem ser desabilitados rodando
ujust disable-bios-updateseujust disable-firmware-updatesno terminal. Eles são desabilitados automaticamente em hardware que não seja o Deck, e em Decks com telas DeckHD ou mods de 32GB de RAM. - Mais informações sobre as imagens Bazzite Steam Deck podem ser encontradas aqui.
Warning
Devido a um bug upstream, o Bazzite não pode ser utilizado em Steam Decks com 64GB de armazenamento eMMC no momento. Fazer um upgrade de armazenamento resolve o problema.
Important
ISOs podem ser baixadas do nosso site, com um guia de instalação conveniente disponível aqui.
Pra fazer rebase de uma instalação existente de Fedora Atômico para esta imagem:
rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-deck:stablePor favor confira nossa wiki pra portáteis pras mudanças de configuração necessárias e plugins do Decky Loader pro Steam Gaming Mode do seu portátil específico.
Se você estiver utilizando essa imagem num portátil além do Steam Deck, você pode obter controle de TDP através do plugin do Decky Loader SimpleDeckyTDP.
- Primeiro instale o Decky Loader com:
ujust setup-decky - Então instale o SimpleDeckyTDP:
ujust setup-decky simpledeckytdp
Se você estiver usando um portátil suportado pelo hhd (Como o Lenovo Legion Go ou o ASUS Ally), você pode obter o plugin para integrá-lo como uma opção no menu do game mode com: ujust setup-decky hhd-decky
Certifique-se de ler a documentação do hhd, alguns portáteis requerem mudanças de configuração/ajustes específicos pra funcionar corretamente.
Nós também incluímos comandos ujust para instalar vários temas pra CSS Loader que não se encontram na loja do CSS Loader. Esses temas são atualizados automaticamente com o Bazzite se instalados.
# Para instalar o tema ROG Ally pra CSS Loader (https://github.com/semakusut/SBP-ROG-Ally)
ujust install-rog-ally-theme
# Para instalar o tema Lenovo Legion Go pra CSS Loader (https://github.com/frazse/SBP-Legion-Go-Theme)
ujust install-legion-go-theme
# Para instalar o tema Handheld Controller (https://github.com/victor-borges/handheld-controller-glyphs)
ujust install-hhd-controller-glyph-theme
# Para instalar o tema de glifos PS5-pra-Xbox pra hhd & CSS Loader (https://github.com/frazse/PS5-to-Xbox-glyphs)
ujust install-hhd-xbox-glyph-themeImagens com o ambiente desktop GNOME estão disponíveis pra ambas as versões desktop & deck. Estas variantes trazem os seguintes recursos adicionais:
- Suporte a taxa de atualização variável e escala fracionada de aplicativos habilitadas em Wayland.
- Menu customizado no painel para retornar ao game mode, iniciar a Steam, e abrir alguns utilitários.
- GSConnect pré-instalado e pronto pra usar.
- Extensão Hanabi inclusa pra obter funcionalidades semelhantes ao Wallpaper Engine pro KDE.
- Várias extensões opcionais pré-instaladas, incluindo correções importantes para a experiência de usuário.
- Atualizações automáticas para o tema GNOME pro Firefox e o tema GNOME pro Thunderbird. (Se instalados)
Important
ISOs podem ser baixadas do nosso site, com um guia de instalação conveniente disponível aqui.
Pra fazer rebase de uma instalação existente de Fedora Atômico para esta imagem:
rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-gnome:stablePra fazer rebase de um sistema ostree existente para uma versão com Ambiente Desktop e os Drivers Proprietários da NVIDIA:
rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-gnome-nvidia:stableWarning
Devido a um bug upstream, o Bazzite não pode ser utilizado em Steam Decks com 64GB de armazenamento eMMC no momento.
Pra fazer rebase de um sistema ostree existente para a versão Steam Deck/HTPC:
rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-deck-gnome:stableUsuários com o Secure Boot ativado: Sigam nossa documentação para secure boot antes do rebase.
- Drivers proprietários da Nvidia pré-instalados. (Apenas nas imagens Nvidia)
- Flathub habilitado por padrão.
- Comandos
ujustpra sua conveniência. - Codecs multimídia inclusos.
- Faça rollback para qualquer versão do Bazzite dos últimos 90 dias.
- Base bastante sólida e estável.
- Pacotes do sistema relativamente atualizados.
- Capacidade de sobrepor pacotes Fedora sobre a imagem sem perdê-los em atualizações.
- Focado em segurança com o SELinux pré-instalado e configurado por padrão.
- Capacidade de mudar a base do sistema entre imagens diferentes de Fedora Atômico, se desejado, sem perder dados de usuário.
- Suporte a impressora graças ao CUPS pré-instalado.
O Bazzite começou como um projeto pra resolver alguns dos problemas que afligem o SteamOS, particularmente pacotes desatualizados (apesar da base Arch) e a falta de um gerenciamento de pacotes funcional.
Apesar deste projeto também ser baseado em imagens, você pode instalar qualquer pacote Fedora direto do terminal. Estes pacotes vão persistir entre atualizações (Então vá em frente e instale aquele software desconhecido de VPN que você gastou meia-hora tentando fazer funcionar no SteamOS). Inclusive, o Bazzite é atualizado várias vezes por semana com os pacotes dos repositórios Fedora, trazendo a melhor peformance possível e os últimos recursos - tudo numa base estável.
O Bazzite inclui a versão mais recente do kernel Linux e vem com SELinux habilitado por padrão com suporte total a secure boot (Execute ujust enroll-secure-boot-key e insira a senha universalblue se requisitada para adicionar a nossa chave) e criptografia de disco, fazendo dele uma solução razoável pra computação em geral. (Sim, você pode usar sua impressora no Bazzite)
Confira o FAQ para mais detalhes no que faz o Bazzite ser diferente de outros sistemas operacionais Linux.
Leia documentação adicional ao redor do projeto.
Confira nossas newsletters publicadas regularmente com as novidades do projeto.
Pacotes vindos do SteamOS e ChimeraOS, dentre outros usados pelo Bazzite, são construídos no Copr em bazzite e bazzite-multilib.
| Pacote | Status |
|---|---|
| ds-inhibit |  |
| duperemove |  |
| extest |  |
| gamescope |  |
| gamescope-session-plus |  |
| gamescope-session-steam |  |
| gamescope-shaders |  |
| galileo-mura |  |
| gnome-randr-rust |  |
| gnome-shell |  |
| gnome-shell-extension-bazzite-menu |  |
| gnome-shell-extension-caribou-blocker |  |
| gnome-shell-extension-compiz-windows-effect |  |
| gnome-shell-extension-hanabi |  |
| gnome-shell-extension-hotedge |  |
| joystickwake |  |
| jupiter-fan-control |  |
| jupiter-hw-support-btrfs |  |
| jupiter-sd-mounting-btrfs | |
| kf6-kio |  |
| mangohud |  |
| mesa |  |
| pipewire |  |
| powerbuttond |  |
| python3-hid |  |
| ryzenadj |  |
| sdgyrodsu |  |
| steamdeck-dsp |  |
| steamdeck-gnome-presets |  |
| steamdeck-kde-presets |  |
| steamdeck-kde-presets-desktop |  |
| steam_notif_daemon |  |
| ublue-update |  |
| udisks2 |  |
| unl0kr |  |
| upower |  |
| vpower |  |
| wireplumber |  |
| xwiimote-ng |  |
Adicionalmente, os seguintes pacotes são utilizados de outros repositórios Copr:
As imagens são assinadas com o cosign da sigstore. Você pode verificar essa assinatura baixando a chave cosign.pub deste repositório ao rodar o seguinte comando:
cosign verify --key cosign.pub ghcr.io/ublue-os/bazziteWarning
Usuários do Steam Deck: O Steam Deck não habilita o secure boot e não vem com quaisquer chaves inclusas por padrão. Não ative se não tiver certeza absoluta de que sabe o que está fazendo.
Secure boot é suportado com a nossa chave própria. A chave pública se encontra aqui na raiz deste repositório. Se você quiser adicionar a nossa chave antes da instalação ou rebase, baixe a chave e execute o seguinte:
sudo mokutil --timeout -1
sudo mokutil --import secure_boot.derPara usuários que já estão numa imagem Universal Blue, é só rodar ujust enroll-secure-boot-key.
Se uma senha for pedida, insira universalblue.
O Bazzite é um esforço comunitário e não existiria sem o apoio de todos. Listados abaixo estão algumas das pessoas que nos ajudaram pelo caminho:
- rei.svg - Por criar nossa logo e branding no geral.
- SuperRiderTH - Por criar o nosso vídeo de inicialização pro Steam game mode.
- evlaV - Por disponibilizar o código da Valve e por ser essa pessoa.
- ChimeraOS - Pelo gamescope-session e pela valiosa ajuda ao longo do caminho.
- Jovian-NixOS - Por nos ajudar com problemas técnicos e por criar um projeto similar. Sério, vai lá conferir. É o nosso primo baseado em Nix.
- sentry - Por ajudar com patches de kernel necessários e por criar o repositório kernel-fsync que nós usamos agora.
- nicknamenamenick - Por ser o MVP mantendo toda a nossa documentação e biblioteca de suporte quase sozinho, e ajudar usuários inúmeras vezes.
- Steam Deck Homebrew - Por escolher suportar distribuições além do SteamOS apesar do trabalho adicional, e um agradecimento especial ao PartyWumpus por fazer o Decky Loader funcionar com o SELinux pra gente.
- cyrv6737 - Pela inspiração inicial e a base que se tornou o bazzite-arch.
O Bazzite é construído inteiramente no GitHub e criar sua própria versão customizada é tão simples quanto fazer um fork deste repositório, adicionar uma chave privada pra assinatura, e habilitar as GitHub actions.
Se familiarize com o uso de segredos no github. Você vai precisar gerar um novo par de chaves com o cosign. A chave pública pode ficar no seu repositório público (Seus usuários precisam dela pra verificar a assinatura), e você pode colar a chave privada em Settings -> Secrets -> Actions com o nome SIGNING_SECRET.
Nós também incluímos uma configuração pro app popular pull se você quiser manter seu fork sincronizado com o upstream. Habilite esse app no seu repositório pra ficar a par das mudanças no Bazzite enquando mantém suas próprias modificações.
Você pode falar conosco no Discord do Universal Blue e visualizar o acervo de postagens de suporte sem precisar de uma conta.
Discuta e crie guias de usuário nos Fóruns Discourse do Universal Blue.
Siga o Universal Blue no Mastodon.