📖 Documentation

🔥 ShivaOS Deck Edition

ShivaOS Deck est une édition spécialisée de ShivaOS optimisée pour les PC gaming portables : Steam Deck, ROG Ally, Legion Go, MSI Claw et autres. Elle est basée sur Fedora 44 Atomic (immutable) avec KDE Plasma 6.

Contrairement à une distribution classique, ShivaOS Deck est atomique : le système de base est en lecture seule, les mises à jour sont transactionnelles (rollback possible), et les applications sont gérées via Flatpak. Résultat : un système ultra-stable qui ne casse jamais.

💿 Installation

Prérequis

Préparer la clé USB

• Télécharger l'ISO

  Télécharge l'ISO ShivaOS Deck depuis la page d'accueil (section Télécharger).

• Flasher la clé USB

  Utilise Balena Etcher, Rufus (Windows) ou dd (Linux/Mac) avec une clé USB de 8 Go minimum.

  # Linux — remplacer /dev/sdX par ta clé USB
  sudo dd if=shivaos-deck.iso of=/dev/sdX bs=4M status=progress oflag=sync

• Booter sur la clé

  Redémarre et sélectionne la clé USB dans le menu boot (généralement F12, F11 ou Esc selon ta machine).

• Lancer l'installateur Anaconda

  L'installateur graphique Anaconda démarre automatiquement. Suis les étapes : langue, clavier, partitionnement, compte utilisateur.

• Redémarrer

  Une fois l'installation terminée, retire la clé USB et redémarre. ShivaOS Deck est prêt.

🚀 Premier boot

Au premier démarrage, ShivaOS Welcome se lance automatiquement — un assistant en 6 étapes pour configurer ton système.

• Bienvenue

  Présentation de ShivaOS Deck et sélection de la langue (FR/EN/ES).

• Pilote GPU

  Détection automatique de ton GPU. Pour NVIDIA : choix entre pilote open source et propriétaire. Pour AMD : tout est déjà configuré !

• Applications

  Installation rapide des apps Flatpak essentielles : Steam, Discord, Firefox, Lutris...

• Manette

  Détection et configuration de ta manette (Xbox, DualSense, 8BitDo...).

• Fond d'écran

  Choix parmi les wallpapers ShivaOS (dont 13 wallpapers manga dark space exclusifs).

• Prêt !

  Ton ShivaOS Deck est configuré. Lance Shiva Commander (icône dans la barre des tâches) pour gérer tes jeux et optimisations.

🎮 Session Gamescope

ShivaOS Deck inclut Gamescope, le compositeur gaming de Valve. Il permet de jouer en plein écran natif avec upscaling FSR, frame limiter précis et latence réduite — exactement comme sur Steam Deck.

Démarrer la session Gamescope

Au login SDDM, clique sur le sélecteur de session (en bas à gauche) et choisis "Gamescope Session". Steam se lance automatiquement en mode Big Picture.

Options de lancement Gamescope

# Exemple : upscaling 1280x800 → 1920x1200 avec FSR2
gamescope -w 1280 -h 800 -W 1920 -H 1200 --fsr-upscaling -r 60 -- %command%

# Limiter à 30 FPS (économie batterie)
gamescope -r 30 -- %command%

# Mode VRR (si écran compatible)
gamescope --adaptive-sync -- %command%

Paramètres recommandés par device

🎯 Steam & Proton

Steam est installé via Flatpak. Proton GE (version community avec plus de compatibilité) peut être installé depuis Shiva Commander → Proton-GE.

Activer Proton pour les jeux Windows

• Paramètres Steam → Compatibilité

  Active "Activer Steam Play pour tous les autres titres" et sélectionne Proton Experimental ou Proton GE.

• Options de lancement (par jeu)

  Clic droit sur le jeu → Propriétés → Options de lancement. ShivaOS pré-configure les optimisations via shiva-game-launch.

Variables d'environnement utiles

# Activer MangoHud overlay
MANGOHUD=1 %command%

# Low Latency Layer (Reflex + Anti-Lag sur tous GPU)
PROTON_FORCE_NVAPI=1 LOW_LATENCY_LAYER_REFLEX=1 %command%

# Forcer Vulkan + RADV (AMD)
RADV_PERFTEST=gpl,rt %command%

# Désactiver anti-cheat (jeux non-compatibles)
PROTON_NO_ESYNC=1 PROTON_NO_FSYNC=1 %command%

🏆 Lutris & Heroic

Pour les jeux GOG, Epic Games et Amazon, installe Heroic Games Launcher ou Lutris via Flatpak depuis Shiva Commander → Apps.

⚙️ Shiva Commander

Shiva Commander est le hub gaming central de ShivaOS. Lance-le depuis la barre des tâches (icône ShivaOS). Il regroupe tout en un seul endroit.

🔋 TDP & Énergie — HHD

Handheld Daemon (HHD) est l'outil central de gestion de l'énergie sur les PC portables gaming. Il permet de contrôler le TDP (consommation CPU/GPU), la vitesse du ventilateur, et le profil de performance — exactement comme SteamOS sur Steam Deck.

Interface HHD

Accède à HHD via System Settings → HHD ou via l'interface web locale : http://localhost:5335

Profils TDP recommandés

Compatibilité HHD par device

⚡ Kernel BORE

BORE (Burst-Oriented Response Enhancer) est un patch du scheduler Linux qui mesure la "burstiness" de chaque tâche. Les processus interactifs (jeux, audio, UI) sont automatiquement prioritaires sur les tâches batch (compilation, IO). Résultat : moins de stuttering sous charge, latence réduite.

Vérifier le kernel actif

