mirror/bazzite

Fork 0

mirror of https://github.com/ublue-os/bazzite.git synced 2024-12-28 00:17:39 +00:00

Kyle Gospodnetich 92dfeae828 chore(readme): Update terminal ujust command

2024-07-01 08:50:16 -07:00

42 KiB

Raw Blame History

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

Table des matières

Table des matières

À propos et fonctionnalités

Veuillez consulter notre site web pour une explication conviviale de Bazzite destinée aux nouveaux utilisateurs. Ce fichier readme couvrira tout en détail.

Bazzite est une image OCI qui sert de système d'exploitation alternatif pour le Steam Deck, et est un SteamOS-like prêt à l'emploi pour les ordinateurs de bureau et les PC Home Theater.

Bazzite est construit à partir de ublue-os/main et ublue-os/nvidia en utilisant la technologie de Fedora, ce qui signifie que le support matériel étendu et les pilotes intégrés sont inclus. De plus, Bazzite ajoute les fonctionnalités suivantes :

Utilise le noyau fsync pour obtenir la prise en charge HDR et un support matériel étendu, ainsi que de nombreux autres correctifs.
HDR disponible en mode jeu.
NVK disponible sur les builds non-Nvidia.
Support complet des codecs matériel pour le décodage H264.
Support complet pour les runtimes OpenCL/HIP ROCM d'AMD.
Pilote xone pour les contrôleurs Xbox.
Support complet pour DisplayLink.
Comprend le thème KDE de Valve issus de SteamOS.
Thèmes optionnels GTK3/4 inspirés de celui de Valve, correspondant à Vapor et VGUI2 de SteamOS. Installez Gradience pour les utiliser.
LatencyFleX, vkBasalt, MangoHud, et OBS VkCapture installés et disponibles par défaut.
Switcheroo-Control patché pour corriger le basculement iGPU/dGPU cassé par défaut.
Support pour Wallpaper Engine. _{^{(Seulement sur KDE)}}
Extension de shell ROM Properties Page incluse par défaut.
Support complet pour Winesync/Fastsync/NTsync.
Distrobox préinstallé avec mises à jour automatiques pour les conteneurs créés.
Ptyxis Terminal est utilisé par défaut dans toutes les images. Ce terminal est spécialement conçu pour le workflow des conteneurs dans Bazzite. Pour revenir au terminal d'origine, exécutez ujust _restore-original-terminal.
Service automatisé duperemove pour réduire l'espace disque utilisé par les contenus du préfixe wine.
Support pour HDMI CEC via libCEC.
System76-Scheduler préinstallé, fournissant des ajustements automatiques de priorité des processus pour l'application focalisée, gardant le temps CPU pour les processus en arrière-plan au minimum.
Configuration personnalisée de System76-Scheduler avec des règles supplémentaires.
Utilise par défaut BBR TCP congestion control de Google.
Input Remapper préinstallé et activé par défaut. _{^{(Disponible mais désactivé par défaut sur la variante SteamDeck, peut être activé avec ujust _restore-input-remapper)}}
Bazzite Portal offrant un moyen facile d'installer de nombreuses applications et ajustements, y compris l'installation de LACT et GreenWithEnvy.
Waydroid est préinstallé pour exécuter des applications Android. Configurable avec ce guide rapide.
Gère les applications avec Flatseal, Warehouse, et Gear Lever.
OpenRGB pilotes i2c-piix4 et i2c-nct6775 pour contrôler le RGB sur certaines cartes mères.
Pilotes OpenRazer intégrés, sélectionnez OpenRazer dans Bazzite Portal ou exécutez ujust install-openrazer dans un terminal pour commencer à l'utiliser.
Règles udev OpenTabletDriver intégrées, avec la suite logicielle complète installable via Bazzite Portal ou en exécutant ujust install-opentabletdriver dans un terminal.
Prise en charge prête à l'emploi des claviers Wooting.
Prise en charge intégrée pour les GPU AMD Southern Islands _{^{(HD 7000)}} et Sea Islands _{^{(HD 8000)}} sous le pilote amdgpu.
XwaylandVideoBridge est disponible pour le partage d'écran Discord sur Wayland.
Webapp Manager est disponible pour créer des applications à partir de sites web pour une variété de navigateurs, y compris Firefox.

