Thema's

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.

Kies een thema

Open Beeld → Thema en klik op een thema: het hele venster verandert meteen, zonder opnieuw op te starten. Beeld → Ondersteuning voor donkere modus en Beeld → Altijd donker kiezen vervolgens de lichte of donkere kant, net als bij het klassieke uiterlijk (Donkere modus).

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.

Waar themabestanden staan

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:

Binnen twee seconden verschijnt een nieuw bestand in Beeld → Thema, onder de ingebouwde thema's, met de name die het zichzelf geeft. Nadat u een bestand hebt bewerkt, kiest u het opnieuw in Beeld → Thema om de wijziging te zien.

Een thema kan één bestand (harbour.toml) zijn of een eigen map (harbour/theme.toml) als het pictogrammen bevat.

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.

Base16- en pywal-kleurenschema's

Kleurenschema's die voor andere programma's zijn gemaakt, zijn ook thema's, zonder dat er iets hoeft te worden geconverteerd:

• Een Base16-schema, het .yaml-bestand waarin de Base16- en Base24-schema's komen: zowel de klassieke lay-out (scheme: en base00 tot base0F bovenaan) als de nieuwere (name: en een palette:-blok). Een Base24-schema wordt gelezen als de eerste 16 kleuren.
• pywal's colors.json, of het bestand van een ander programma in de vorm van pywal (wallust's pywal-sjabloon).

Voeg het toe met Beeld → Thema → Themabestand toevoegen…, of plaats het zelf in de themamap. Het verschijnt in Beeld → Thema onder de naam van het schema (name: of scheme:; pywal's is vernoemd naar de achtergrondafbeelding).

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.

Om meer dan alleen kleuren te wijzigen, maakt u een themabestand dat het schema overneemt op basis van de bestandsnaam en toevoegt wat u wilt:

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

[sizes]
radius = 6

inherits = "pywal"werkt op dezelfde manier en volgt ook wal.

Het bestand

Een thema is één klein tekstbestand in TOML (of JSON, .json; of een kleurenschema, .yaml). Het benoemt alleen wat het verandert; al het andere komt van het thema dat het 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 — wat Beeld → Thema weergeeft; de bestandsnaam als er geen is.
• inherits — het thema waarvan het uwe begint: classic (de standaard als het wordt weggelaten), de id van een ingebouwd thema (metro, adwaita, breeze, luna, aero, aqua, high-contrast), of een ander themabestand in dezelfde map, op basis van de bestandsnaam zonder .toml. Een bestand dat een ander erft, kan op zijn beurt worden geërfd; een thema kan zichzelf niet erven.
• [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] — rollen met één kleur (zoals window, accent of "segments.done") aan beide zijden; [light] en [dark] aan slechts één zijde. Een kleur is #rrggbb, of #rrggbbaa met transparantie. De rollen die een bestand instelt, winnen van de basiskleuren.
• [sizes] — hoekradii, randbreedtes, lettergroottes en rijhoogtes, in pixels.
• [controls] — de vorm van tekstvakken, selectievakjes, knoppen, voortgangsbalken, schuifbalken, de focusmarkering en de titelbalk.
• icons — color, mono (één kleur) of accent.
• contrast = "high" — versterkt elke rand- en tekstkleur bovenop de rest.

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.

Pictogrammen

Een thema in een eigen map (harbour/theme.toml) kan zijn pictogrammen meebrengen in icons/16 en icons/24 (en, voor PNG-afbeeldingen, icons/32 en icons/48, gebruikt op een scherm geschaald naar 150% en meer), elk genoemd naar wat het toont (tb-add-url.svg, cat-music.png…). SVG- en PNG-bestanden behouden hun kleuren; -symbolic.svg en -symbolic.png-bestanden, zoals GNOME en KDE ze noemen, nemen de tekstkleur van het thema over. Een pictogram dat de set mist, wordt getekend zoals het klassieke uiterlijk het tekent. De volledige lijst met namen staat in themeicons.rs (NEEDS).

Maak een thema

1. Beeld → Thema → Map met thema's openen, en maak daar een nieuw .toml-bestand (elke teksteditor).
2. Begin met het bovenstaande voorbeeld: wijzig de kleuren van de basiskleuren en voeg vervolgens rollen en groottes toe naarmate u verdergaat.
3. Kies het in Beeld → Thema, en bekijk beide zijden: Beeld → Altijd donker aan en uit. Controleer of de tekst leesbaar is en de focusmarkering zichtbaar is in beide.

De Thema's-pagina van de website heeft een prompt die u aan een AI-assistent kunt geven, met het formaat, elke sleutel en de regels, om een thema voor u te schrijven op basis van een beschrijving.

Delen

Iets gemaakt dat anderen leuk zouden vinden? Open een pull request dat het toevoegt aan crates/app/assets/themes, met:

• het .toml-bestand, en de map met pictogrammen als die er is;
• schermafbeeldingen van het hoofdvenster in de lichte en donkere modus;
• 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.

Nog niet zeker? Bespreek het eerst in de discussies. In CONTRIBUTING.md staat hoe pull requests hier werken.

Volgende stappen

• Aan de slag →
• Opties →