Hyprnux Installer English

Installer Hyprnux

Hyprnux s’installe sur un Arch Linux que vous avez déjà, depuis un terminal : vous ajoutez le dépôt Hyprnux une fois, puis vous installez les composants que vous voulez.

  • Paquets pacman
  • Paquets signés
  • Depuis les sources sur les autres distributions

Quel parcours ?

  • Un Arch Linux que vous avez déjà

    Suivez les étapes ci‑dessous, depuis un terminal. C’est la façon d’installer Hyprnux aujourd’hui. Il faut Arch et un terminal pour l’installer ; l’utiliser n’en demande aucun.

  • Une autre distribution

    Compilez les paquets depuis leurs sources : le PKGBUILD de chaque paquet (sa recette de paquet), dans le dépôt des sources, liste les étapes. Seuls les paquets pacman sont publiés.

  • Un ordinateur sans Linux

    Indisponible

    Une image d’installation graphique existe mais n’est pas publiée : cette page ne peut donc pas vous guider dans une première installation de Linux.

En bref

Cinq étapes : vérifier ce que vous avez, ajouter le dépôt, installer, démarrer et, si vous le voulez, changer l’écran de connexion. Les paquets sont signés, et vous vérifiez la clé avant de lui faire confiance.

Sur une machine installée depuis l’image d’installation de Hyprnux, chaque édition a aussi le disque chiffré, le pare-feu et la synchronisation de l’heure sécurisée. Sur votre propre Arch, vous obtenez les paquets signés ; le reste, vous le configurez vous-même.

Nouveau sur Arch ?

