Documentation

Wiki — ShivaOS Steam Edition

Documentation officielle de ShivaOS Steam Edition. Une image Linux Atomic dédiée au gaming console — boot direct Steam Big Picture, 100% AMD, zéro configuration.

Installation

Prérequis

PC AMD (Ryzen + Radeon) — NVIDIA non supporté
Clé USB 8 Go minimum
Démarrage UEFI activé dans le BIOS
50 Go de stockage minimum (100 Go recommandé)

Étapes

Téléchargez l'ISO sur la page Téléchargement (bientôt disponible)
Flashez sur USB avec Balena Etcher, Rufus ou dd
Bootez sur la clé USB (F12 / F2 selon votre BIOS)
Sélectionnez votre disque dans Anaconda — c'est la seule question posée
Attendez la fin de l'installation (~5 min) puis retirez la clé et redémarrez

✓ C'est tout L'installateur crée automatiquement le compte shivaos sans mot de passe, configure l'autologin SDDM et démarre directement dans Steam Big Picture.

Premier boot

Au premier démarrage, le système installe automatiquement Steam, Heroic, Bottles, Lutris, Discord, Moonlight et Kodi via Flatpak (connexion internet requise). Cette opération prend 5 à 10 minutes selon votre connexion. Le ShivaOS Hub démarre en premier — Steam s'ouvre via une tuile.

ℹ INFO Si Steam ne s'ouvre pas immédiatement, attendez 5 minutes et redémarrez. L'installation Flatpak se fait en arrière-plan au premier boot uniquement.

Compte utilisateur

Nom d'utilisateur : shivaos
Mot de passe : aucun (compte passwordless)
Sudo : sans mot de passe (NOPASSWD:ALL)
Autologin SDDM : activé → session KDE Plasma → ShivaOS Hub au démarrage

Mises à jour

ShivaOS Steam Edition se met à jour automatiquement. Le service rpm-ostreed-automatic.timer vérifie quay.io/freuja/shivaos-steam:latest en arrière-plan. La mise à jour est stagée silencieusement et appliquée au prochain redémarrage.

Mise à jour manuelle

Depuis le bureau KDE (voir Passer au bureau KDE), ouvrez un terminal :

rpm-ostree upgrade && systemctl reboot

✓ AUCUNE ACTION REQUISE En utilisation console normale, vous n'avez jamais besoin de lancer une mise à jour manuellement.

ShivaOS Hub

ShivaOS Hub (shiva-deck-hub) est l'interface PS5-style qui se lance automatiquement au démarrage de KDE, avant Steam. Organisé en 5 sections navigables à la manette, il donne accès à tous vos jeux et outils sans clavier ni souris.

5 sections

Section	Contenu
🕹 RÉCENTS	8 derniers jeux joués avec hero art en fond
🎮 GAMING	Steam · Bibliothèque · Heroic · Lutris · Bottles · GeForce NOW · Xbox Cloud
🛠 APPS	Discord · Spotify · Firefox · OBS · Kodi · ProtonPlus · MangoHud · ProtonDB · Commander
⚙ SYSTÈME	Réseau · Sysinfo · Stockage · Logs · ShivaID · MAJ · Session · TDP · Bureau
📚 MES JEUX	Bibliothèque complète Steam + Heroic, temps de jeu, fiche jeu avec badge ProtonDB

Barre du haut

Élément	Description
⚡ Badge TDP	Profil actif (Éco 5W / Équilibré 12W / Perf 18W / Turbo 25W) — clic ou LT pour cycler
🔔 Notifications	Alertes MAJ, trophées débloqués, amis connectés
🏆 Trophées	Compteur X/15 trophées ShivaID débloqués
🌤 Météo	Ville + température auto-détectées dans le hero

Contrôles manette

