Thèmes

A theme changes how GDM looks and keeps everything where it was: the same windows, menus and buttons in the same places, drawn in other colours, shapes and icons. Each theme has a light and a dark side.

Choisir un thème

Ouvrez Affichage → Thème et cliquez sur un thème : la fenêtre entière change instantanément, sans redémarrage. Affichage → Prise en charge du mode sombre et Affichage → Toujours sombre permettent ensuite de choisir sa version claire ou sombre, comme pour l’apparence classique (Mode sombre).

The built-in themes are Classic (GDM's own look, the default), Native (your system's accent colour and contrast), High contrast, and the style themes Metro, Adwaita, Breeze, Luna, Aero and Aqua, each with its own control shapes and icons, and on Windows its own title bar. Getting started describes each one; the website's Themes page shows them all, light and dark.

Emplacement des fichiers de thème

Theme files you make or download go in GDM's themes folder. View → Theme → Open themes folder opens it (and makes it the first time). It is in GDM's data folder:

En deux secondes, un nouveau fichier apparaît dans Affichage → Thème, sous les thèmes intégrés, avec le name qu’il se donne. Après avoir modifié un fichier, sélectionnez-le à nouveau dans Affichage → Thème pour voir le changement.

Un thème peut être un seul fichier (harbour.toml) ou un dossier propre (harbour/theme.toml) s’il contient des icônes.

View → Theme → Add a theme file… does it for you: pick a file anywhere, and GDM copies it into the themes folder and uses it at once. A file that isn't a theme stays out, and GDM says why.

Palettes de couleurs Base16 et pywal

Les palettes de couleurs conçues pour d'autres programmes sont aussi des thèmes, sans aucune conversion nécessaire :

• Une palette Base16, le fichier .yaml dans lequel les palettes Base16 et Base24 sont fournies : aussi bien la disposition classique (scheme: et base00 à base0F en haut) que la plus récente (name: et un bloc palette:). Une palette Base24 est lue comme ses 16 premières couleurs.
• Le fichier colors.json de pywal, ou tout fichier d'un programme ayant la forme de pywal (le modèle pywal de wallust).

Ajoutez-le avec Affichage → Thème → Ajouter un fichier de thème…, ou placez-le vous-même dans le dossier des thèmes. Il apparaît dans Affichage → Thème sous le nom de la palette (name: ou scheme: ; celui de pywal porte le nom du fond d'écran).

pywal itself: once wal has run, View → Theme lists pywal, read straight from where pywal writes its colours: ~/.cache/wal/colors.json (on Windows %USERPROFILE%\.cache\wal\colors.json, where winwal and pywal write it; $PYWAL_CACHE_DIR or $XDG_CACHE_HOME/wal when you set them). Pick it and GDM follows your wallpaper: each time wal writes new colours, GDM takes them within two seconds. It looks only at the file's date and size, every two seconds, and only while pywal is the theme. A copy added with Add a theme file… keeps the colours it had.

A scheme changes colours only, on the classic look: every window, button and menu stays where it was. A dark scheme makes GDM dark and a light one light, whatever View → Always dark says. The scheme's colours go where they mean the same:

Borders and the hover and pressed shades are mixed from these, as for a theme file's [seeds]. Text stays readable: text and secondary text at 4.5:1 or more against every background they sit on (WCAG AA), the accent at 3:1. A scheme short of that has those colours moved a little darker (lighter on a dark scheme) until they pass; GDM's log says which.

Pour modifier plus que les couleurs, créez un fichier de thème qui hérite de la palette par son nom de fichier et ajoute ce que vous voulez :

name = "Gruvbox, my way"
inherits = "gruvbox-dark-medium"   # gruvbox-dark-medium.yaml, beside it
icons = "accent"

[sizes]
radius = 6

inherits = "pywal"fonctionne de la même manière, et suit wal aussi.

Le fichier

Un thème est un petit fichier texte au format TOML (ou JSON, .json ; ou une palette de couleurs, .yaml). Il ne nomme que ce qu'il change ; tout le reste provient du thème dont il inherits :

name = "Harbour"
inherits = "classic"
icons = "color"

[seeds.light]
background = "#eef3f6"
surface = "#ffffff"
text = "#11202b"
accent = "#0f6c8c"

[seeds.dark]
background = "#14212a"
surface = "#0e171d"
text = "#e8f0f4"
accent = "#5cc3e6"

[sizes]
radius = 6

[controls]
focus = "ring"

• name — ce que Affichage → Thème liste ; le nom du fichier s’il n’y en a pas.
• inherits — le thème dont le vôtre hérite : classic (par défaut s’il est omis), l’identifiant d’un thème intégré (metro, adwaita, breeze, luna, aero, aqua, high-contrast), ou un autre fichier de thème dans le même dossier, par son nom de fichier sans .toml. Un fichier qui hérite d’un autre peut être hérité à son tour ; un thème ne peut pas s’hériter lui-même.
• [seeds] — a handful of colours (background, surface, header, text, accent, selection, error, warning, success) that GDM spreads over every control. [seeds.light] and [seeds.dark] give each side its own.
• [colors] — rôles de couleur uniques (tels que window, accent ou "segments.done") des deux côtés ; [light] et [dark] d’un seul côté. Une couleur est #rrggbb, ou #rrggbbaa avec transparence. Les rôles définis par un fichier l’emportent sur ses couleurs de base.
• [sizes] — rayons des coins, largeurs des bordures, tailles de police et hauteurs de ligne, en pixels.
• [controls] — la forme des zones de texte, des cases à cocher, des boutons, des barres de progression, des barres de défilement, du marqueur de focus et de la barre de titre.
• icons — color, mono (une couleur) ou accent.
• contrast = "high" — renforce chaque bord et couleur de texte par-dessus le reste.

Every colour role, size and control style, with what it sets, is listed on the website's Themes page (read from GDM's own code, so it never drifts). The built-in themes are written the same way: read them on GitHub.

