A mesma janela, à sua maneira

Crie o seu próprio tema

Um tema é um pequeno ficheiro de texto, em TOML (ou JSON). Nomeia apenas o que muda; tudo o resto vem do tema em que se baseia. Não precisa de compilar o MDM nem de saber programar.

1. Crie-o

   Comece com algumas cores e adicione mais à medida que avança:

   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"

   • inheritsé o tema a partir do qual o seu começa: classic (o predefinido), high-contrast, metro, adwaita, breeze, luna, aero, aqua, ou outro ficheiro de tema na mesma pasta.
   • [seeds]são algumas cores (background, surface, header, text, accent, selection, error, warning, success) que o MDM espalha por todos os controlos. [seeds.light] e [seeds.dark] dão a cada lado o seu próprio.
   • [colors]define funções de cor única em ambos os lados, [light] e [dark] apenas num lado: #rrggbb, ou #rrggbbaa com transparência.
   • [sizes]são raios de canto, larguras de borda, tamanhos de letra e alturas de linha, em píxeis. [controls] escolhe a forma de caixas de texto, caixas de verificação, botões, barras de progresso, barras de deslocamento, a marca de foco e a barra de título.
   • iconsé color, mono ou accent. Um tema numa pasta própria (my-theme/theme.toml) pode ter os seus ícones em icons/16 e icons/24, cada um com o nome do que mostra (tb-add-url.svg, cat-music.png); os -symbolic assumem a cor do texto do tema.
   • contrast = "high"reforça cada contorno e a cor do texto por cima.

   Uma chave que o MDM não reconhece, ou um valor que não consegue ler, é ignorada e registada no ficheiro de registo do MDM (a pasta logs ao lado da pasta dos temas), para que um ficheiro feito para um MDM mais recente continue a carregar. Os temas incorporados são escritos da mesma forma: leia-os no GitHub.

   Cada função de cor (156)

   Chave	O que colore
   window	Fundo das janelas e caixas de diálogo do Windows
   text	Texto e glifos
   text.disabled	Texto desativado, o único cinzento de cada controlo e etiqueta acinzentados
   text.muted	Texto secundário: notas, tamanhos, versões
   link	Texto que abre algo
   error	Texto de erro
   error.strong	Mensagem de uma verificação falhada em Opções (testes de ligação, navegador e ajudas)
   warning	Texto de aviso
   success	Texto de sucesso (uma soma de verificação correspondente)
   reach.near	Servidor de uma transferência próximo pelo seu tempo de ida e volta (menos de 60 ms), em Propriedades
   reach.medium	Um servidor com um tempo de ida e volta médio (60 a 150 ms)
   reach.far	Um servidor distante pelo seu tempo de ida e volta (mais de 150 ms)
   flag.edge	O contorno fino à volta da bandeira de um país
   accent	O destaque: linhas de foco, controlos abertos e predefinidos, filtros, foco de ligações
   focus.ring	O retângulo de foco do teclado pontilhado
   selection	Preenchimento de uma seleção: linhas, um dia escolhido, texto selecionado
   selection.text	Texto na seleção
   selection.muted	Texto secundário na seleção
   selection.inactive	Uma linha selecionada numa lista sem o foco
   selection.focus	O contorno pontilhado da linha focada numa linha selecionada
   group.line	A moldura de uma caixa de grupo
   etch.shadow	A linha de sombra de um separador gravado
   etch.light	A linha de destaque de um separador gravado
   tab.page	O corpo de uma página de separador
   tab	Um separador não selecionado e a sombra da página
   tab.hot	Um separador sob o ponteiro
   chevron	Uma seta de lista pendente ou de caixa de seleção
   chevron.disabled	Uma seta esbatida
   subtle.hot	Uma parte sem face própria (uma seta, um cabeçalho de coluna) sob o ponteiro
   subtle.pressed	Essa parte premida ou aberta
   highlight.hot	Um dia ou seta de calendário sob o ponteiro, um alvo de arrastar
   highlight.pressed	Um dia ou seta de calendário premida
   field	O interior de uma caixa de texto ou de uma lista
   field.border	O limite de uma caixa de texto
   field.bottom	A linha inferior de uma caixa de texto enquanto pode ser editada
   field.disabled	O interior de uma caixa de texto esbatida
   field.disabled.border	O limite de uma caixa de texto esbatida
   field.readonly	O interior de uma caixa de texto só de leitura
   field.readonly.border	O limite de uma caixa de texto só de leitura
   combo.chevron	Um chevron de lista pendente
   combo.arrow.hot	A zona da seta de uma lista pendente editável sob o ponteiro
   combo.arrow.pressed	A zona da seta de uma lista pendente editável premida ou aberta
   button	A face de um botão
   button.hot	A face de um botão sob o ponteiro
   button.pressed	A face de um botão premida
   button.border	O limite de um botão
   button.bottom	O limite inferior de um botão
   button.text	O texto de um botão
   button.text.pressed	O texto de um botão premido
   button.default.border	O limite do botão predefinido
   button.default.bottom	O limite inferior do botão predefinido
   button.disabled	A face de um botão esbatido
   button.disabled.border	O limite de um botão esbatido
   button.accent	A face de um botão de destaque
   button.accent.hot	A face de um botão de destaque sob o ponteiro
   button.accent.pressed	A face de um botão de destaque premido
   button.accent.bottom	O bordo inferior de um botão de destaque
   button.accent.text	O texto de um botão de destaque
   button.accent.text.pressed	O texto de um botão de destaque premido
   button.glow	O brilho dentro de um botão sob o ponteiro, onde o estilo o desenha (Luna; transparente: nenhum)
   gloss	O brilho para o qual as partes lustrosas se misturam no topo: botões, caixas, barras e barras de título (Luna, Aero, Aqua)
   check	O interior de uma caixa de verificação ou de rádio não selecionada
   check.hot	O seu interior sob o ponteiro
   check.pressed	O seu interior premido
   check.border	O bordo de uma caixa de verificação ou de rádio não selecionada
   check.border.hot	O seu bordo sob o ponteiro
   check.border.pressed	O seu bordo premido
   check.border.disabled	O bordo de uma caixa de verificação não selecionada a cinzento
   check.on	O destaque de uma caixa de verificação ou de rádio selecionada
   check.on.hot	O destaque selecionado sob o ponteiro
   check.on.pressed	O destaque selecionado premido
   check.on.disabled	O preenchimento de uma caixa de verificação selecionada a cinzento
   check.mark	A marca ou ponto no destaque selecionado
   progress.track	A faixa de uma barra de progresso
   progress.bar	O preenchimento de uma barra de progresso
   meter.track	A faixa de um medidor (parte de uma transferência concluída)
   meter.edge	O bordo de um medidor
   meter.fill	O preenchimento de um medidor
   list	O fundo da lista de transferências
   list.frame	O contorno de uma lista, tabela ou caixa
   grid	As linhas de grelha entre as linhas de uma lista em diálogos
   list.grid	As linhas de grelha da lista de transferências
   header	Os cabeçalhos de coluna de todas as listas e tabelas
   header.line	A linha inferior de um cabeçalho nas listas de diálogos
   header.sep	Os divisores entre os cabeçalhos das colunas
   table.line	Os divisores nas tabelas do extrator de ligações e de Adicionar torrent
   header.sorted	O cabeçalho da coluna ordenada
   header.sort-arrow	O chevron de ordenação
   row.pressed	Uma linha de lista premida
   chip.web	O chip Web da lista de transferências
   chip.torrent	O chip Torrent da lista de transferências
   chip.text	Texto num chip
   list.drag-ghost	Um cabeçalho de coluna a ser arrastado
   list.marquee	A banda de borracha que seleciona as linhas
   list.marquee.border	A extremidade da banda de borracha
   scroll.track	A pista de uma barra de deslocamento
   scroll.corner	Onde duas barras de deslocamento se encontram
   scroll.thumb	O cursor e as setas de uma barra de deslocamento
   scroll.thumb.hot	O cursor ou uma seta sob o ponteiro
   scroll.thumb.pressed	O cursor ou uma seta premida ou arrastada
   menubar	A barra de menus
   menubar.bottom	A última linha da barra de menus
   menubar.line	A linha sob a barra de menus
   menubar.hot	Um título de menu sob o ponteiro
   menubar.open	O título do menu aberto
   menu	O fundo de um menu
   menu.item	Um item de menu
   menu.hot	Um item de menu sob o ponteiro
   menu.border	A moldura de um menu e de um pop-up
   menu.sep	Os separadores de um menu
   menu.text	O texto de um menu
   menu.glyph	Marcadores, vistos e setas de submenu
   menu.text.disabled	Um item de menu esbatido
   toolbar.line	A linha superior da barra de ferramentas
   toolbar.line.light	O destaque por baixo
   toolbar.hot	Um botão da barra de ferramentas sob o ponteiro
   toolbar.hot.faint	A outra parte de um botão dividido, enquanto uma está sob o ponteiro
   toolbar.pressed	Um botão da barra de ferramentas premido
   toolbar.hot.edge	A extremidade de um botão da barra de ferramentas ativo
   toolbar.hot.border	O contorno de um botão da barra de ferramentas ativo (transparente: nenhum)
   toolbar.split.shadow	A sombra do divisor de um botão dividido em repouso
   toolbar.split.light	O destaque do divisor
   toolbar.text.disabled	Um rótulo acinzentado da barra de ferramentas
   toolbar.arrow	A seta de um botão de lista pendente
   icon.disabled	A tinta de um ícone acinzentado (o seu início)
   icon.disabled.end	A tinta de um ícone acinzentado (o seu fim)
   tree	O fundo da árvore de categorias
   tree.lines	Os conectores pontilhados da árvore
   tree.expander	Os chevrons da árvore, onde a variante os desenha
   tree.frame	A moldura do painel de categorias
   progress.status	O valor do Estado da janela de progresso
   progress.label.disabled	Um rótulo acinzentado na janela de progresso
   segments.border	A moldura da barra de segmentos
   segments.corner	Os pixéis de canto da barra de segmentos
   pieces.have	Uma parte de torrent que está aqui
   pieces.partial	Um quadrado que representa partes parcialmente aqui
   pieces.missing	Uma parte ainda não aqui
   caption	Uma barra de título que o MDM desenha
   caption.text	O seu título e glifos
   caption.text.inactive	O seu título e glifos quando a janela não está ativa, e os de um botão acinzentado
   caption.hot	Um botão de legenda sob o ponteiro (uma tonalidade sobre a barra)
   caption.pressed	Um botão de legenda premido (uma tonalidade sobre a barra)
   caption.button	Um botão de legenda em repouso, onde o estilo mostra um (uma tonalidade sobre a barra; transparente: nenhum)
   caption.close	Fechar sob o ponteiro
   caption.close.text	Glifo de «Fechar» sob o ponteiro
   caption.inactive	Barra de título desenhada pelo MDM, quando a janela não está ativa (transparente: como quando está ativa)
   drop-target.edge	Contorno da área de destino em repouso
   egui.panel	Fundo do painel do egui
   egui.window	Fundo das descrições
   egui.window.border	Contorno das descrições
   egui.text	Texto das descrições
   egui.selection.text	Cor do texto selecionado nas caixas do egui
   egui.extreme	Fundo mais escuro (ou mais claro) do egui
   egui.faint	Fundo esbatido do egui
   egui.widget	Elementos gráficos do egui em repouso
   egui.widget.border	Contorno (transparente: nenhum)

   Todos os tamanhos (26)

   Chave	O que define
   radius	Raio de canto de botões, caixas de texto e listas pendentes
   radius.button	Raio de canto de um botão de pressão brilhante (Luna, Aero; os do Aqua são redondos nas extremidades)
   radius.part	Raio de canto de uma parte colorida (uma zona de seta, um botão de rotação)
   radius.check	Raio de canto de uma caixa de verificação
   radius.flyout	Raio de canto de um pop-up numa janela (um calendário, uma caixa de filtro)
   radius.menu-item	Raio de canto de um item de menu sob o ponteiro
   radius.egui	Raio de canto dos elementos gráficos do egui
   radius.popup	Raio de canto das descrições
   border	Largura do contorno de um controlo
   focus-line	Altura da linha de destaque de uma caixa de texto com foco
   chevron.width	Espessura do traço do "chevron" de uma lista pendente
   font.dialog	Texto de diálogo (Tahoma nos diálogos do IDM)
   font.dialog.bold	Títulos das páginas de opções
   font.title	Título de uma janela (Tahoma Negrito): da extensão do navegador, dos assistentes
   font.code	Um código de início de sessão para digitar na página de um serviço
   font.ui	Menus e texto da janela principal (Segoe UI)
   font.ui.bold	Títulos em negrito na janela principal
   font.small	Texto pequeno do egui
   font.body	Texto principal do egui: descrições, caixas de várias linhas
   font.heading	Títulos do egui
   list.row	Altura de uma linha na lista de transferências
   list.header	Altura dos cabeçalhos das colunas da lista de transferências
   tooltip.width	Onde o texto de uma descrição quebra
   tooltip.margin-x	Preenchimento esquerdo e direito de uma descrição
   tooltip.margin-top	Preenchimento superior de uma descrição
   tooltip.margin-bottom	Preenchimento inferior de uma descrição

   Estilo de cada controlo (7)

   Chave	Os seus estilos
   field-focus	linha, contorno, anel
   check	Fluent, Square, Adwaita, Breeze, Luna, Aero, Aqua
   button	Fluent, Breeze, Luna, Aero, Aqua
   progress	linha, barra, blocos, brilho
   scroll	sobreposição, clássico
   caption	sistema, metro, adwaita, breeze, luna, aero, aqua
   focus	pontilhado, anel, moldura

   Ou deixe um assistente de IA escrevê-lo

   Copie este pedido para o seu assistente de IA e descreva o aspeto que pretende no final. Ele fornece ao assistente o formato, as chaves e as regras: texto legível e um foco visível em ambos os lados, e nada copiado de trabalhos de outras pessoas. Veja ambos os lados antes de partilhar o resultado.

   You are making a theme file for Mister Download Manager (MDM), a free, open-source download manager. Write one TOML file, named after the theme in lower case with dashes (for example harbour.toml). Reply with the file only, in one code block, then one line on how to install it.
   
   THE FORMAT
   A theme names only what it changes; everything else comes from the theme it inherits.
   - name = "Display name"
   - inherits = "classic" (the default), "high-contrast", "metro", "adwaita", "breeze", "luna", "aero" or "aqua"
   - icons = "color" | "mono" | "accent"
   - contrast = "high" (optional: strengthens every edge and text colour)
   - [seeds] a few colours MDM spreads over every control: background, surface, header, text, accent, selection, error, warning, success. Use [seeds.light] and [seeds.dark] to give each side its own.
   - [colors] single colour roles for both sides; [light] and [dark] for one side only. Role names are dotted and must be quoted when they contain a dot, e.g. "button.hot" = "#e5f1fb". Useful roles: window, text, text.muted, link, accent, focus.ring, selection, selection.text, field, field.border, button, button.hot, button.pressed, button.border, button.text, check.on, check.mark, progress.bar, list, header, menubar, menu, menu.hot, menu.text, toolbar.hot, tree, caption, caption.text, scroll.thumb, gloss (the shine glossy parts blend toward), button.glow. "segments.done" takes one colour or a list of 13 (top to bottom).
   - [sizes] in pixels, 0 to 400: radius, radius.button, radius.check, radius.menu-item, radius.popup, border, focus-line, list.row, list.header, font.ui, font.dialog.
   - [controls] shapes: field-focus = line | border | ring; check = fluent | square | adwaita | breeze | luna | aero | aqua; button = fluent | breeze | luna | aero | aqua; progress = line | bar | blocks | gloss; scroll = overlay | classic; focus = dotted | ring | frame; caption = system | metro | adwaita | breeze | luna | aero | aqua.
   - Colours are "#rrggbb" or "#rrggbbaa". Unknown keys are skipped, so only use the names above.
   
   THE RULES
   1. Make both a light and a dark side: give [seeds.light] and [seeds.dark] (or [light] and [dark]) their own colours, and check each side on its own.
   2. Text must be easy to read: at least 4.5:1 contrast for text against its background (text on window and field, button.text on button, menu.text on menu, selection.text on selection, caption.text on caption), in both sides.
   3. The keyboard focus must be easy to see: accent and focus.ring at least 3:1 against what they sit on.
   4. Disabled text stays readable but clearly dimmer than normal text.
   5. Clean room: no artwork, icons, logos, fonts or text copied from any other program or company. If the theme needs icons, describe original ones to draw, never copy existing ones, and note their source and licence in a SOURCES.txt.
   6. Keep the layout: a theme changes colours, sizes and control shapes only.
   
   After the file, list each text and background pair you checked with its contrast ratio, for both sides.
   
   THE LOOK I WANT:

2. Experimente, sem compilar o MDM

   Coloque o ficheiro na pasta de temas do MDM. Ver → Tema → Abrir pasta de temas abre-a e cria-a se for a primeira vez. Está na pasta de dados do MDM:

   Windows

   %APPDATA%\misterdownloadmanager\themes

   Linux

   ~/.local/share/misterdownloadmanager/themes

   macOS

   ~/Library/Application Support/misterdownloadmanager/themes

   Cópia portátil

   data\themesao lado do programa

   Em dois segundos, aparece em Ver → Tema, sob os temas incorporados, pelo name que se atribui. Escolha-o e a janela inteira muda de imediato. Depois de editar o ficheiro, escolha-o novamente em Ver → Tema para ver a alteração. Ver → Suporte para Modo Escuro e Sempre escuro alternam entre o seu lado claro e escuro.

   Em Ver → Tema → Adicionar um ficheiro de tema…, escolha o ficheiro em qualquer pasta e o MDM copia-o para a pasta de temas e aplica-o de imediato.

   Já tem um esquema Base16 ou pywal?

   Já é um tema. Um esquema Base16 ou Base24 (.yaml) ou colors.json do pywal, adicionado da mesma forma, altera as cores do MDM e nada mais: os fundos do esquema por trás da lista e das janelas, o texto mantido legível (4,5:1 ou mais), o azul no foco, a seleção e a barra de progresso. Depois de wal ter sido executado, Ver → Tema lista pywal, lido de ~/.cache/wal/colors.json (%USERPROFILE%\.cache\wal\colors.jsonno Windows), e o MDM segue as cores de cada novo papel de parede em dois segundos. O guia mostra qual a cor que vai para onde.

3. Partilhe-o

   Criou algo que outros gostariam? Abra um pedido de pull no GitHub que o adicione a crates/app/assets/themes, com:

   • o ficheiro .toml e a sua pasta de ícones, se tiver uma;
   • capturas de ecrã da janela principal nos seus lados claro e escuro;
   • uma SOURCES.txt junto a quaisquer ícones, indicando quem os desenhou e sob que licença. Os ícones devem ser seus ou estar sob uma licença que permita ao MDM partilhá-los (GPL-3.0), nunca copiados de outro programa.

   Ainda não tem a certeza? Mostre-o primeiro nas discussões. O guia de contribuição explica como funcionam os pedidos de pull aqui.