Omarchy

The Manual

La barre supérieure

Le bandeau en haut de votre écran est la barre Omarchy. Ce n’est pas une barre d’état ajoutée par-dessus, mais une partie du shell Omarchy, l’unique processus Quickshell qui s’exécute en permanence...

Le bandeau en haut de votre écran est la barre Omarchy. Ce n’est pas une barre d’état ajoutée par-dessus, mais une partie du shell Omarchy, l’unique processus Quickshell qui s’exécute en permanence et affiche également le menu, les notifications, les fenêtres contextuelles OSD et l’écran de verrouillage. C’est pourquoi son thème s’accorde parfaitement avec tout le reste et qu’un panneau s’ouvre instantanément au lieu de lancer une nouvelle application.

C’est aussi le seul élément du bureau qui reste toujours à l’écran, il est donc utile de savoir à quoi servent tous ces petits symboles.

Ce qu’elle contient par défaut #

La barre comporte trois sections. À gauche se trouvent le logo Omarchy (qui ouvre le menu) et les indicateurs d’espaces de travail. Au centre figurent les indicateurs d’état, l’horloge, la disposition du clavier, la météo et une pastille de mise à jour d’Omarchy. À droite : la zone de notification, les agents, le Bluetooth, le réseau, l’audio, l’affichage et l’alimentation.

Certains de ces éléments ne s’affichent que lorsqu’ils ont quelque chose à signaler. La disposition du clavier n’apparaît que si vous en avez configuré plusieurs. La pastille de mise à jour n’apparaît que lorsqu’une mise à jour d’Omarchy est disponible. Et l’icône des agents apparaît la première fois qu’Omarchy détecte sur la machine l’utilisation d’outils d’IA pour le développement (voir IA).

Utiliser les différents clics #

Presque chaque composant réagit aux clics gauche, droit et du milieu, et plusieurs répondent au défilement. C’est un aspect souvent méconnu : les boutons droit et du milieu donnent accès à de nombreuses fonctions intéressantes.

Composant Gauche Droit Milieu / défilement
Menu Menu Omarchy Nouveau terminal —
Espaces de travail Activer cet espace de travail — —
Horloge Fenêtre contextuelle du calendrier Changer le format du libellé Milieu : sélection du fuseau horaire
Météo Fenêtre contextuelle des prévisions Prévisions météo complètes dans une notification Milieu : actualiser
Audio Panneau audio Couper le son Milieu : panneau · défilement : volume
Microphone Couper le micro — Milieu : panneau audio · défilement : volume d’entrée
Réseau Panneau réseau — —
Bluetooth Panneau Bluetooth Activer ou désactiver l’émetteur —
Affichage Panneau d’affichage — Défilement : luminosité
Alimentation Panneau d’alimentation Afficher ou masquer le pourcentage de batterie —
Médias Lecture/pause Fenêtre contextuelle de la pochette Milieu : suivant · défilement : précédent/suivant
Agents Panneau des agents Lancer votre agent Milieu : abonnement suivant
Zone de notification Survoler pour afficher le volet Clic droit sur le chevron pour gérer —
Mise à jour d’Omarchy Lancer la mise à jour — —

Tout ce qui figure dans ce tableau n’est pas présent d’emblée dans votre barre. Le composant multimédia (lecture en cours via MPRIS, avec défilement du titre et du nom de l’artiste) et le composant du microphone sont tous deux intégrés, mais désactivés par défaut : ajoutez-les si vous le souhaitez, comme expliqué ci-dessous.

Les panneaux #

Cliquer sur une icône de la barre ouvre un véritable panneau contextuel doté de curseurs, de listes et d’une navigation au clavier, plutôt qu’une simple infobulle. Chacun dispose également d’un raccourci clavier, ce qui vous évite d’avoir à viser un symbole de 16 pixels :

