Temas

Un tema cambia el aspecto de MDM y mantiene todo en su sitio: las mismas ventanas, menús y botones en los mismos lugares, dibujados con otros colores, formas e iconos. Cada tema tiene un lado claro y uno oscuro.

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).

Los temas integrados son Clásico (el aspecto propio de MDM, el predeterminado), Nativo (el color de énfasis y contraste de tu sistema), Contraste alto, y los temas de estilo Metro, Adwaita, Breeze, Luna, Aero y Aqua, cada uno con sus propias formas de control e iconos, y en Windows su propia barra de título. Primeros pasos describe cada uno; la página de temas del sitio web los muestra todos, claros y oscuros.

Dónde van los archivos de tema

Los archivos de tema que crees o descargues van en la carpeta de temas de MDM. Ver → Tema → Abrir carpeta de temas la abre (y la crea la primera vez). Está en la carpeta de datos de MDM:

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.

Ver → Tema → Añadir un archivo de tema… lo hace por ti: elige un archivo en cualquier lugar y MDM lo copia a la carpeta de temas y lo usa al instante. Un archivo que no sea un tema se queda fuera y MDM te dice por qué.

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).

El propio pywal: una vez que wal se ha ejecutado, Ver → Tema muestra pywal, leído directamente desde donde pywal escribe sus colores: ~/.cache/wal/colors.json (en Windows %USERPROFILE%\.cache\wal\colors.json, donde winwal y pywal lo escriben; $PYWAL_CACHE_DIR o $XDG_CACHE_HOME/wal cuando los configuras). Elígelo y MDM seguirá tu fondo de pantalla: cada vez que wal escriba nuevos colores, MDM los tomará en dos segundos. Solo mira la fecha y el tamaño del archivo, cada dos segundos, y solo mientras pywal sea el tema. Una copia añadida con Añadir un archivo de tema… mantiene los colores que tenía.

Un esquema solo cambia los colores, en el aspecto clásico: cada ventana, botón y menú permanece donde estaba. Un esquema oscuro hace que MDM sea oscuro y uno claro, claro, independientemente de lo que diga Ver → Siempre oscuro. Los colores del esquema van donde significan lo mismo:

Los bordes y los tonos de pasar el ratón y presionar se mezclan a partir de estos, como para el [seeds] de un archivo de tema. El texto sigue siendo legible: el texto y el texto secundario con una relación de 4,5:1 o más contra cada fondo en el que se encuentran (WCAG AA), el acento en 3:1. Un esquema que no cumpla con esto tendrá esos colores un poco más oscuros (más claros en un esquema oscuro) hasta que pasen; el registro de MDM indica cuáles.

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] — un puñado de colores (background, surface, header, text, accent, selection, error, warning, success) que MDM extiende sobre cada control. [seeds.light] y [seeds.dark] dan a cada lado el suyo propio.
• [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.

Cada rol de color, tamaño y estilo de control, con lo que establece, se lista en la página de temas del sitio web (leído del propio código de MDM, para que nunca se desvíe). Los temas integrados están escritos de la misma manera: léelos en GitHub.

Una clave que MDM no conoce, o un valor que no puede leer, se omite y se escribe en el registro de MDM (la carpeta logs junto a la carpeta de temas), de modo que un archivo hecho para un MDM más nuevo aún se carga. Un archivo que no es un TOML o JSON válido no se carga, y el registro indica por qué. Un archivo con el mismo nombre que un tema integrado (metro.toml) se omite: dale al tuyo un nombre propio.

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;
• un SOURCES.txt junto a los iconos, indicando quién los dibujó y bajo qué licencia. Los iconos deben ser propios o tener una licencia que permita a MDM compartirlos (GPL-3.0); nunca copiados de otro programa.

¿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 →