Temas

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.

Elegir uno

Abre Ver → Tema y haz clic en un tema: toda la ventana cambia al instante, sin necesidad de reiniciar. Ver → Compatibilidad con el modo oscuro y Ver → Siempre oscuro eligen su lado claro u oscuro, como en el aspecto clásico (Modo oscuro).

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.

Dónde van los archivos de tema

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 dos segundos, un nuevo archivo aparece en Ver → Tema, debajo de los temas integrados, con el name que se da a sí mismo. Después de editar un archivo, selecciónalo de nuevo en Ver → Tema para ver el cambio.

Un tema puede ser un solo archivo (harbour.toml) o una carpeta propia (harbour/theme.toml) cuando incluye iconos.

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.

Esquemas de color Base16 y pywal

Los esquemas de color hechos para otros programas también son temas, sin necesidad de convertirlos:

• Un esquema Base16, el archivo .yaml en el que vienen los esquemas Base16 y Base24: tanto el diseño clásico (scheme: y base00 a base0F en la parte superior) como el más reciente (name: y un bloque palette:). Un esquema Base24 se lee como sus primeras 16 colores.
• El colors.json de pywal, o el archivo de cualquier programa con el formato de pywal (la plantilla pywal de wallust).

Añádelo con Ver → Tema → Añadir un archivo de tema…, o ponlo tú mismo en la carpeta de temas. Aparece en Ver → Tema con el nombre del esquema (name: o scheme:; el de pywal se nombra según el fondo de pantalla).

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.

Para cambiar más que los colores, crea un archivo de tema que herede el esquema por su nombre de archivo y añada lo que quieras:

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

[sizes]
radius = 6

inherits = "pywal"funciona de la misma manera y también sigue a wal.

El archivo

Un tema es un pequeño archivo de texto en TOML (o JSON, .json; o un esquema de color, .yaml). Solo nombra lo que cambia; todo lo demás proviene del tema que 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 — lo que Ver → Tema lista; el nombre del archivo cuando no hay ninguno.
• inherits — el tema del que parte el tuyo: classic (el predeterminado si se omite), el ID de un tema integrado (metro, adwaita, breeze, luna, aero, aqua, high-contrast), u otro archivo de tema en la misma carpeta, por su nombre de archivo sin .toml. Un archivo que hereda otro puede ser heredado a su vez; un tema no puede heredarse a sí mismo.
• [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] — roles de un solo color (como window, accent o "segments.done") en ambos lados; [light] y [dark] en un solo lado. Un color es #rrggbb, o #rrggbbaa con transparencia. Los roles que establece un archivo prevalecen sobre sus semillas.
• [sizes] — radios de esquina, anchos de borde, tamaños de fuente y alturas de fila, en píxeles.
• [controls] — la forma de los cuadros de texto, casillas de verificación, botones, barras de progreso, barras de desplazamiento, la marca de enfoque y la barra de título.
• icons — color, mono (un color) o accent.
• contrast = "high" — refuerza cada borde y color de texto por encima del resto.

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.

Iconos

Un tema en su propia carpeta (harbour/theme.toml) puede traer sus iconos en icons/16 y icons/24 (y, para imágenes PNG, icons/32 y icons/48, usadas en una pantalla escalada al 150 % y más), cada uno nombrado por lo que muestra (tb-add-url.svg, cat-music.png…). Los archivos SVG y PNG conservan sus colores; los -symbolic.svg y -symbolic.png, como los nombran GNOME y KDE, toman el color de texto del tema. Un icono que falta en el conjunto se dibuja como lo hace el aspecto clásico. La lista completa de nombres está en themeicons.rs (NEEDS).

Crear uno

1. Ver → Tema → Abrir carpeta de temas, y crea un nuevo archivo .toml allí (cualquier editor de texto).
2. Empieza con el ejemplo anterior: cambia los colores de las semillas, luego añade roles y tamaños a medida que avanzas.
3. Selecciónalo en Ver → Tema, y mira ambos lados: Ver → Siempre oscuro activado y desactivado. Comprueba que el texto sea legible y la marca de enfoque visible en ambos.

La página de temas del sitio web tiene una indicación que puedes dar a un asistente de IA, con el formato, cada clave y las reglas, para que te escriba un tema a partir de una descripción.

Compártelo

¿Has creado algo que les gustaría a otros? Abre una solicitud de extracción que lo añada a crates/app/assets/themes, con:

• el archivo .toml y su carpeta de iconos si tiene una;
• capturas de pantalla de la ventana principal en su lado claro y oscuro;
• 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.

¿No estás seguro? Muéstralo primero en las discusiones. CONTRIBUTING.md explica cómo funcionan las solicitudes de extracción aquí.

Pasos siguientes

• Primeros pasos →
• Opciones →