Raccourci clavier Panneau
Super + Ctrl + A Audio
Super + Ctrl + W Réseau
Super + Ctrl + B Bluetooth
Super + Ctrl + D Affichage
Super + Ctrl + P Alimentation
Super + Ctrl + Alt + D Calendrier
Super + Ctrl + 1-9 Afficher ou masquer le n-ième panneau de la section de droite

Les panneaux ne servent pas seulement à afficher des informations. C’est là que vous effectuez réellement les actions :

  • Audio comporte un curseur de volume principal, un sélecteur de périphérique de sortie et un mélangeur par application, ce qui permet de réduire le volume d’un seul onglet du navigateur sans toucher au reste.
  • Réseau recherche les réseaux Wi-Fi, affiche la puissance du signal, établit la connexion et permet de choisir un fournisseur DNS.
  • Bluetooth répertorie vos appareils, avec les options de connexion et de déconnexion ainsi que leur niveau de batterie.
  • Alimentation affiche les statistiques de la batterie, permet de changer de profil d’alimentation (un choix distinct est mémorisé pour la batterie et le secteur) et présente quelques informations sur le système.
  • Affichage propose un curseur de luminosité, la taille du texte, des préréglages de mise à l’échelle et, lorsque vous disposez de plusieurs écrans, des commandes propres à chaque écran. Consultez la page sur les écrans pour en savoir plus.
  • Horloge ouvre une grille mensuelle avec les numéros de semaine ISO et permet de passer d’un mois à l’autre.

Chaque panneau s’utilise aussi bien au clavier qu’à la souris : les flèches déplacent la sélection, Entrée active l’élément, Tabulation passe au panneau voisin et Échap ferme le panneau.

Super + Ctrl + 1-9 compte les panneaux de gauche à droite dans la section de droite, en ignorant la zone de notification puisqu’elle ne possède pas de panneau. Le numéro correspond donc à l’icône que vous pointeriez.

Tailscale et Dropbox #

Deux autres composants n’apparaissent dans la barre qu’après l’installation du service correspondant depuis Installer → Service. Il est utile de les connaître, car ils font plus qu’indiquer un état.

Le panneau Tailscale connecte et déconnecte le tailnet, permet de passer d’un compte à l’autre et de choisir un nœud de sortie (vos propres machines et les régions Mullvad figurent toutes deux dans cette liste). Il permet également de parcourir vos machines et, lorsqu’une d’elles est sélectionnée, s lui envoie des fichiers via Taildrop, ce qui constitue le moyen le plus rapide de transférer un fichier vers votre téléphone ou un autre ordinateur portable. c copie l’adresse IP de la machine, n son nom et d son nom DNS complet. Chaque ligne de machine comporte aussi un bouton d’envoi, si vous préférez cliquer. La commande équivalente dans le terminal est omarchy tailscale send <machine> [file...].

Le panneau Dropbox gère la connexion, indique la quantité de stockage utilisée et répertorie les fichiers récemment synchronisés.

La suppression de l’un ou l’autre service retire également son composant de la barre.

Indicateurs #

Le petit groupe situé au centre est le composant des indicateurs. Il s’agit de symboles d’état correspondant aux modes que vous avez activés : ne pas déranger, éclairage nocturne, rappel programmé, enregistrement d’écran en cours, maintien en éveil et dictée. Ils s’allument lorsque le mode est actif et restent autrement discrets : survolez le centre de la barre pour afficher les indicateurs inactifs. Cliquer sur un indicateur active ou désactive le mode correspondant.

Si vous préférez qu’ils restent toujours visibles, définissez alwaysShow sur true dans le composant. Et si seuls certains d’entre eux vous intéressent, indiquez ceux que vous souhaitez dans items : ["Dnd", "Reminder", "NightLight"]. Vous pouvez utiliser plusieurs composants d’indicateurs afin que différentes sections affichent des sous-ensembles distincts.

Réorganiser la barre #

La barre se configure directement. Vous n’avez pas besoin d’ouvrir un fichier de configuration pour déplacer des éléments.