Environnement de bureau

De nombreuses variantes communes sont disponibles sous le nom bazzite, adaptée aux ordinateurs de bureau.

Mises à jour automatiques pour le système d'exploitation, les Flatpaks et tous les conteneurs Distrobox - propulsées par ublue-update et topgrade.

Important

Les ISOs peuvent être téléchargées depuis notre page de versions, et un guide d'installation utile peut être trouvé ici.

Rebase d'un Fedora Atomic existante de cette image est disponible ici avec des pilotes GPU Open Source : (Remarque : l'option Open Source de Mesa pour les GPU NVIDIA, NVK, est encore sujette à des erreurs au moment de la rédaction. Pour tout problème lié à NVK, merci de soumettre un rapport à Mesa, pas à Ublue/Bazzite)

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

ou pour les appareils avec des GPU Nvidia voulant les pilotes propriétaires NVIDIA :

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

Pour les utilisateurs avec Secure Boot activé : Suivez notre documentation sur le démarrage sécurisé avant de faire le rebase.

Steam Deck/Home Theater PCs (HTPCs)

Important

Les appareils qui NE sont PAS des SteamDeck peuvent toujours utiliser les images bazzite-deck, mais doivent utiliser un GPU AMD moderne. Les GPU Intel Arc ont également été confirmés comme fonctionnels.

Variante conçue pour être utilisée comme alternative à SteamOS sur le SteamDeck, et pour une expérience de console sur les HTPCs, disponible sous le nom bazzite-deck :