uname -r
# Attendu : 7.0.10-200.shivaos1.fc44.x86_64

rpm-ostree status
# Montre le déploiement actif et le suivant

BBR3 — Réseau optimisé

Le kernel inclut BBR3 comme algorithme de contrôle de congestion TCP par défaut. Les téléchargements Steam et les jeux online bénéficient d'une meilleure utilisation de la bande passante.

🔧 Scheduler SCX

ShivaOS inclut scx_rusty et scx_layered — des schedulers alternatifs en espace utilisateur basés sur eBPF. Ils peuvent améliorer la réactivité sur certains jeux.

Activer scx_rusty

# Activer pour la session courante
sudo systemctl start scx_rusty

# Activer au démarrage
sudo systemctl enable scx_rusty

# Revenir au scheduler kernel par défaut
sudo systemctl stop scx_rusty

📊 MangoHud

MangoHud est l'overlay de monitoring gaming installé par défaut sur ShivaOS Deck. Il affiche FPS, frametime, CPU/GPU usage, température, VRAM — en jeu.

Activer MangoHud

Dans Steam, ajoute à chaque jeu : MANGOHUD=1 %command%

Ou active-le globalement dans GOverlay (Menu Démarrer → GOverlay).

Configuration

# Fichier de config
~/.config/MangoHud/MangoHud.conf

# Exemple de config compacte gaming portable
fps
frametime
gpu_stats
cpu_stats
ram
battery
time
round_corners=5

Raccourcis clavier

🕹️ Manettes & InputPlumber

InputPlumber est le système de gestion des contrôleurs sur ShivaOS Deck. Il gère le mapping des boutons, le gyroscope, et la compatibilité Steam Input de manière universelle.

Devices supportés

🔵 DualSense PS5

La DualSense est entièrement supportée sur ShivaOS Deck, en USB et Bluetooth. Les gâchettes adaptatives et le retour haptique fonctionnent dans les jeux compatibles via Steam.

Connexion Bluetooth

• Mode appairage

  Maintiens PS + Create (bouton à gauche du pavé tactile) jusqu'à ce que la LED clignote rapidement.

• Connexion système

  Dans KDE : Paramètres système → Bluetooth → Appareils → "DualSense Wireless Controller".

• Gyroscope

  Le gyroscope DualSense est géré par SDGyroDSU (inclus). Active-le dans les options Steam pour les jeux FPS (aim with motion).

LED & haptique

# Changer la couleur LED (dualsensectl)
dualsensectl -d /dev/hidraw0 lightbar 255 107 0  # Orange ShivaOS
dualsensectl -d /dev/hidraw0 microphone-led on
dualsensectl -d /dev/hidraw0 player-leds 1

🟢 Xbox & 8BitDo

Les manettes Xbox sont supportées nativement (USB) et via Bluetooth grâce à xone (dongle sans fil Xbox) et xpadneo (Xbox Elite BT).

8BitDo — Mode correct

Pour une compatibilité maximale, configure ta 8BitDo en mode Xinput (bouton Start + R tenu 3 secondes au démarrage). La LED doit s'allumer en vert.

🔄 Mises à jour

ShivaOS Deck se met à jour automatiquement en arrière-plan. Les mises à jour sont atomiques : elles sont téléchargées et préparées pendant que tu joues, puis appliquées au prochain redémarrage. Aucune interruption.

Mise à jour manuelle

# Vérifier les mises à jour disponibles
rpm-ostree upgrade --check

# Télécharger et préparer la mise à jour
rpm-ostree upgrade --download-only

# Via Shiva Commander → onglet MAJ

Rollback

Si une mise à jour cause un problème, reviens à la version précédente en 30 secondes :

# Revenir au déploiement précédent
rpm-ostree rollback
systemctl reboot

🤖 Shiva AI

Shiva AI est l'assistant IA intégré à ShivaOS. Il connaît parfaitement le système et peut t'aider à diagnostiquer des problèmes, optimiser les performances, et répondre à des questions gaming.

Terminal

# Lancer depuis n'importe quel terminal
shiva

# Exemples de questions
"Mon jeu ram plante, que faire ?"
"Comment activer HDR sur mon moniteur ?"
"Quel TDP recommandes-tu pour Elden Ring ?"

Overlay (Super+A)

L'overlay IA flottant se lance avec Super+A. Il reste au-dessus des jeux et répond instantanément sans quitter le jeu.

📦 Distrobox

Distrobox permet de faire tourner n'importe quelle distribution Linux dans un container intégré — accès aux gestionnaires de paquets (apt, dnf, pacman) sans modifier le système de base.

Créer un container Ubuntu

# Créer un container Ubuntu 24.04
distrobox create --name ubuntu --image ubuntu:24.04

# Entrer dans le container
distrobox enter ubuntu

# Installer des paquets (reste dans le container)
sudo apt install mon-paquet

# Exporter une application dans le menu KDE
distrobox-export --app nom-app

❓ FAQ

sudo waydroid init
sudo systemctl start waydroid-container
waydroid session start
waydroid show-full-ui

🔧 Dépannage

Logs système

# Logs du dernier boot (erreurs kernel, services)
journalctl -b -p err

# Logs d'un service spécifique
journalctl -u nom-du-service -f

# Logs Xorg/Wayland
journalctl -b | grep -i "plasma\|wayland\|sddm"

Réparer le système

# Rollback vers la version précédente
rpm-ostree rollback && reboot

# Réinstaller un paquet corrompu
rpm-ostree override reset nom-paquet

# Forcer la recompilation des modules NVIDIA
sudo akmods --force && sudo dracut --force

Problèmes courants