pacman est l’installateur de logiciels d’Arch. Un dépôt est une source de logiciels qu’il lit. Vous ajoutez le dépôt Hyprnux une fois, puis vous en installez des paquets comme de n’importe quel autre.

  1. Vérifiez ce que vous avez

    Arch Linux avec systemd. pacman est fourni avec Arch.

    Prérequis : un PC x86_64, hyprland 0.56 ou plus récent (le gestionnaire de fenêtres) et quickshell 0.3 ou plus récent (la boîte à outils avec laquelle la barre est dessinée), tous deux dans les dépôts d’Arch. Les paquets Hyprnux viennent du dépôt Hyprnux.

  1. Ajoutez le dépôt Hyprnux

    Une fois par machine. Récupérez d’abord la clé du dépôt et vérifiez-la :

    curl -fsSLO https://www.hyprnux.org/hyprnux.gpg gpg --show-keys hyprnux.gpg

    La ligne sous pub doit indiquer BF3FA18AE63F226028A83A2E3DA59F85B9821E2C Si ce n’est pas le cas, arrêtez-vous. Sinon, faites confiance à la clé dans pacman :

    sudo pacman-key --add hyprnux.gpg sudo pacman-key --lsign-key BF3FA18AE63F226028A83A2E3DA59F85B9821E2C

    Ajoutez ensuite ce bloc à /etc/pacman.conf, au-dessus de la ligne [core], une seule fois. Le premier dépôt qui a un paquet l’emporte : les paquets propres à Hyprnux sont donc trouvés en premier. SigLevel = Required DatabaseRequired fait refuser à pacman tout paquet ou toute base de ce dépôt sans signature valide :

    [hyprnux-core] SigLevel = Required DatabaseRequired Server = https://repo.hyprnux.org/$repo/os/$arch

    C’est le dépôt de l’édition Community, qui suit Arch de près.

    Ou l’ajouter depuis le terminal

    Lancez cette ligne au lieu de modifier le fichier. Elle ajoute le bloc au-dessus de [core] uniquement s’il n’y est pas déjà :

    grep -q '^\[hyprnux-core\]' /etc/pacman.conf || sudo sed -i '/^\[core\]/i [hyprnux-core]\nSigLevel = Required DatabaseRequired\nServer = https://repo.hyprnux.org/$repo/os/$arch\n' /etc/pacman.conf

  2. Installez

    Si Hyprland charge déjà un plugin hyprglass, retirez d’abord sa ligne de votre configuration Hyprland : deux copies peuvent provoquer un plantage de Hyprland. Déconnectez-vous ensuite et lancez l’installation depuis une console texte, ouverte avec Ctrl + Alt + F3 : un Hyprland en marche peut recharger sa configuration pendant l’installation.

    Tout le bureau en une commande, pour un ordinateur installé depuis l’image Hyprnux ou qui utilise déjà dracut. Sur un Arch avec mkinitcpio et un disque chiffré, prenez l’installation minimale ci‑dessous. hyprnux-edition-community nomme l’édition ; sans nom, pacman demande.

    sudo pacman -Syu hyprnux-desktop hyprnux-edition-community
    Ce qu’elle change

    pacman n’active rien : l’écran de connexion reste désactivé tant que vous ne basculez pas dessus (voyez « Facultatif : passez à l’écran de connexion Hyprnux » plus bas). Un pare-feu ou un service d’horloge que vous utilisez déjà (nftables, chronyd) charge les réglages de Hyprnux à son prochain démarrage, et /etc/os-release devient celui de Hyprnux. Le guide d’installation liste tout ce qu’il faut savoir avant de la lancer.

    Voici les cinq paquets que la plupart des gens veulent, en une seule commande. hyprnux-keyring tient à jour la clé du dépôt :

    sudo pacman -Syu sudo pacman -S hyprnux-keyring hyprnux-shell \ hyprnux-settings hyprglass hyprnux-hyprland

    Ou uniquement certains composants : nommez les paquets que vous voulez dans la liste ci‑dessous. Réglages est le plus simple pour commencer. Une mise à jour se fait avec sudo pacman -Syu.

    ComposantPaquetBon à savoir
    Clé du dépôthyprnux-keyringContient la clé avec laquelle le dépôt Hyprnux signe, et la tient à jour.
    Le shellhyprnux-shellLa barre, le lanceur et les panneaux du bureau. Il apporte hyprnux-palette, qui fabrique le jeu de couleurs à partir du fond d’écran.
    Réglageshyprnux-settingsS’installe seul. N’a pas besoin du shell.
    HyprglasshyprglassLe plugin d’effets de verre. Lisez la note au-dessus de la commande si votre Hyprland en charge déjà un.
    Configuration Hyprlandhyprnux-hyprlandLa configuration que reçoit un compte qui n’a pas de hyprland.lua.
    L’écran de connexionhyprnux-loginFacultatif, absent de la commande ci‑dessus. Vous devez remplacer vous-même sddm (ou gdm) par greetd.
    Premier démarragehyprnux-firstbootFacultatif, absent de la commande ci‑dessus. Seul l’installateur de Hyprnux l’active : sur votre propre Arch, il n’a aucun effet visible, et il ajoute dracut. Sur un nouvel ordinateur, il pose quelques questions, comme la langue et le clavier, puis crée le premier compte. Si votre Arch utilise mkinitcpio, lisez la note sur mkinitcpio.

  3. Démarrez

    Déconnectez-vous, choisissez la session Hyprland sur votre écran de connexion et connectez-vous. Avec le shell installé, la barre et le lanceur apparaissent.

    La session est l’entrée qu’ajoute le paquet hyprland. Pour revenir en arrière, déconnectez-vous et choisissez de nouveau votre session précédente.

  4. Facultatif : passez à l’écran de connexion Hyprnux

    Cette étape remplace votre gestionnaire de connexion actuel, et les autres composants fonctionnent sans elle. Avant de changer, déplacez ce que vous gardez dans ~/.zshenv ou ~/.zprofile vers environment.d ou vers l’environnement propre à Hyprland, car greetd, le programme qui gère les connexions et lance votre session, ne lit que /etc/profile et ~/.profile à la connexion.

    Une fois par machine. Vous devez remplacer vous-même sddm (ou gdm) par greetd : installez hyprnux-login, désactivez votre gestionnaire de connexion actuel, sddm ou gdm, selon celui qui est actif, puis activez greetd. La commande ci‑dessous nomme sddm : écrivez gdm à la place si c’est celui qui est actif. Le changement prend effet au prochain démarrage.

    sudo pacman -S hyprnux-login sudo systemctl disable sddm sudo systemctl enable greetd

Choisissez une édition

Les étapes ci‑dessus mettent en place l’édition Community, qui suit Arch de près. Pro et Enterprise sont le même bureau avec d’autres politiques de mise à jour et de sécurité. Comparez-les sur la page Éditions, ou lisez le guide complet pour voir ce que chacune change. Aujourd’hui, seule Community peut être installée : les machines Pro et Enterprise partent de l’image d’installation de Hyprnux, qui n’est pas publiée.

