Одно окно, ваш стиль

Создайте свою тему

Тема — это небольшой текстовый файл в формате TOML (или JSON). Он содержит только те параметры, которые вы меняете; всё остальное берётся из темы, на которой он основан. Вам не нужно собирать MDM или уметь программировать.

1. Создать

   Начните с нескольких цветов, затем добавляйте больше по мере необходимости:

   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— это тема, от которой начинается ваша: classic (по умолчанию), high-contrast, metro, adwaita, breeze, luna, aero, aqua или другой файл темы в той же папке.
   • [seeds]— это несколько цветов (background, surface, header, text, accent, selection, error, warning, success), которые MDM распространяет на все элементы управления. [seeds.light] и [seeds.dark] задают свой собственный для каждой стороны.
   • [colors]устанавливает роли одного цвета с обеих сторон, [light] и [dark] — только с одной стороны: #rrggbb или #rrggbbaa с прозрачностью.
   • [sizes]— это радиусы углов, ширина границ, размеры шрифтов и высота строк в пикселях. [controls] выбирает форму текстовых полей, флажков, кнопок, полос прогресса, полос прокрутки, метки фокуса и строки заголовка.
   • iconsэто color, mono или accent. Тема в отдельной папке (my-theme/theme.toml) может содержать свои значки в icons/16 и icons/24, каждый из которых назван в соответствии с тем, что он отображает (tb-add-url.svg, cat-music.png); -symbolic используют цвет текста темы.
   • contrast = "high"усиливает каждый край и цвет текста сверху.

   Неизвестный MDM ключ или нечитаемое значение пропускается и записывается в журнал MDM (папка logs рядом с папкой тем), поэтому файл, созданный для более новой версии MDM, всё равно загружается. Встроенные темы написаны таким же образом: прочитайте их на GitHub.

   Все роли цвета (156)

   Ключ	Что окрашивает
   window	Windows' and dialogs' background
   text	Текст и глифы
   text.disabled	Отключенный текст, единственный серый цвет каждого неактивного элемента управления и метки
   text.muted	Вторичный текст: примечания, размеры, версии
   link	Текст, который что-то открывает
   error	Текст ошибки
   error.strong	Сообщение о неудачной проверке в «Параметрах» (проверки подключения, браузера и вспомогательных программ)
   warning	Текст предупреждения
   success	Текст успеха (совпадающая контрольная сумма)
   reach.near	Сервер загрузки рядом с его временем отклика (менее 60 мс), в «Свойствах»
   reach.medium	Сервер со средним временем отклика (от 60 до 150 мс)
   reach.far	Сервер далеко по времени отклика (более 150 мс)
   flag.edge	Тонкий край вокруг флага страны
   accent	Акцент: линии фокуса, открытые и стандартные элементы управления, фильтры, фокус ссылок
   focus.ring	Пунктирный прямоугольник фокуса клавиатуры
   selection	Заливка выделения: строки, выбранный день, выделенный текст
   selection.text	Текст на выделении
   selection.muted	Вторичный текст на выделении
   selection.inactive	Выделенная строка в списке без фокуса
   selection.focus	Пунктирный контур сфокусированной строки на выделенной строке
   group.line	Рамка группового поля
   etch.shadow	Теневая линия вытравленного разделителя
   etch.light	Линия подсветки вытравленного разделителя
   tab.page	Тело вкладки
   tab	Невыбранная вкладка и тень страницы
   tab.hot	Вкладка под указателем
   chevron	Стрелка раскрывающегося списка или счётчика
   chevron.disabled	Неактивная стрелка
   subtle.hot	Часть без собственного оформления (стрелка, заголовок столбца) под указателем
   subtle.pressed	Такая часть нажата или открыта
   highlight.hot	День или стрелка календаря под указателем, цель перетаскивания
   highlight.pressed	День или стрелка календаря нажаты
   field	Внутренняя часть текстового поля или списка
   field.border	Граница текстового поля
   field.bottom	Нижняя линия текстового поля, когда в него можно вводить текст
   field.disabled	Внутренняя часть неактивного текстового поля
   field.disabled.border	Граница неактивного текстового поля
   field.readonly	Внутренняя часть текстового поля только для чтения
   field.readonly.border	Граница текстового поля только для чтения
   combo.chevron	Шеврон раскрывающегося списка
   combo.arrow.hot	Зона стрелки редактируемого раскрывающегося списка под указателем
   combo.arrow.pressed	Зона стрелки редактируемого раскрывающегося списка нажата или открыта
   button	Лицевая сторона кнопки
   button.hot	Лицевая сторона кнопки под указателем
   button.pressed	Лицевая сторона кнопки нажата
   button.border	Граница кнопки
   button.bottom	Нижний край кнопки
   button.text	Текст кнопки
   button.text.pressed	Текст кнопки нажат
   button.default.border	Граница кнопки по умолчанию
   button.default.bottom	Нижний край кнопки по умолчанию
   button.disabled	Лицевая сторона неактивной кнопки
   button.disabled.border	Граница неактивной кнопки
   button.accent	Лицевая сторона акцентной кнопки
   button.accent.hot	Лицевая сторона акцентной кнопки под указателем
   button.accent.pressed	Лицевая сторона акцентной кнопки при нажатии
   button.accent.bottom	Нижний край акцентной кнопки
   button.accent.text	Текст акцентной кнопки
   button.accent.text.pressed	Текст акцентной кнопки при нажатии
   button.glow	Свечение внутри кнопки под указателем, если стиль его предусматривает (Luna; прозрачный: нет)
   gloss	Блеск, к которому сверху переходят глянцевые части: кнопки, поля, полосы и заголовки (Luna, Aero, Aqua)
   check	Внутренняя часть невыбранного флажка или переключателя
   check.hot	Его внутренняя часть под указателем
   check.pressed	Его внутренняя часть при нажатии
   check.border	Граница невыбранного флажка или переключателя
   check.border.hot	Его граница под указателем
   check.border.pressed	Его граница при нажатии
   check.border.disabled	Граница неактивного невыбранного флажка
   check.on	Акцент выбранного флажка или переключателя
   check.on.hot	Выбранный акцент под указателем
   check.on.pressed	Выбранный акцент при нажатии
   check.on.disabled	Заливка неактивного выбранного флажка
   check.mark	Галочка или точка на выбранном акценте
   progress.track	Полоса индикатора выполнения
   progress.bar	Заливка индикатора выполнения
   meter.track	Полоса измерителя (выполненная часть загрузки)
   meter.edge	Край измерителя
   meter.fill	Заливка измерителя
   list	Фон списка загрузок
   list.frame	Контур списка, таблицы или поля
   grid	Линии сетки между строками списка в диалоговых окнах
   list.grid	Линии сетки списка загрузок
   header	Заголовки столбцов всех списков и таблиц
   header.line	Нижняя линия заголовка в списках диалоговых окон
   header.sep	Разделители между заголовками столбцов
   table.line	Разделители в таблицах перехватчика ссылок и диалогового окна «Добавить торрент»
   header.sorted	Заголовок отсортированного столбца
   header.sort-arrow	Шеврон сортировки
   row.pressed	Нажатая строка списка
   chip.web	Чип «Веб» в списке загрузок
   chip.torrent	Чип «Торрент» в списке загрузок
   chip.text	Текст на чипе
   list.drag-ghost	Перетаскиваемый заголовок столбца
   list.marquee	Резиновая рамка для выделения строк
   list.marquee.border	Край резиновой рамки
   scroll.track	Дорожка полосы прокрутки
   scroll.corner	Место пересечения двух полос прокрутки
   scroll.thumb	Ползунок и стрелки полосы прокрутки
   scroll.thumb.hot	Ползунок или стрелка под указателем
   scroll.thumb.pressed	Нажатый или перетаскиваемый ползунок или стрелка
   menubar	Строка меню
   menubar.bottom	Последняя строка строки меню
   menubar.line	Линия под строкой меню
   menubar.hot	Название меню под указателем
   menubar.open	Название открытого меню
   menu	Фон меню
   menu.item	Пункт меню
   menu.hot	Пункт меню под указателем
   menu.border	Рамка меню и всплывающего окна
   menu.sep	Разделители меню
   menu.text	Текст меню
   menu.glyph	Маркеры, галочки и стрелки подменю
   menu.text.disabled	Неактивный пункт меню
   toolbar.line	Верхняя линия панели инструментов
   toolbar.line.light	Подсветка под ним
   toolbar.hot	Кнопка панели инструментов под указателем
   toolbar.hot.faint	Другая часть разделённой кнопки, когда одна из них находится под указателем
   toolbar.pressed	Нажатая кнопка панели инструментов
   toolbar.hot.edge	Край активной кнопки панели инструментов
   toolbar.hot.border	Граница активной кнопки панели инструментов (прозрачная: нет)
   toolbar.split.shadow	Разделитель разделённой кнопки в покое: его тень
   toolbar.split.light	Подсветка разделителя
   toolbar.text.disabled	Неактивная надпись на панели инструментов
   toolbar.arrow	Стрелка кнопки раскрывающегося списка
   icon.disabled	Цвет неактивного значка (начало)
   icon.disabled.end	Цвет неактивного значка (конец)
   tree	Фон дерева категорий
   tree.lines	Пунктирные соединители дерева
   tree.expander	Шевроны дерева, если вариант их рисует
   tree.frame	Рамка панели категорий
   progress.status	Значение «Состояние» в окне хода выполнения
   progress.label.disabled	Неактивная надпись в окне хода выполнения
   segments.border	Рамка полосы сегментов
   segments.corner	Угловые пиксели полосы сегментов
   pieces.have	Часть торрента, которая здесь
   pieces.partial	Квадрат, обозначающий частично присутствующие части
   pieces.missing	Часть, которой ещё нет
   caption	Строка заголовка, которую MDM рисует сам
   caption.text	Её заголовок и глифы
   caption.text.inactive	Её заголовок и глифы, когда окно неактивно, и неактивной кнопки
   caption.hot	Кнопка заголовка под указателем (оттенок поверх полосы)
   caption.pressed	Нажатая кнопка заголовка (оттенок поверх полосы)
   caption.button	Кнопка заголовка в покое, если стиль её показывает (оттенок поверх полосы; прозрачная: нет)
   caption.close	Кнопка «Закрыть» под указателем
   caption.close.text	Глиф кнопки «Закрыть» под указателем
   caption.inactive	Заголовок окна, нарисованный MDM, когда окно неактивно (прозрачный: как при активности)
   drop-target.edge	Край области перетаскивания в покое
   egui.panel	Фон панели egui
   egui.window	Фон всплывающих подсказок
   egui.window.border	Граница всплывающих подсказок
   egui.text	Текст всплывающих подсказок
   egui.selection.text	Цвет выделенного текста в полях egui
   egui.extreme	Самый тёмный (или самый светлый) фон egui
   egui.faint	Слабый фон egui
   egui.widget	Виджеты egui в покое
   egui.widget.border	Их граница (прозрачная: нет)

   Все размеры (26)

   Ключ	Что устанавливает
   radius	Радиус скругления кнопок, текстовых полей и выпадающих списков
   radius.button	Радиус скругления глянцевой кнопки (Luna, Aero; у Aqua они круглые по краям)
   radius.part	Радиус скругления тонированной части (область стрелки, кнопка-счётчик)
   radius.check	Радиус скругления флажка
   radius.flyout	Радиус скругления всплывающего окна (календарь, поле фильтра)
   radius.menu-item	Радиус скругления пункта меню под указателем
   radius.egui	Радиус скругления собственных виджетов egui
   radius.popup	Радиус скругления всплывающих подсказок
   border	Ширина границы элемента управления
   focus-line	Высота акцентной линии текстового поля в фокусе
   chevron.width	Толщина штриха шеврона выпадающего списка
   font.dialog	Текст диалоговых окон (Tahoma в диалоговых окнах IDM)
   font.dialog.bold	Заголовки страниц «Параметров»
   font.title	Заголовок окна (Tahoma Bold): расширения браузера, помощников
   font.code	Код для входа, который нужно ввести на странице сервиса
   font.ui	Текст меню и главного окна (Segoe UI)
   font.ui.bold	Жирные заголовки в главном окне
   font.small	Малый текст egui
   font.body	Основной текст egui: всплывающие подсказки, многострочные поля
   font.heading	Заголовки egui
   list.row	Высота строки в списке загрузок
   list.header	Высота заголовков столбцов списка загрузок
   tooltip.width	Место переноса текста всплывающей подсказки
   tooltip.margin-x	Левый и правый отступ всплывающей подсказки
   tooltip.margin-top	Верхний отступ всплывающей подсказки
   tooltip.margin-bottom	Нижний отступ всплывающей подсказки

   Стили всех элементов управления (7)

   Ключ	Его стили
   field-focus	линия, граница, кольцо
   check	fluent, square, adwaita, breeze, luna, aero, aqua
   button	fluent, breeze, luna, aero, aqua
   progress	линия, полоса, блоки, глянец
   scroll	наложение, классический
   caption	Системная, Metro, Adwaita, Breeze, Luna, Aero, Aqua
   focus	точечный, кольцо, рамка

   Или пусть его напишет ИИ-помощник

   Скопируйте этот запрос в своего ИИ-помощника и опишите желаемый вид в конце. Он предоставит помощнику формат, ключи и правила: читаемый текст и видимый фокус с обеих сторон, а также ничего, скопированного из чужих работ. Проверьте обе стороны самостоятельно, прежде чем делиться результатом.

   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. Попробуйте, не собирая MDM

   Поместите файл в папку тем MDM. Вид → Тема → Открыть папку с темами откроет её и создаст, если её нет. Она находится в папке данных MDM:

   Windows

   %APPDATA%\misterdownloadmanager\themes

   Linux

   ~/.local/share/misterdownloadmanager/themes

   macOS

   ~/Library/Application Support/misterdownloadmanager/themes

   Портативная копия

   data\themesрядом с программой

   В течение двух секунд она появится в Вид → Тема, под встроенными темами, с name, которую она сама себе присваивает. Выберите её, и всё окно изменится сразу. После редактирования файла выберите её снова в Вид → Тема, чтобы увидеть изменения. Вид → Поддержка темного режима и Всегда темная переключают между светлой и темной сторонами.

   Для этого служит Вид → Тема → Добавить файл темы…: выберите файл в любом месте, и MDM скопирует его в папку с темами и сразу же применит.

   Уже есть схема Base16 или pywal?

   Это уже тема. Схема Base16 или Base24 (.yaml) или colors.json от pywal, добавленная таким же образом, меняет только цвета MDM: фоны схемы за списком и окнами, текст остается читаемым (4.5:1 или более), синий цвет для фокуса, выделения и полосы прогресса. После запуска wal в Вид → Тема появится pywal, считанный из ~/.cache/wal/colors.json (%USERPROFILE%\.cache\wal\colors.jsonв Windows), и MDM будет следовать цветам новых обоев в течение двух секунд. Руководство показывает, какой цвет куда применяется.

3. Поделиться

   Сделали что-то, что понравится другим? Откройте pull request на GitHub, который добавит это в crates/app/assets/themes, со следующим:

   • файл .toml и его папка с иконками, если таковая имеется;
   • скриншоты главного окна в светлом и темном режимах;
   • рядом с любыми значками SOURCES.txt, указывая, кто их нарисовал и по какой лицензии. Значки должны быть вашими собственными или под лицензией, которая позволяет MDM делиться ими (GPL-3.0), и никогда не копироваться из другой программы.

   Ещё не уверены? Сначала покажите это в обсуждениях. Руководство по участию объясняет, как здесь работают запросы на слияние.