A mesma janela, do seu jeito

Crie seu próprio tema

Um tema é um pequeno arquivo de texto, em TOML (ou JSON). Ele nomeia apenas o que muda; todo o resto vem do tema em que se baseia. Você não precisa compilar o MDM nem 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 do qual o seu começa: classic (o padrão), high-contrast, metro, adwaita, breeze, luna, aero, aqua, ou outro arquivo 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 controles. [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] em um lado apenas: #rrggbb, ou #rrggbbaa com transparência.
   • [sizes]são raios de canto, larguras de borda, tamanhos de fonte e alturas de linha, em pixels. [controls] escolhe 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 ou accent. Um tema em sua própria pasta (my-theme/theme.toml) pode trazer seus ícones em icons/16 e icons/24, cada um nomeado pelo que mostra (tb-add-url.svg, cat-music.png); os -symbolic assumem a cor do texto do tema.
   • contrast = "high"fortalece cada borda e cor de texto por cima.

   Uma chave que o MDM não reconhece, ou um valor que não consegue ler, é ignorada e escrita no log do MDM (a pasta logs ao lado da pasta de temas), para que um arquivo feito para um MDM mais recente ainda seja carregado. Os temas integrados são escritos da mesma forma: leia-os no GitHub.

   Cada função de cor (156)

   Chave	O que colore
   window	Windows' and dialogs' background
   text	Texto e glifos
   text.disabled	Texto desativado, o único cinza de cada controle e rótulo acinzentado
   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 falha em Opções (testes de conexão, navegador e auxiliar)
   warning	Texto de aviso
   success	Texto de sucesso (um checksum correspondente)
   reach.near	Servidor de um download próximo pelo seu tempo de ida e volta (abaixo de 60 ms), em Propriedades
   reach.medium	Um servidor com tempo de ida e volta médio (60 a 150 ms)
   reach.far	Um servidor distante pelo seu tempo de ida e volta (acima de 150 ms)
   flag.edge	A borda fina ao redor da bandeira de um país
   accent	O destaque: linhas de foco, controles abertos e padrão, filtros, foco de links
   focus.ring	O retângulo de foco pontilhado do teclado
   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 em uma lista sem foco
   selection.focus	O contorno pontilhado da linha focada em uma linha selecionada
   group.line	Moldura de uma caixa de grupo
   etch.shadow	Linha de sombra de um separador gravado
   etch.light	Linha de destaque de um separador gravado
   tab.page	Corpo de uma página de aba
   tab	Uma aba não selecionada e a sombra da página
   tab.hot	Uma aba sob o ponteiro
   chevron	Uma seta de lista suspensa ou caixa de rotação
   chevron.disabled	Uma seta esmaecida
   subtle.hot	Uma parte sem face própria (uma seta, um cabeçalho de coluna) sob o ponteiro
   subtle.pressed	Essa parte pressionada ou aberta
   highlight.hot	Um dia ou seta de calendário sob o ponteiro, um alvo de arrastar e soltar
   highlight.pressed	Um dia ou seta de calendário pressionado
   field	O interior de uma caixa de texto ou de uma lista
   field.border	A borda de uma caixa de texto
   field.bottom	A linha inferior de uma caixa de texto enquanto ela pode ser digitada
   field.disabled	O interior de uma caixa de texto esmaecida
   field.disabled.border	A borda de uma caixa de texto esmaecida
   field.readonly	O interior de uma caixa de texto somente leitura
   field.readonly.border	A borda de uma caixa de texto somente leitura
   combo.chevron	O chevron de uma lista suspensa
   combo.arrow.hot	A zona da seta de uma lista suspensa editável sob o ponteiro
   combo.arrow.pressed	A zona da seta de uma lista suspensa editável pressionada 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 pressionada
   button.border	A borda de um botão
   button.bottom	A borda inferior de um botão
   button.text	O texto de um botão
   button.text.pressed	O texto de um botão pressionado
   button.default.border	A borda do botão padrão
   button.default.bottom	A borda inferior do botão padrão
   button.disabled	A face de um botão esmaecido
   button.disabled.border	A borda de um botão esmaecido
   button.accent	A face de um botão de destaque
   button.accent.hot	Face de um botão de destaque sob o ponteiro
   button.accent.pressed	Face de um botão de destaque pressionado
   button.accent.bottom	Borda inferior de um botão de destaque
   button.accent.text	Texto de um botão de destaque
   button.accent.text.pressed	Texto de um botão de destaque pressionado
   button.glow	O brilho dentro de um botão sob o ponteiro, onde o estilo desenha um (Luna; transparente: nenhum)
   gloss	O brilho para o qual as partes brilhantes se misturam no topo: botões, caixas, barras e barras de título (Luna, Aero, Aqua)
   check	Interior de uma caixa de seleção ou rádio desmarcada
   check.hot	Seu interior sob o ponteiro
   check.pressed	Seu interior pressionado
   check.border	Borda de uma caixa de seleção ou rádio desmarcada
   check.border.hot	Sua borda sob o ponteiro
   check.border.pressed	Sua borda pressionada
   check.border.disabled	Borda de uma caixa de seleção desmarcada e esmaecida
   check.on	Destaque de uma caixa de seleção ou rádio marcada
   check.on.hot	O destaque marcado sob o ponteiro
   check.on.pressed	O destaque marcado pressionado
   check.on.disabled	Preenchimento de uma caixa de seleção marcada e esmaecida
   check.mark	O tique ou ponto no destaque marcado
   progress.track	Trilha de uma barra de progresso
   progress.bar	Preenchimento de uma barra de progresso
   meter.track	Trilha de um medidor (parte de um download concluída)
   meter.edge	Borda de um medidor
   meter.fill	Preenchimento de um medidor
   list	Plano de fundo da lista de downloads
   list.frame	Contorno de uma lista, tabela ou caixa
   grid	Linhas de grade entre as linhas de uma lista em diálogos
   list.grid	Linhas de grade da lista de downloads
   header	Cabeçalhos de coluna de todas as listas e tabelas
   header.line	Linha inferior de um cabeçalho em listas de diálogos
   header.sep	Os divisores entre os cabeçalhos das colunas
   table.line	Os divisores nas tabelas do extrator de links e de "Adicionar torrent"
   header.sorted	O cabeçalho da coluna classificada
   header.sort-arrow	O chevron de classificação
   row.pressed	Uma linha da lista pressionada
   chip.web	O chip "Web" da lista de downloads
   chip.torrent	O chip "Torrent" da lista de downloads
   chip.text	Texto em um chip
   list.drag-ghost	Um cabeçalho de coluna sendo arrastado
   list.marquee	A faixa de seleção que seleciona linhas
   list.marquee.border	A borda da faixa de seleção
   scroll.track	A trilha de uma barra de rolagem
   scroll.corner	Onde duas barras de rolagem se encontram
   scroll.thumb	O controle deslizante e as setas de uma barra de rolagem
   scroll.thumb.hot	O controle deslizante ou uma seta sob o ponteiro
   scroll.thumb.pressed	O controle deslizante ou uma seta pressionada ou arrastada
   menubar	A barra de menu
   menubar.bottom	A última linha da barra de menu
   menubar.line	A linha sob a barra de menu
   menubar.hot	Um título de menu sob o ponteiro
   menubar.open	O título do menu aberto
   menu	O plano de 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, tiques e setas de submenu
   menu.text.disabled	Um item de menu esmaecido
   toolbar.line	A linha superior da barra de ferramentas
   toolbar.line.light	O destaque abaixo dele
   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 pressionado
   toolbar.hot.edge	A borda de um botão ativo da barra de ferramentas
   toolbar.hot.border	A borda de um botão ativo da barra de ferramentas (transparente: nenhuma)
   toolbar.split.shadow	O divisor de um botão dividido em repouso: sua sombra
   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 suspenso
   icon.disabled	A tinta de um ícone acinzentado (seu início)
   icon.disabled.end	A tinta de um ícone acinzentado (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 de "Status" 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 pixels de canto da barra de segmentos
   pieces.have	Um pedaço de torrent que está aqui
   pieces.partial	Um quadrado que representa pedaços parcialmente aqui
   pieces.missing	Um pedaço ainda não aqui
   caption	Uma barra de título que o MDM desenha
   caption.text	Seu título e glifos
   caption.text.inactive	Seu título e glifos enquanto a janela não é a 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 pressionado (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	O botão "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 ativa)
   drop-target.edge	Borda do alvo de arrastar em repouso
   egui.panel	Fundo do painel do egui
   egui.window	Fundo das dicas de ferramentas
   egui.window.border	Borda das dicas de ferramentas
   egui.text	Texto das dicas de ferramentas
   egui.selection.text	Cor do texto selecionado nas caixas do egui
   egui.extreme	Fundo mais escuro (ou mais claro) do egui
   egui.faint	Fundo suave do egui
   egui.widget	Widgets do egui em repouso
   egui.widget.border	Borda deles (transparente: nenhuma)

   Todos os tamanhos (26)

   Chave	O que define
   radius	Raio do canto de botões, caixas de texto e menus suspensos
   radius.button	Raio do canto de um botão de apertar brilhante (Luna, Aero; os do Aqua são redondos nas extremidades)
   radius.part	Raio do canto de uma parte colorida (uma zona de seta, um botão giratório)
   radius.check	Raio do canto de uma caixa de seleção
   radius.flyout	Raio do canto de um pop-up em uma janela (um calendário, uma caixa de filtro)
   radius.menu-item	Raio do canto de um item de menu sob o ponteiro
   radius.egui	Raio do canto dos próprios widgets do egui
   radius.popup	Raio do canto das dicas de ferramentas
   border	Largura da borda de um controle
   focus-line	Altura da linha de destaque de uma caixa de texto focada
   chevron.width	Espessura do traço do chevron de um menu suspenso
   font.dialog	Texto da caixa de diálogo (Tahoma nas caixas de diálogo 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 auxiliares
   font.code	Um código de login 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: dicas de ferramentas, caixas de várias linhas
   font.heading	Títulos do egui
   list.row	Altura de uma linha na lista de downloads
   list.header	Altura dos cabeçalhos das colunas da lista de downloads
   tooltip.width	Onde o texto de uma dica de ferramenta quebra
   tooltip.margin-x	Preenchimento esquerdo e direito de uma dica de ferramenta
   tooltip.margin-top	Preenchimento superior de uma dica de ferramenta
   tooltip.margin-bottom	Preenchimento inferior de uma dica de ferramenta

   Estilo de cada controle (7)

   Chave	Seus estilos
   field-focus	linha, borda, anel
   check	fluente, quadrado, adwaita, breeze, luna, aero, aqua
   button	fluente, 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 escrever

   Copie este prompt para seu assistente de IA e descreva o visual que você deseja 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 obras de arte de outras pessoas. Olhe para ambos os lados você mesmo antes de compartilhar 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 arquivo na pasta de temas do MDM. Exibir → Tema → Abrir pasta de temas a abre, e a cria na primeira vez. Ela 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, ele aparece em Exibir → Tema, abaixo dos temas integrados, pelo name que ele mesmo se dá. Escolha-o e a janela inteira muda de uma vez. Depois de editar o arquivo, escolha-o novamente em Exibir → Tema para ver a alteração. Exibir → Suporte ao Modo Escuro e Sempre escuro alternam entre seu lado claro e escuro.

   O caminho Exibir → Tema → Adicionar um arquivo de tema… faz isso por você: escolha o arquivo em qualquer lugar, e o MDM o copia para a pasta de temas e o usa imediatamente.

   Já tem um esquema Base16 ou pywal?

   Já é um tema. Um esquema Base16 ou Base24 (.yaml) ou o colors.json do pywal, adicionado da mesma forma, muda as cores do MDM e nada mais: os fundos do esquema atrás da lista e das janelas, seu texto mantido legível (4.5:1 ou mais), seu azul no foco, na seleção e na barra de progresso. Depois que wal for executado, Exibir → 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 cor vai para onde.

3. Compartilhe

   Fez algo que outras pessoas gostariam? Abra um pull request no GitHub 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;
   • uma SOURCES.txt ao lado de qualquer ícone, informando quem o desenhou e sob qual licença. Os ícones devem ser seus ou estar sob uma licença que permita ao MDM compartilhá-los (GPL-3.0), nunca copiados de outro programa.

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