Pour les experts

L’utiliser avec votre propre configuration

Un compte qui n’a pas de ~/.config/hypr/hyprland.lua reçoit la configuration Hyprnux : il n’y a rien à ajouter. Votre propre fichier reste tel quel : ajoutez une fois les lignes correspondant à ce que vous avez installé. Ne gardez qu’une seule ligne qui charge hyprglass.

ObjectifPaquetsÀ ajouter
Le shell uniquement
hyprnux-shell
require("/usr/share/hyprnux/shell/hyprland/hyprnux-shell")
Le shell et Hyprglass
hyprnux-shell, hyprglass
hl.plugin.load("/usr/lib/hyprglass/hyprglass.so")require("/usr/share/hyprnux/shell/hyprland/hyprnux-shell")
Toute la configuration Hyprland de Hyprnux
hyprnux-hyprland
require("/usr/share/hyprnux/hyprland/hyprland")
Réglages uniquement
hyprnux-settings
Rien.

Avec hyprnux-hyprland, le shell et Hyprglass se chargent d’eux-mêmes : n’ajoutez aucune autre ligne pour eux. La ligne du shell ne fait rien si son fichier est déjà chargé.

À propos du dépôt

Aucun des paquets ne déclare replaces : aucun ne prend la place d’un paquet d’Arch. Deux déclarations existent : hyprnux-login fournit greetd-greeter, le nom générique d’un écran de connexion greetd, et hyprnux-shell est en conflit avec deux anciens paquets d’aide de Hyprnux.

Pour voir ce que contient le dépôt :

pacman -Sl hyprnux-core
Installer depuis des fichiers de paquets

Si vous avez reçu des fichiers de paquets Hyprnux, mettez-les dans un seul dossier et donnez tous les fichiers à pacman en une seule fois, pour que les paquets qui dépendent les uns des autres se résolvent ensemble :

sudo pacman -U hyprnux-shell-*.zst hyprnux-settings-*.zst hyprglass-*.zst \ hyprnux-hyprland-*.zst hyprnux-palette-*.zst

Si l’un des fichiers est hyprnux-keyring, vérifiez-le avant de l’installer. Le guide d’installation explique aussi comment construire vous-même les fichiers. L’écran de connexion et l’assistant de premier démarrage s’ajoutent de la même façon quand vous les voulez (hyprnux-login-*.zst, hyprnux-firstboot-*.zst).

Désinstaller

Après une installation complète, réactivez d’abord votre ancien gestionnaire de connexion si vous avez basculé sur greetd, et lancez sudo systemctl disable greetd.service. Retirez ensuite le bureau et les paquets installés pour lui. /etc/os-release reste celui de Hyprnux jusqu’à sudo pacman -S filesystem, qui remet celui d’Arch :

sudo pacman -Rns hyprnux-desktop

Après une installation minimale, cela retire les cinq composants et la palette de couleurs. Si vous avez installé l’écran de connexion ou l’assistant de premier démarrage, ajoutez hyprnux-login et hyprnux-firstboot à la commande (pacman s’arrête sur un nom qui n’est pas installé). Omettez les paquets que vous voulez garder.

sudo pacman -Rns hyprnux-shell hyprnux-settings hyprglass \ hyprnux-hyprland hyprnux-palette hyprnux-keyring

Ne retirez hyprnux-login qu’après avoir activé un autre gestionnaire de connexion, sinon la machine démarre sur une console texte. Le guide d’installation montre comment revenir à l’ancien, sous « Ajouter l’écran de connexion ».

Si vous avez ajouté des lignes à votre propre hyprland.lua (voyez L’utiliser avec votre propre configuration), supprimez-les : elles pointent vers des fichiers qui n’existent plus.

Vos fichiers dans votre dossier personnel, comme ~/.config/hyprnux, restent. Supprimez-les vous-même si vous n’en voulez plus.

Retirer le dépôt

Supprimez le bloc [hyprnux-core] de /etc/pacman.conf, puis retirez la clé de pacman :

sudo pacman-key --delete BF3FA18AE63F226028A83A2E3DA59F85B9821E2C

En cas de blocage