README-BR.md

🇺🇸 🇪🇸 🇮🇩 🇨🇳 🇫🇷 🇳🇱

---

Índice

• Sobre & Recursos
  • Desktops
  • Steam Deck/PCs Centros de Mídia (HTPCs)
    • Portáteis Alternativos
  • GNOME
  • Recursos Upstream
    • Universal Blue
    • Recursos do Fedora Linux (Kinoite & Silverblue)
• Porquê
• Imagens
• Documentação
• 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

---

Sobre & Recursos

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.
• Instalação simplificada do Davinci Resolve usando o davincibox (ujust install-resolve)
• 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 quiser utilizar o KDE Konsole ou o GNOME Console, eles podem ser instalados via Flatpak.
• Serviço duperemove automatizado 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-openrazer no 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-opentabletdriver no 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.

Desktops

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:stable

ou 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:stable

Usuários com o Secure Boot ativado: Sigam nossa documentação para secure boot antes do rebase.

Steam Deck/PCs Centros de Mídia (HTPCs)

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.
• duperemove automá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.
• Inclui os schedulers de CPU BORE e LAVD para uma experiência de gameplay suave e responsiva.
• Scheduler de I/O Kyber para prevenir inanição de I/O ao instalar jogos ou durante o processo de duperemove rodando 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.service e /etc/default/ryzenadj.
  • Um serviço para limitar o nível máximo da carga da bateria, vide batterylimit.service e /etc/default/batterylimit. ^{_{(Funciona mesmo se o dispositivo estiver desligado)}}
  • Suporte a overclocking de tela. Por exemplo, escreva CUSTOM_REFRESH_RATES=30-68 em /etc/environment. Taxas de atualização mínima e máxima mudam de portátil pra portátil!
  • 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?)}}
• Serviços específicos para o hardware do Steam Deck podem ser desabilitados rodando ujust disable-bios-updates e ujust disable-firmware-updates no 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:stable

Portáteis Alternativos

Por 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.

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 Handheld Controller (https://github.com/victor-borges/handheld-controller-glyphs)
ujust install-hhd-controller-glyph-theme

GNOME

Imagens 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:stable

Pra 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:stable

Warning

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:stable

Usuários com o Secure Boot ativado: Sigam nossa documentação para secure boot antes do rebase.

Recursos Upstream

Universal Blue

• Drivers proprietários da Nvidia pré-instalados. _{^{(Apenas nas imagens Nvidia)}}
• Flathub habilitado por padrão.
• Comandos ujust pra sua conveniência.
• Codecs multimídia inclusos.
• Faça rollback para qualquer versão do Bazzite dos últimos 90 dias.

Recursos do Fedora Linux (Kinoite & Silverblue)

• 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.

Porquê

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.

Imagens

Documentação

• Instalando e Gerenciando Programas
• Atualizações, Rollbacks, e Rebase
• Guia pra Gaming

Leia documentação adicional ao redor do projeto.

Pacotes Customizados

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
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
scx-scheds
sdgyrodsu
steamdeck-dsp
steamdeck-gnome-presets
steamdeck-kde-presets
steamdeck-kde-presets-desktop
steam_notif_daemon
ublue-update
udisks2
umu-launcher
upower
vpower
xwiimote-ng

Adicionalmente, os seguintes pacotes são utilizados de outros repositórios Copr:

Pacote	Status
discover-overlay
hhd
kernel-fsync
latencyflex-vulkan-layer
nerd-fonts
noise-suppression-for-voice
obs-vkcapture
ptyxis
rom-properties
wallpaper-engine-kde-plugin
webapp-manager

Verificação

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/bazzite

Secure Boot

Warning

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.der

Para usuários que já estão numa imagem Universal Blue, é só rodar ujust enroll-secure-boot-key.

Se uma senha for pedida, insira universalblue.

Métricas de Contribuição

Histórico de Estrelas

Agradecimentos Especiais

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.

Faça Sua Própria

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.

Junte-se à Comunidade

• Você pode falar conosco no Discord do Universal Blue

  • Visualize 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.

Veja a lista completa das mídias sociais e documentação do Bazzite.