Bouton	Action
D-Pad / Stick gauche	Naviguer entre les tuiles
🅐 A / Entrée	Lancer l'application sélectionnée
🅑 B / Échap	Fermer un panneau ouvert
🅧 X	Reprendre le dernier jeu joué
🅨 Y	Rechercher un ami ShivaID
LB / RB	Changer de section
LT	Cycler le profil TDP (Éco → Équilibré → Perf → Turbo)
Guide (⊙)	Ouvrir / fermer ShivaID
LB + RB + Select	Capture d'écran hub

ℹ INFO Le bouton ⏩ REPRENDRE (ou X manette) relance directement le dernier jeu sans naviguer dans la bibliothèque.

Steam & Proton

Steam est installé via Flatpak au premier boot. La compatibilité Proton est activée par défaut pour tous les jeux Windows.

Activer Proton pour tous les jeux

Dans Steam → Paramètres → Compatibilité → Activer Steam Play pour tous les titres → Choisir la version Proton.

✓ RECOMMANDÉ Utilisez Proton-GE pour une meilleure compatibilité. Installez-le via Shiva Commander (sur l'image KDE) ou manuellement.

Options de lancement recommandées

MANGOHUD=1 %command%                    # Activer MangoHud
PROTON_FORCE_NVAPI=1 %command%          # Low Latency Layer (Reflex)
gamemoderun %command%                   # GameMode
MANGOHUD=1 gamemoderun %command%        # Tout en même temps

ProtonPlus / Proton-GE

ProtonPlus est un gestionnaire graphique de versions Proton alternatifs. Il permet d'installer et de gérer Proton-GE (GloriousEggroll), qui offre une meilleure compatibilité pour de nombreux jeux.

Installation via le Hub

Ouvrez le Hub → tuile ProtonPlus
Sélectionnez Proton-GE dans la liste
Cliquez Installer — la version est disponible immédiatement dans Steam

Utiliser Proton-GE dans Steam

Propriétés du jeu dans Steam → Compatibilité → Forcer l'utilisation d'un outil de compatibilité Steam spécifique → Proton-GE-X.XX

✓ RECOMMANDÉ Proton-GE améliore les jeux EAC (Easy Anti-Cheat), les jeux avec des cutscènes vidéo, et de nombreux titres refusant de démarrer avec le Proton officiel.

MangoHud

MangoHud est pré-installé et pré-configuré. Il affiche FPS, temps de frame, température GPU/CPU, usage VRAM, fréquence GPU en superposition.

Activation

Dans les options de lancement Steam du jeu :

MANGOHUD=1 %command%

⚠ ATTENTION La variable correcte est MANGOHUD=1 et non ENABLE_MANGOHUD=1 (ancienne syntaxe qui ne fonctionne pas).

Configuration

Le fichier de configuration est à /etc/MangoHud/MangoHud.conf. Pour le modifier depuis le bureau KDE :

sudo nano /etc/MangoHud/MangoHud.conf

Gamescope

Gamescope est le compositeur Wayland utilisé par Steam Big Picture. Il gère la résolution, le framerate et les fonctionnalités comme FSR.

Configuration par défaut

Paramètre	Valeur
Résolution	1920×1080
Fréquence	60 Hz
Plein écran	Oui
Sans bordure	Oui

Changer la résolution / fréquence

Depuis Steam Big Picture, sans quitter la session :

Steam → ⚙ Paramètres → Affichage → Résolution / Fréquence d'affichage

✓ SANS TERMINAL Gamescope détecte automatiquement la résolution native de votre écran via EDID. La plupart du temps il n'y a rien à régler — branchez votre TV 4K et Gamescope s'y adapte.

FSR (FidelityFX Super Resolution)

Steam → ⚙ Paramètres → Affichage → Mise à l'échelle → FSR.

Mode Gamescope Session (optionnel)

Par défaut, ShivaOS Steam Edition démarre en KDE Plasma avec Steam en autostart. Un mode alternatif dit "gamescope-session-steam" est disponible — il lance Gamescope directement sans KDE (mode console pur, comme SteamOS).

⚠ DIFFÉRENCE Le mode par défaut (KDE + Steam autostart) est plus compatible et permet d'accéder au bureau facilement. Le mode gamescope-session est plus léger mais n'a pas de bureau KDE accessible sans manipulation.

Activer le mode Gamescope Session

Depuis le bureau KDE, dans un terminal :

# Passer en mode gamescope-session-steam (plus léger, comme SteamOS)
sudo systemctl set-default graphical.target
# Modifier le gestionnaire de session dans plasmalogin.conf
sudo nano /etc/plasmalogin.conf
# Changer : Session=gamescope-session-steam
sudo systemctl reboot

Revenir au mode KDE + Steam autostart

sudo nano /etc/plasmalogin.conf
# Changer : Session=plasma
sudo systemctl reboot

✓ ASTUCE La tuile "Session" du Hub ShivaOS permet de basculer entre les deux modes sans terminal.

Kodi

Kodi (media center) est installé au premier boot via Flatpak. Il permet de lire films, séries, musique et d'accéder à vos fichiers locaux ou serveurs Plex/Jellyfin depuis l'interface console.

Lancer Kodi

Depuis le Hub → tuile Kodi
Ou depuis Steam Big Picture → Jeux non-Steam (si ajouté comme raccourci)

Ajouter Kodi comme raccourci Steam

Depuis Steam → Bibliothèque → + Ajouter un jeu → Ajouter un produit non-Steam → sélectionner Kodi. Il apparaîtra dans Big Picture.

ℹ INFO Kodi supporte les manettes nativement. Utilisez votre DualSense ou Xbox pour naviguer dans l'interface media center sans clavier.

Manettes

Manette	Connexion	Statut
DualSense (PS5)	USB / Bluetooth	✓ Natif
DualShock 4 (PS4)	USB / Bluetooth	✓ Natif
Xbox Series X/S	USB / Bluetooth	✓ Natif
Xbox Elite	Bluetooth	✓ xpadneo
Xbox Wireless	Dongle USB	✓ xone
8BitDo	USB / Bluetooth	✓ Natif
Steam Controller	Dongle USB	✓ Natif

✓ ASTUCE Sur Steam Deck et autres handhelds, InputPlumber configure automatiquement les contrôles intégrés et les boutons physiques du handheld.

Drivers manettes spécifiques

Driver	Usage	Statut
`akmod-xpadneo`	Xbox Elite / One S Bluetooth (rumble avancé)	✓ Pré-installé
`akmod-xone`	Xbox One dongle USB sans fil	✓ Pré-installé
`inputplumber`	Legion Go, ROG Ally, handhelds — profils unifiés	✓ Pré-installé
`asusctl`	ROG Ally — LEDs, modes performance, boutons ROG	✓ Pré-installé
`SDGyroDSU`	DualSense — gyroscope pour émulateurs	✓ Pré-installé

InputPlumber — handhelds

InputPlumber gère les contrôles physiques intégrés de vos handhelds. Il tourne en service système et expose les boutons spéciaux (bouton ROG, bouton M1/M2 Legion) comme des événements gamepad standard reconnus par Steam.

# Vérifier que InputPlumber tourne
systemctl status inputplumber

# Redémarrer si la manette n'est pas détectée
sudo systemctl restart inputplumber

Clavier virtuel (maliit)

ShivaOS Steam Edition inclut maliit-keyboard, un clavier virtuel tactile optimisé pour les handhelds et les écrans tactiles. Il s'active automatiquement lors de la saisie de texte dans Steam Big Picture ou dans le bureau KDE sur les appareils tactiles.

Utilisation

Steam Big Picture inclut son propre clavier intégré (bouton "Y" sur la manette lors d'un champ texte)
Dans KDE Plasma (bureau) : le clavier maliit s'active sur les champs de saisie tactile
Sur ROG Ally et Legion Go : fonctionne avec l'écran tactile intégré

ℹ INFO Pour les PC bureau sans écran tactile, le clavier virtuel n'est pas nécessaire — Steam Big Picture gère la saisie via manette nativement.

Kernel BORE ShivaOS

ShivaOS utilise un kernel Fedora vanilla patché avec BORE (Burst-Oriented Response Enhancer). BORE mesure la "burstiness" de chaque processus — les tâches interactives comme les jeux obtiennent toujours la priorité sur les tâches batch comme les compilations.

Comparaison avec SteamOS

Fonctionnalité	ShivaOS Steam	SteamOS 3
Base	Fedora 44 Atomic	Arch Linux
Scheduler	BORE (gaming)	Vanilla EEVDF
TCP	BBR3	CUBIC
MAJ kernel	Automatiques	Quand Valve décide
Immuable	Oui (ostree)	Partiel

Passer au bureau KDE

ShivaOS Steam Edition inclut KDE Plasma complet. Pour accéder au bureau (configuration avancée, terminal, fichiers) :

Dans Steam Big Picture → Menu → Quitter Steam
L'écran de login SDDM apparaît — sélectionnez la session Plasma (Wayland)
Connectez-vous avec l'utilisateur shivaos (sans mot de passe)

ℹ INFO Pour revenir automatiquement à Steam au prochain démarrage, ne faites rien — l'autologin gamescope-session-steam est toujours actif.

Rollback

Si une mise à jour cause un problème, revenez à la version précédente en une commande depuis le bureau KDE :

rpm-ostree rollback && systemctl reboot

✓ SÉCURITÉ rpm-ostree conserve toujours le déploiement précédent. Un rollback est toujours possible.

Steam Deck

Le Steam Deck est détecté automatiquement via DMI au démarrage. HHD configure les contrôles intégrés, les boutons de tranche et le gyroscope.

⚠ EXPÉRIMENTAL ShivaOS Steam Edition n'a pas encore été testé sur vrai hardware Steam Deck. La détection DMI est en place mais nous n'avons pas de retour terrain. Rejoignez le Discord pour partager votre expérience.

ROG Ally

Le ROG Ally (RC71L et RC72LA) est détecté via DMI. HHD gère les boutons ROG et la détection des modes de performance. ASUS ROG Control Center (asusctl) est pré-installé.

⚠ EXPÉRIMENTAL Non testé sur hardware physique. Si vous avez un ROG Ally, rejoignez le Discord — votre retour est précieux.

Legion Go

Le Lenovo Legion Go (83E1, AMD Ryzen Z1 Extreme) est détecté via DMI. InputPlumber gère les boutons spéciaux M1, M2 et le mode FPS (mode souris de la manette droite). asusctl n'est pas requis sur ce modèle.

⚠ EXPÉRIMENTAL Non testé sur hardware physique. Si vous avez un Legion Go, rejoignez le Discord — votre retour est précieux pour améliorer le support.

Conseils Legion Go

Mode FPS (manette droite en souris) : fonctionne via InputPlumber en mode "desktop"
Résolution native 2560×1600 : configurable depuis Steam → Paramètres → Affichage
TDP : contrôlable via la tuile TDP du Hub ou ryzenadj

Valve Steam Machine

La nouvelle Valve Steam Machine (AMD Ryzen 9 7950X3D + Radeon RX 7900 XTX, 2025) est détectée automatiquement via la chaîne DMI "Steam Machine". Les drivers AMD/RDNA3 sont pris en charge nativement par Mesa/RADV sur Fedora 44.

🍌 FUN FACT Valve a littéralement livré leur Steam Machine avec une banane en plastique dans la boîte. ShivaOS tourne dessus quand même.

Paquets spécifiques Steam Machine

RGB : OpenRGB pré-installé pour les 17 LEDs de la barre lumineuse
Steam Controller : dongle USB intégré détecté automatiquement
RDNA3 : RADV avec ray tracing hardware activé

FAQ

Peut-on installer des jeux Epic, GOG, etc. ?

Oui — Heroic Games Launcher (Epic + GOG) et Bottles (Windows via Wine) sont installés au premier boot. Utilisez-les depuis Steam Big Picture en ajoutant les jeux comme raccourcis non-Steam.

Peut-on passer à l'image KDE standard ?

Oui, depuis un terminal dans KDE :

sudo bootc switch quay.io/freuja/shivaos:latest && systemctl reboot

Est-ce que NVIDIA est supporté ?

Non. ShivaOS Steam Edition est 100% AMD. Pour les PC NVIDIA, utilisez ShivaOS KDE qui inclut les drivers NVIDIA open.

Comment mettre un mot de passe sur le compte ?

Depuis un terminal dans KDE :

passwd shivaos

Moonlight / streaming gaming à distance ?

Moonlight est installé au premier boot. Sunshine (le serveur) est également pré-installé sur l'image — utile pour streamer vos jeux vers un autre écran.

👤 ShivaID

ShivaID est ton compte gaming universel ShivaOS — profil, 448 trophées, amis, messages privés, vocal en temps réel. Gratuit, sans pub.

→ shivaos.com/shivaid.php

Fonctionnalités

Profil — pseudo, avatar (DiceBear / Gravatar / image perso), badge Early Adopter si tu fais partie des 100 premiers
448 trophées — temps de jeu, hardware, communauté, Easter eggs, jeux spécifiques…
Liaison Steam — bouton 🔗 Lier Steam dans le profil → avatar + pseudo Steam
💬 Messages privés 1-to-1 — chat en temps réel avec tes amis, notifications toast + badge dans le hub
🎙 Vocal (invitation) — salon vocal privé, seuls les amis invités peuvent rejoindre
🟢 Présence live — vois tes amis en ligne instantanément via WebSocket

Démo publique

Pas de compte ? Demo vocale publique — entre un pseudo et rejoins le salon de test sans inscription.

Phase 2 — Stats gaming

Sync Steam automatique — au login, tes jeux Steam sont synchronisés (heures totales + 2 semaines récentes) sans action de ta part
Graphique 7 jours ShivaOS — heures jouées via le Hub cette semaine, par jeu
Trophées playtime automatiques — 1h, 5h, 10h, 25h, 50h, 100h, 200h, 500h, 1000h, 2000h débloqués automatiquement
Sync manuelle (bouton 🔄) — sync complète avec scores ProtonDB par jeu

Phase 3 — Amis en temps réel

🎮 En train de jouer — quand tu lances un jeu depuis le Hub, tes amis le voient en temps réel dans leur liste
Notification navigateur — si un ami commence à jouer pendant que tu as ShivaID ouvert, tu reçois une notification desktop
Refresh automatique — la liste amis se met à jour toutes les 30 secondes
Profil public — chaque joueur a une page publique : shivaos.com/shivaid.php?user=USERNAME

Phase 4 — Sync cross-appareils

TDP automatique — le profil TDP (Éco/Équilibré/Perf/Turbo) est sauvegardé dans le cloud et restauré au prochain login
Volume & Luminosité — idem, synchronisés automatiquement

Leaderboard FPS

Dans le Hub (onglet ShivaID → FPS) : classement des meilleurs FPS par jeu, soumis par la communauté. Après une session avec MangoHUD actif, le Hub propose automatiquement de soumettre tes perfs.

ShivaOS Lab

Bibliothèque de configs de jeux partagées par la communauté : launch options Steam, version Proton, config MangoHUD, tweaks DXVK. Installables en 1 clic (copie des launch options).

→ shivaos.com/lab.php · → Communauté

Dépannage

Steam ne démarre pas au boot

Vérifiez que les Flatpaks sont installés :

flatpak list | grep Steam
# Si absent :
flatpak install flathub com.valvesoftware.Steam

Écran noir après le login

Gamescope nécessite un GPU AMD fonctionnel. Vérifiez les logs :

journalctl -b -u sddm --no-pager | tail -30

MangoHud ne s'affiche pas

Utilisez MANGOHUD=1 (pas ENABLE_MANGOHUD=1) dans les options de lancement Steam.

La manette n'est pas reconnue

Redémarrez InputPlumber depuis le bureau KDE :

sudo systemctl restart inputplumber

Comment voir les logs de démarrage ?

journalctl -b --no-pager | less
journalctl -b -u gamescope-session-steam --no-pager