A key GDM doesn't know, or a value it can't read, is skipped and written to GDM's log (the logs folder beside the themes folder), so a file made for a newer GDM still loads. A file that isn't valid TOML or JSON doesn't load, and the log says why. A file named like a built-in theme (metro.toml) is passed over: give yours a name of its own.

Icônes

Un thème dans son propre dossier (harbour/theme.toml) peut apporter ses icônes dans icons/16 et icons/24 (et, pour les images PNG, icons/32 et icons/48, utilisées sur un écran mis à l’échelle à 150 % et plus), chacune nommée pour ce qu’elle représente (tb-add-url.svg, cat-music.png…). Les fichiers SVG et PNG conservent leurs couleurs ; ceux de type -symbolic.svg et -symbolic.png, tels que nommés par GNOME et KDE, prennent la couleur du texte du thème. Une icône manquante dans l’ensemble est dessinée comme l’apparence classique la dessine. La liste complète des noms se trouve dans themeicons.rs (NEEDS).

Créer un thème

1. Affichage → Thème → Ouvrir le dossier des thèmes, et créez-y un nouveau fichier .toml (avec n’importe quel éditeur de texte).
2. Commencez par l’exemple ci-dessus : modifiez les couleurs de base, puis ajoutez des rôles et des tailles au fur et à mesure.
3. Sélectionnez-le dans Affichage → Thème, et regardez les deux versions : Affichage → Toujours sombre activé et désactivé. Vérifiez que le texte est lisible et que le marqueur de focus est visible dans les deux.

La page des thèmes du site web propose une invite que vous pouvez donner à un assistant IA, avec le format, chaque clé et les règles, pour écrire un thème pour vous à partir d’une description.

Partagez-le

Vous avez créé quelque chose qui pourrait plaire à d’autres ? Ouvrez une pull request qui l’ajoute à crates/app/assets/themes, avec :

• le fichier .toml, et son dossier d'icônes s'il en a un ;
• des captures d'écran de la fenêtre principale dans son côté clair et son côté sombre ;
• a SOURCES.txt beside any icons, saying who drew them and under which licence. Icons must be your own or under a licence that lets GDM share them (GPL-3.0), never copied from another program.

Vous n’êtes pas sûr ? Présentez-le d’abord dans les discussions. Le fichier CONTRIBUTING.md explique le fonctionnement des pull requests ici.

Étapes suivantes

• Démarrer →
• Options →