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.

Escolha um

Abra Exibir → Tema e clique em um tema: a janela inteira muda de uma vez, sem precisar reiniciar. Exibir → Suporte ao Modo Escuro e Exibir → Sempre escuro então escolhem seu lado claro ou escuro, como na aparência clássica (Modo escuro).

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.

Onde ficam os arquivos 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:

Em dois segundos, um novo arquivo aparece em Exibir → Tema, abaixo dos temas integrados, pelo name que ele mesmo se dá. Depois de editar um arquivo, selecione-o novamente em Exibir → Tema para ver a mudança.

Um tema pode ser um único arquivo (harbour.toml) ou uma pasta própria (harbour/theme.toml) quando traz ícones.

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 cores Base16 e pywal

Esquemas de cores feitos para outros programas também são temas, sem necessidade de conversão:

• Um esquema Base16, o arquivo .yaml em que vêm os esquemas Base16 e Base24: tanto o layout clássico (scheme: e base00 para base0F no topo) quanto o mais novo (name: e um bloco palette:). Um esquema Base24 é lido como suas primeiras 16 cores.
• O colors.json do pywal, ou o arquivo de qualquer programa no formato do pywal (o modelo pywal do wallust).

Adicione-o com Exibir → Tema → Adicionar um arquivo de tema…, ou coloque-o você mesmo na pasta de temas. Ele aparece em Exibir → Tema com o nome do esquema (name: ou scheme:; o do pywal é nomeado a partir do papel de parede).

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 mudar mais do que cores, crie um arquivo de tema que herde o esquema pelo nome do arquivo e adicione o que você quiser:

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

[sizes]
radius = 6

inherits = "pywal"funciona da mesma forma e também segue wal.

O arquivo

Um tema é um pequeno arquivo de texto em TOML (ou JSON, .json; ou um esquema de cores, .yaml). Ele nomeia apenas o que muda; todo o resto vem do tema que ele 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 — o que Exibir → Tema lista; o nome do arquivo quando não há nenhum.
• inherits — o tema do qual o seu começa: classic (o padrão quando omitido), o ID de um tema integrado (metro, adwaita, breeze, luna, aero, aqua, high-contrast), ou outro arquivo de tema na mesma pasta, pelo nome do arquivo sem .toml. Um arquivo que herda outro pode ser herdado por sua vez; um tema não pode herdar a si mesmo.
• [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] — funções de cor única (como window, accent ou "segments.done") em ambos os lados; [light] e [dark] em apenas um lado. Uma cor é #rrggbb, ou #rrggbbaa com transparência. As funções que um arquivo define prevalecem sobre suas sementes.
• [sizes] — raios de canto, larguras de borda, tamanhos de fonte e alturas de linha, em pixels.
• [controls] — a forma de caixas de texto, caixas de seleção, botões, barras de progresso, barras de rolagem, a marca de foco e a barra de título.
• icons — color, mono (uma cor) ou accent.
• contrast = "high" — fortalece todas as cores de borda e texto além do 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.

Ícones

Um tema em uma pasta própria (harbour/theme.toml) pode trazer seus ícones em icons/16 e icons/24 (e, para imagens PNG, icons/32 e icons/48, usadas em uma tela escalada para 150% e mais), cada um nomeado para o que mostra (tb-add-url.svg, cat-music.png…). Arquivos SVG e PNG mantêm suas cores; os -symbolic.svg e -symbolic.png, como GNOME e KDE os nomeiam, assumem a cor do texto do tema. Um ícone que o conjunto não possui é desenhado como a aparência clássica o desenha. A lista completa de nomes está em themeicons.rs (NEEDS).

Crie um

1. Exibir → Tema → Abrir pasta de temas, e crie um novo arquivo .toml lá (qualquer editor de texto).
2. Comece pelo exemplo acima: mude as cores das sementes, depois adicione funções e tamanhos conforme avança.
3. Selecione-o em Exibir → Tema, e olhe para ambos os lados: Exibir → Sempre escuro ligado e desligado. Verifique se o texto é legível e a marca de foco visível em ambos.

A página de Temas do site tem um prompt que você pode dar a um assistente de IA, com o formato, todas as chaves e as regras, para escrever um tema para você a partir de uma descrição.

Compartilhe

Fez algo que outros gostariam? Abra um pull request que o adicione a crates/app/assets/themes, com:

• o arquivo .toml, e sua pasta de ícones, se houver;
• capturas de tela da janela principal em seu lado claro e escuro;
• 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.

Ainda não tem certeza? Discuta primeiro. O arquivo CONTRIBUTING.md explica como os pull requests funcionam aqui.

Próximos passos

• Primeiros passos →
• Opções →