Démarre directement en mode jeu, correspondant au comportement de SteamOS.
Le duperemove automatique réduit considérablement la taille des compatdata.
La dernière version de Mesa crée des caches de shaders plus petits et n'en nécessite pas pour éviter les saccades.
Peut être démarré même si le disque est plein.
Prise en charge de toutes les langues prises en charge par Fedora.
Utilise Wayland en mode bureau avec support pour SteamInput.
Inclut HHD pour un support d'entrée étendu sur les consoles portables non-Valve.
Propose la plupart des packages SteamOS, y compris les pilotes, les mises à jour de firmware et les contrôleurs du ventilateur du dépôt evlaV.
Mesa patché pour un contrôle approprié du framerate par Gamescope.
Livré avec des patches de SteamOS BTRFS pour un support complet de BTRFS pour le lecteur carte SD.
Livré avec une copie de SDGyroDSU, activé par défaut.
Option pour installer Decky Loader, EmuDeck, RetroDECK, et ProtonUp-Qt, ainsi que de nombreux autres packages utiles lors de l'installation.
Le système de mise à jour personnalisé permet de mettre à jour directement depuis l'interface du mode jeu grâce à ublue-update et topgrade.
Prise en charge intégrée du dual-boot Windows en laissant l'installation du GRUB de Fedora intacte.
Une mise à jour casse quelque chose ? Reviennez facilement à la version précédente de Bazzite grâce à la fonctionnalité de rollback de rpm-ostree. Vous pouvez même sélectionner les images précédentes au démarrage.
Steam et Lutris préinstallés dans l'image en tant que packages superposés.
Discover Overlay pour Discord préinstallé et lancé automatiquement à la fois en mode jeu et sur le bureau si Discord est installé. Consulte la documentation officielle ici.
Utilise ZRAM_^(4GB) avec l'algorithme de compression ZSTD par défaut, avec la possibilité de revenir à un fichier swap de 1GB et de définir une taille personnalisée si nécessaire.
Planificateur d'E/S Kyber pour éviter la starvation des E/S lors de l'installation de jeux ou pendant le processus de duperemove en arrière-plan.
Applique les paramètres du noyau de SteamOS.
Profils d'affichage calibrés en couleur pour les écrans mats et réfléchissants du SteamDeck inclus.
Fonctionnalités pour utilisateurs avancés désactivées par défaut, notamment :
- Service pour l'undervolting à faible risque du SteamDeck ainsi que des ordinateurs portables AMD via RyzenAdj et Ryzen SMU, voir ryzenadj.service et /etc/default/ryzenadj.
- Service pour limiter le niveau de charge maximal de la batterie, voir batterylimit.service et /etc/default/batterylimit. ^{_{(Fonctionne même lorsque l'appareil est éteint)}}
- Support intégré pour l'overclocking d'affichage. Par exemple, ajoutez GAMESCOPE_OVERRIDE_REFRESH_RATE=40,70 à /etc/environment.
- Vous avez modifié votre SteamDeck avec 32 Go de RAM ? Profitez du double de la quantité maximale de VRAM, appliqué automatiquement. ^{_{(Pourriez-vous partager vos compétences en soudure ?)}}
Les services spécifiques au matériel du SteamDeck peuvent être désactivés en exécutant ujust disable-bios-updates et ujust disable-firmware-updates dans le terminal. Ils sont automatiquement désactivés sur le matériel non-Deck, et sur les Decks avec des écrans DeckHD ou des mods de 32 Go de RAM.
Plus d'informations peuvent être trouvées ici sur les images Bazzite pour SteamDeck.

Warning

En raison d'un bug amont, Bazzite ne peut pas être utilisé sur les SteamDecks avec 64 Go de stockage eMMC pour le moment. La mise à niveau du stockage résout le problème.

Important

Les ISOs peuvent être téléchargées depuis notre page de versions, et un guide d'installation utile peut être trouvé ici.

Rebase d'un Fedora Atomic existante avec cette image :

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

Consoles portables alternatives

Merci de consulter notre Wiki des consoles portables pour les modifications de paramètres nécessaires et les plugins Decky Loader pour le mode jeu Steam sur votre console portable spécifique.

Si vous utilisez cette image sur une console portable autre que le SteamDeck, vous pouvez contrôler le TDP via le plugin SimpleDeckyTDP de Decky Loader.

Installez d'abord Decky Loader avec : ujust setup-decky
Ensuite, installez SimpleDeckyTDP avec : ujust setup-decky simpledeckytdp

Si vous utilisez une console portable prise en charge par hhd _{^{(comme le Lenovo Legion Go et l'ASUS Ally)}}, vous pouvez également obtenir le plugin pour intégrer un menu d'options dans le mode jeu avec : ujust setup-decky hhd-decky

Assurez-vous également de lire la documentation de hhd, certaines consoles portables nécessitent des modifications/tweaks spécifiques pour fonctionner correctement.

Nous avons également des commandes ujust pour installer divers thèmes CSS Loader qui ne se trouvent pas sur le magasin CSS Loader. Ceux-ci seront automatiquement mis à jour avec Bazzite s'ils sont installés.

# Installer le thème ROG Ally pour CSS Loader (https://github.com/semakusut/SBP-ROG-Ally)
ujust install-rog-ally-theme

# Installer le thème Lenovo Legion Go pour CSS Loader (https://github.com/frazse/SBP-Legion-Go-Theme)
ujust install-legion-go-theme

# Installer le thème Manette de jeu portable (https://github.com/victor-borges/handheld-controller-glyphs)
ujust install-hhd-controller-glyph-theme

# Installer le thème glyphes PS5-to-Xbox pour hhd & CSS Loader (https://github.com/frazse/PS5-to-Xbox-glyphs)
ujust install-hhd-xbox-glyph-theme

GNOME

Les versions avec l'environnement de bureau GNOME sont disponibles en versions desktop et deck. Ces versions incluent les fonctionnalités supplémentaires suivantes :

Prise en charge du taux de rafraîchissement variable et du scaling fractionné activés sous Wayland, voir ici.
Menu personnalisé dans la barre supérieure pour revenir au mode jeu, lancer Steam et ouvrir plusieurs utilitaires utiles.
GSConnect est préinstallé et prêt à l'emploi, voir ici.
Extension Hanabi incluse pour offrir des fonctionnalités similaires à Wallpaper Engine sous KDE, voir ici.
Nombreuses extensions optionnelles préinstallées, y compris des correctifs importants pour l'expérience utilisateur, voir ici.
Mises à jour automatiques pour le thème GNOME de Firefox et le thème GNOME de Thunderbird, s'ils sont installés.

Important

Les ISO peuvent être téléchargées depuis notre page de releases, et un guide d'installation utile est disponible ici.

Pour rebaser un système ostree existant vers cette image :

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

Pour rebaser un système ostree existant vers une version avec l'environnement de bureau Proprietary NVIDIA Drivers :

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

Warning

En raison d'un bug en amont, Bazzite ne peut pas être utilisé sur les Steam Decks avec un stockage eMMC de 64 Go pour le moment.

Pour rebaser un système ostree existant vers la version Steam Deck/HTPC :

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

Pour les utilisateurs avec Secure Boot activé : Suivez notre documentation sur le Secure Boot avant de rebaser.

Fonctionnalités provenant d'autres sources

Universal Blue

Pilotes Nvidia propriétaires préinstallés. _{^{(Uniquement pour les images Nvidia)}}
Flathub activé par défaut.
Commandes ujust pour plus de commodité.
Codecs multimédia inclus dès l'installation.
Possibilité de revenir en arrière sur Bazzite à partir de n'importe quelle version des 90 derniers jours.

Fonctionnalités de Fedora Linux (Kinoite & Silverblue)

Base solide et stable.
Packages système relativement à jour.
Possibilité de superposer des packages Fedora à l'image sans les perdre entre les mises à jour.
Orienté sécurité avec SELinux préinstallé et configuré par défaut.
Capacité de rebaser sur différentes images Fedora Atomic, si désiré, sans perte de données utilisateur.
Prise en charge de l'impression grâce à l'installation préinstallée de CUPS.

Pourquoi

Bazzite a débuté comme un projet visant à résoudre certains des problèmes qui affectent SteamOS, principalement les packages obsolètes (malgré une base Arch) et le manque d'un gestionnaire de packages fonctionnel.

Bien que ce projet soit également basé sur des images, vous pouvez installer n'importe quel package Fedora directement depuis la ligne de commande. Ces packages persisteront à travers les mises à jour _{^{(Alors n'hésitez pas à installer ce logiciel VPN obscur sur lequel vous avez passé une heure à essayer de le faire fonctionner sous SteamOS)}}. De plus, Bazzite est mis à jour plusieurs fois par semaine avec des packages de Fedora, vous offrant ainsi les meilleures performances possibles et les dernières fonctionnalités - le tout sur une base stable.

Bazzite est livré avec le dernier noyau Linux et SELinux activé par défaut, avec prise en charge complète du démarrage sécurisé _{^{(Exécutez ujust enroll-secure-boot-key et entrez le mot de passe ublue-os si vous êtes invité à enregistrer notre clé)}} et du chiffrement des disques, en faisant une solution raisonnable pour l'informatique générale. ^{_{(Oui, vous pouvez imprimer depuis Bazzite)}}

Consultez la FAQ pour plus de détails sur ce qui distingue Bazzite des autres systèmes d'exploitation Linux.

Vitrine

Documentation et newsletters

Consultez la documentation supplémentaire concernant le projet.

Découvrez nos Newsletters publiés régulièrement pour les mises à jour sur le projet.

Packages personnalisés

Les paquets portés de SteamOS et ChimeraOS, entre autres utilisés par Bazzite, sont construits sur Copr dans bazzite et bazzite-multilib.

Package	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

De plus, les packages suivants sont utilisés à partir d'autres dépôts Copr :

Package	Status
discover-overlay
hhd
joycond
kernel-fsync
latencyflex-vulkan-layer
nerd-fonts
noise-suppression-for-voice
obs-vkcapture
ptyxis
rom-properties
steamdeck-kmod
system76-scheduler
wallpaper-engine-kde-plugin
webapp-manager

Vérification

Ces images sont signées avec cosign de sigstore. Vous pouvez vérifier la signature en téléchargeant la clé cosign.pub depuis ce dépôt et en exécutant la commande suivante :

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

Secure Boot

Warning

Utilisateurs de Steam Deck : Le Steam Deck ne vient pas avec le secure boot activé et n'inclut pas de clés inscrites par défaut. Ne l'activez pas à moins de savoir parfaitement ce que vous faites.

Le secure boot est pris en charge avec notre clé personnalisée. La clé publique peut être trouvée à la racine de ce dépôt ici. Si vous souhaitez inscrire cette clé avant l'installation ou le rebasage, téléchargez la clé et exécutez les commandes suivantes :

sudo mokutil --timeout -1
sudo mokutil --import secure_boot.der

Pour les utilisateurs déjà sur une image Universal Blue, vous pouvez plutôt exécuter ujust enroll-secure-boot-key.

Si on vous demande un mot de passe, utilisez ublue-os.

Métriques des contributeurs

Historique des étoiles

Remerciements spéciaux

Bazzite est un effort communautaire et ne serait pas possible sans le soutien de chacun. Voici quelques personnes qui nous ont aidés tout au long du chemin :

rei.svg - Pour la création de notre logo et de notre identité visuelle.
SuperRiderTH - Pour la création de notre vidéo de démarrage du mode jeu Steam.
evlaV - Pour avoir rendu le code de Valve disponible et pour être cette personne.
ChimeraOS - Pour gamescope-session et pour un soutien précieux tout au long du projet.
Jovian-NixOS - Pour le support technique et la création d'un projet similaire basé sur Nix. Allez voir, sérieusement.
sentry - Pour l'aide avec les correctifs du noyau nécessaires et pour avoir créé le repo kernel-fsync que nous utilisons maintenant.
nicknamenamenick - Pour maintenir quasiment seul notre documentation et notre littérature de support, et pour avoir aidé d'innombrables utilisateurs.
Steam Deck Homebrew - Pour choisir de soutenir des distributions autres que SteamOS malgré le travail supplémentaire, et un merci spécial à PartyWumpus pour avoir fait fonctionner Decky Loader avec SELinux pour nous.
cyrv6737 - Pour l'inspiration initiale et la base qui est devenue bazzite-arch.

Construisez le vôtre

Bazzite est entièrement construit sur GitHub et créer votre propre version personnalisée est aussi simple que de forker ce dépôt, ajouter une clé de signature privée et activer les actions GitHub.

Familiarisez-vous sur la gestion des secrets dans GitHub. Vous devrez générer une nouvelle paire de clés avec cosign. La clé publique peut être dans votre repo public _{^{(Vos utilisateurs en ont besoin pour vérifier les signatures)}}, et vous pouvez coller la clé privée dans Paramètres -> Secrets -> Actions avec le nom SIGNING_SECRET.

Nous expédions également une configuration pour l'application populaire pull app si vous souhaitez synchroniser votre fork avec l'original. Activez cette application sur votre repo pour suivre les modifications de Bazzite tout en apportant vos propres modifications.

Rejoignez la communauté

Vous pouvez nous trouver sur le Discord Universal Blue et consulter les archives des discussions de support sans compte.

Discutez et créez des guides utilisateur sur les forums Universal Blue Discourse.

Suivez Universal Blue sur Mastodon.

42 KiB Raw Blame History