Saisissez une zone vide de la barre près du centre et faites-la glisser vers un autre bord de l’écran : la barre s’y déplace. Les bords gauche, droit, supérieur et inférieur sont tous pris en charge, et chaque composant s’adapte (les barres verticales adoptent une forme compacte composée uniquement d’icônes). Un clic prolongé déclenche le même déplacement. Double-cliquez avec le bouton gauche sur ce même espace vide pour activer ou désactiver la transparence. Vous pouvez également faire glisser n’importe quel composant pour le réorganiser ou le déplacer vers une autre section.

Si vous préférez choisir dans un menu, Style → Barre de menus propose à la fois la position et la transparence.

Les mêmes opérations sont disponibles sous forme de commandes, ce qui est particulièrement utile pour une configuration reposant sur des dotfiles :

omarchy bar position bottom
omarchy bar transparent toggle
omarchy bar move omarchy.clock --section center --index 0
omarchy bar set omarchy.clock format "HH:mm"
omarchy bar defaults          # back to the shipped layout

Pour ajouter ou supprimer entièrement un composant, utilisez les commandes des plugins. omarchy plugin list affiche tous les composants connus du shell avec leur identifiant, puis utilisez :

omarchy plugin enable omarchy.media --section center
omarchy plugin disable omarchy.weather

Masquer la barre #

Super + Shift + Space masque puis réaffiche la barre sans arrêter le shell : les panneaux et les raccourcis clavier continuent de fonctionner, vous récupérez simplement l’espace à l’écran. Cette option est également disponible dans le menu sous Déclencher → Basculer → Barre de menus.

Le fichier de configuration #

L’ensemble de cette configuration est enregistré dans ~/.config/omarchy/shell.json, sous la clé bar. En voici une version abrégée :

{
  "version": 1,
  "bar": {
    "position": "top",
    "transparent": false,
    "centerAnchor": "omarchy.clock",
    "layout": {
      "left": [{ "id": "omarchy.menu" }, { "id": "omarchy.workspaces" }],
      "center": [{ "id": "omarchy.clock", "format": "HH:mm" }],
      "right": [{ "id": "omarchy.audio" }, { "id": "omarchy.power" }]
    }
  }
}

Chaque composant correspond à une entrée dans l’un des trois tableaux de disposition, et ses paramètres se trouvent directement dans cette entrée : il n’existe ni fichier de paramètres distinct ni sous-objet config. Les valeurs format, formatAlt de l’horloge (le format sélectionné avec le clic droit) et verticalFormat se trouvent toutes directement dans { "id": "omarchy.clock" }.

centerAnchor désigne l’unique composant central épinglé exactement au centre de l’écran, les autres étant placés de part et d’autre. C’est ainsi que l’horloge reste parfaitement centrée, même lorsque la météo et la pastille de mise à jour apparaissent ou disparaissent. Définissez cette valeur sur une chaîne vide pour que la liste centrale soit simplement centrée en tant que groupe.

Une règle importante à retenir : dès que vous possédez votre propre fichier shell.json, celui-ci fait autorité. Tant que vous n’avez rien personnalisé, le shell lit le fichier par défaut d’Omarchy. Dès que vous déplacez un composant, exécutez omarchy bar ou modifiez vous-même le fichier, il devient le vôtre : aucune fusion récursive n’est effectuée, si bien que les nouveaux composants ajoutés par défaut dans les futures versions d’Omarchy n’apparaîtront pas automatiquement dans votre barre. omarchy bar defaults rétablit la disposition fournie chaque fois que vous souhaitez repartir de zéro.

Le même fichier contient également vos délais d’inactivité au niveau supérieur, en dehors de la clé bar : idle.screensaver et idle.lock, tous deux exprimés en secondes depuis le début de votre période d’inactivité. Par défaut, l’économiseur d’écran se déclenche donc après 150 secondes et le verrouillage après 300.