Hetzelfde venster, op uw manier

Maak uw eigen thema

Een thema is een klein tekstbestand, in TOML (of JSON). Het benoemt alleen wat het verandert; al het andere komt van het thema waarop het is gebaseerd. U hoeft MDM niet te bouwen of te kunnen programmeren.

1. Maken

   Begin met een paar kleuren en voeg er gaandeweg meer toe:

   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"

   • inheritsis het thema waarvan het uwe begint: classic (de standaard), high-contrast, metro, adwaita, breeze, luna, aero, aqua, of een ander themabestand in dezelfde map.
   • [seeds]zijn een handvol kleuren (background, surface, header, text, accent, selection, error, warning, success) die MDM over elk besturingselement verspreidt. [seeds.light] en [seeds.dark] geven elke kant zijn eigen kleur.
   • [colors]stelt enkele kleurrollen in aan beide zijden, [light] en [dark] aan slechts één zijde: #rrggbb, of #rrggbbaa met transparantie.
   • [sizes]zijn hoekradii, randbreedtes, lettergroottes en rijhoogtes, in pixels. [controls] kiest de vorm van tekstvakken, selectievakjes, knoppen, voortgangsbalken, schuifbalken, de focusmarkering en de titelbalk.
   • iconsis color, mono of accent. Een thema in een eigen map (my-theme/theme.toml) kan zijn pictogrammen in icons/16 en icons/24 meebrengen, elk genoemd naar wat het toont (tb-add-url.svg, cat-music.png); -symbolic krijgen de tekstkleur van het thema.
   • contrast = "high"versterkt elke rand en tekstkleur daarboven.

   Een sleutel die MDM niet kent, of een waarde die het niet kan lezen, wordt overgeslagen en naar het logboek van MDM geschreven (de map logs naast de themamap), zodat een bestand dat voor een nieuwere MDM is gemaakt, nog steeds wordt geladen. De ingebouwde thema's zijn op dezelfde manier geschreven: lees ze op GitHub.

   Elke kleurrol (156)

   Sleutel	Wat het kleurt
   window	Achtergrond van Windows en dialoogvensters
   text	Tekst en symbolen
   text.disabled	Uitgeschakelde tekst, de ene grijstint van elke grijs weergegeven besturing en label
   text.muted	Secundaire tekst: notities, groottes, versies
   link	Tekst die iets opent
   error	Fouttekst
   error.strong	Bericht van een mislukte controle in Opties (verbinding, browser en helpertests)
   warning	Waarschuwingstekst
   success	Succestekst (een overeenkomende checksum)
   reach.near	De server van een download dichtbij de round trip (minder dan 60 ms), in Eigenschappen
   reach.medium	Een server met een gemiddelde round trip (60 tot 150 ms)
   reach.far	Een server ver weg door zijn round trip (meer dan 150 ms)
   flag.edge	De dunne rand rond de vlag van een land
   accent	Het accent: focuslijnen, open en standaard besturingselementen, filters, focus van links
   focus.ring	De gestippelde toetsenbordfocusrechthoek
   selection	De vulling van een selectie: rijen, een gekozen dag, geselecteerde tekst
   selection.text	Tekst op de selectie
   selection.muted	Secundaire tekst op de selectie
   selection.inactive	Een geselecteerde rij in een lijst zonder focus
   selection.focus	De gestippelde omtrek van de gefocuste rij op een geselecteerde rij
   group.line	Het kader van een groepsbox
   etch.shadow	De schaduwlijn van een geëtste scheidingslijn
   etch.light	De highlightlijn van een geëtste scheidingslijn
   tab.page	De inhoud van een tabbladpagina
   tab	Een niet-geselecteerd tabblad en de schaduw van de pagina
   tab.hot	Een tabblad onder de muisaanwijzer
   chevron	De pijl van een vervolgkeuzelijst of keuzelijst met invoervak
   chevron.disabled	Een grijze pijl
   subtle.hot	Een onderdeel zonder eigen uiterlijk (een pijl, een kolomkop) onder de muisaanwijzer
   subtle.pressed	Zo'n onderdeel ingedrukt of geopend
   highlight.hot	Een dag of pijl van een kalender onder de muisaanwijzer, een drop-doel
   highlight.pressed	Een dag of pijl van een kalender ingedrukt
   field	De binnenkant van een tekstvak of lijst
   field.border	De rand van een tekstvak
   field.bottom	De onderste lijn van een tekstvak terwijl erin getypt kan worden
   field.disabled	De binnenkant van een grijs tekstvak
   field.disabled.border	De rand van een grijs tekstvak
   field.readonly	De binnenkant van een alleen-lezen tekstvak
   field.readonly.border	De rand van een alleen-lezen tekstvak
   combo.chevron	De chevron van een vervolgkeuzelijst
   combo.arrow.hot	Het pijlvlak van een bewerkbare vervolgkeuzelijst onder de muisaanwijzer
   combo.arrow.pressed	Het pijlvlak van een bewerkbare vervolgkeuzelijst ingedrukt of geopend
   button	Het vlak van een knop
   button.hot	Het vlak van een knop onder de muisaanwijzer
   button.pressed	Het vlak van een knop ingedrukt
   button.border	De rand van een knop
   button.bottom	De onderrand van een knop
   button.text	De tekst van een knop
   button.text.pressed	De tekst van een knop ingedrukt
   button.default.border	De rand van de standaardknop
   button.default.bottom	De onderrand van de standaardknop
   button.disabled	Het vlak van een grijze knop
   button.disabled.border	De rand van een grijze knop
   button.accent	Het vlak van een accentknop
   button.accent.hot	Vlak van een accentknop onder de muisaanwijzer
   button.accent.pressed	Vlak van een accentknop ingedrukt
   button.accent.bottom	Onderste rand van een accentknop
   button.accent.text	Tekst van een accentknop
   button.accent.text.pressed	Tekst van een accentknop ingedrukt
   button.glow	De gloed in een knop onder de muisaanwijzer, indien de stijl dit tekent (Luna; transparant: geen)
   gloss	De glans waar glimmende delen naar overvloeien aan de bovenkant: knoppen, vakken, balken en titelbalken (Luna, Aero, Aqua)
   check	Binnenkant van een niet-aangevinkt selectievakje of keuzerondje
   check.hot	De binnenkant onder de muisaanwijzer
   check.pressed	De binnenkant ingedrukt
   check.border	Rand van een niet-aangevinkt selectievakje of keuzerondje
   check.border.hot	De rand onder de muisaanwijzer
   check.border.pressed	De rand ingedrukt
   check.border.disabled	Rand van een grijs niet-aangevinkt selectievakje
   check.on	Accent van een aangevinkt selectievakje of keuzerondje
   check.on.hot	Het aangevinkte accent onder de muisaanwijzer
   check.on.pressed	Het aangevinkte accent ingedrukt
   check.on.disabled	Vulling van een grijs aangevinkt selectievakje
   check.mark	Het vinkje of de stip op het aangevinkte accent
   progress.track	Spoor van een voortgangsbalk
   progress.bar	Vulling van een voortgangsbalk
   meter.track	Spoor van een meter (deel van een download voltooid)
   meter.edge	Rand van een meter
   meter.fill	Vulling van een meter
   list	Achtergrond van de downloadlijst
   list.frame	Omtrek van een lijst, tabel of vak
   grid	Rasterlijnen tussen rijen van een lijst in dialoogvensters
   list.grid	Rasterlijnen van de downloadlijst
   header	Kolomkoppen van elke lijst en tabel
   header.line	Onderste lijn van een kop in lijsten van dialoogvensters
   header.sep	De scheidingen tussen kolomkoppen
   table.line	De scheidingen in de tabellen van de linkgrabber en 'Torrent toevoegen'
   header.sorted	De kop van de gesorteerde kolom
   header.sort-arrow	Het sorteerpijltje
   row.pressed	Een ingedrukte rij in een lijst
   chip.web	De chip 'Web' in de downloadlijst
   chip.torrent	De chip 'Torrent' in de downloadlijst
   chip.text	Tekst op een chip
   list.drag-ghost	Een versleepte kolomkop
   list.marquee	De selectieband die rijen selecteert
   list.marquee.border	De rand van de selectieband
   scroll.track	Het spoor van een schuifbalk
   scroll.corner	Waar twee schuifbalken samenkomen
   scroll.thumb	De schuif en pijlen van een schuifbalk
   scroll.thumb.hot	De schuif of een pijl onder de aanwijzer
   scroll.thumb.pressed	De schuif of een pijl ingedrukt of versleept
   menubar	De menubalk
   menubar.bottom	De laatste rij van de menubalk
   menubar.line	De lijn onder de menubalk
   menubar.hot	Een menutitel onder de aanwijzer
   menubar.open	De titel van het geopende menu
   menu	De achtergrond van een menu
   menu.item	Een menu-item
   menu.hot	Een menu-item onder de aanwijzer
   menu.border	De rand van een menu en een pop-up
   menu.sep	De scheidingen van een menu
   menu.text	De tekst van een menu
   menu.glyph	Opsommingstekens, vinkjes en submenu-pijlen
   menu.text.disabled	Een grijs menu-item
   toolbar.line	De bovenste lijn van de werkbalk
   toolbar.line.light	De markering eronder
   toolbar.hot	Een werkbalkknop onder de aanwijzer
   toolbar.hot.faint	Het andere deel van een gesplitste knop terwijl één deel onder de aanwijzer is
   toolbar.pressed	Een ingedrukte werkbalkknop
   toolbar.hot.edge	De rand van een actieve werkbalkknop
   toolbar.hot.border	De rand van een actieve werkbalkknop (transparant: geen)
   toolbar.split.shadow	De schaduw van de scheidingslijn van een gesplitste knop in rust
   toolbar.split.light	De markering van de scheidingslijn
   toolbar.text.disabled	Een grijs werkbalklabel
   toolbar.arrow	De pijl van een vervolgkeuzeknop
   icon.disabled	De inkt van een grijs pictogram (het begin)
   icon.disabled.end	De inkt van een grijs pictogram (het einde)
   tree	De achtergrond van de categorieënboom
   tree.lines	De gestippelde verbindingslijnen van de boom
   tree.expander	De chevrons van de boom, waar de variant ze tekent
   tree.frame	Het kader van het categorieënpaneel
   progress.status	De waarde van de status in het voortgangsvenster
   progress.label.disabled	Een grijs label in het voortgangsvenster
   segments.border	Het kader van de segmentbalk
   segments.corner	De hoekpixels van de segmentbalk
   pieces.have	Een torrentdeel dat hier is
   pieces.partial	Een vierkant dat staat voor gedeeltelijk aanwezige delen
   pieces.missing	Een deel dat nog niet hier is
   caption	Een titelbalk die MDM zelf tekent
   caption.text	De titel en symbolen ervan
   caption.text.inactive	De titel en symbolen ervan wanneer het venster niet actief is, en die van een grijze knop
   caption.hot	Een titelbalkknop onder de aanwijzer (een tint over de balk)
   caption.pressed	Een ingedrukte titelbalkknop (een tint over de balk)
   caption.button	Een titelbalkknop in rust, waar de stijl er een toont (een tint over de balk; transparant: geen)
   caption.close	Sluiten onder de aanwijzer
   caption.close.text	Pictogram van Sluiten onder de aanwijzer
   caption.inactive	Een titelbalk getekend door MDM, wanneer het venster niet actief is (transparant: zoals wanneer actief)
   drop-target.edge	De rand van het doelvlak in rust
   egui.panel	Achtergrond van egui-paneel
   egui.window	Achtergrond van tooltips
   egui.window.border	Rand van tooltips
   egui.text	Tekst van tooltips
   egui.selection.text	Kleur van geselecteerde tekst in egui-vakken
   egui.extreme	Donkerste (of lichtste) achtergrond van egui
   egui.faint	Vage achtergrond van egui
   egui.widget	egui-widgets in rust
   egui.widget.border	Hun rand (transparant: geen)

   Alle afmetingen (26)

   Sleutel	Wat het instelt
   radius	Hoekradius van knoppen, tekstvakken en vervolgkeuzelijsten
   radius.button	Hoekradius van een glanzende drukknop (Luna, Aero; Aqua's zijn rond aan de uiteinden)
   radius.part	Hoekradius van een getint deel (een pijlzône, een draaiknop)
   radius.check	Hoekradius van een selectievakje
   radius.flyout	Hoekradius van een pop-up in een venster (een kalender, een filtervak)
   radius.menu-item	Hoekradius van een menu-item onder de aanwijzer
   radius.egui	Hoekradius van egui's eigen widgets
   radius.popup	Hoekradius van tooltips
   border	Breedte van de rand van een besturingselement
   focus-line	Hoogte van de accentlijn van een tekstvak met focus
   chevron.width	Lijndikte van de chevron van een vervolgkeuzelijst
   font.dialog	Dialoogtekst (Tahoma in IDM-dialogen)
   font.dialog.bold	Titels van Opties-pagina's
   font.title	Kop van een venster (Tahoma Bold): van de browserextensie, van de helpers
   font.code	Een aanmeldcode om in te typen op de pagina van een service
   font.ui	Menu's en de tekst van het hoofdvenster (Segoe UI)
   font.ui.bold	Vetgedrukte koppen in het hoofdvenster
   font.small	kleine tekst van egui
   font.body	hoofdtekst van egui: tooltips, tekstvakken met meerdere regels
   font.heading	koppen van egui
   list.row	Hoogte van een rij in de downloadlijst
   list.header	Hoogte van de kolomkoppen van de downloadlijst
   tooltip.width	Waar de tekst van een tooltip afbreekt
   tooltip.margin-x	Linker- en rechteropvulling van een tooltip
   tooltip.margin-top	Bovenste opvulling van een tooltip
   tooltip.margin-bottom	Onderste opvulling van een tooltip

   Elke besturingsstijl (7)

   Sleutel	De stijlen
   field-focus	lijn, rand, ring
   check	Fluent, Square, Adwaita, Breeze, Luna, Aero, Aqua
   button	Fluent, Breeze, Luna, Aero, Aqua
   progress	lijn, balk, blokken, glans
   scroll	overlay, classic
   caption	systeem, metro, adwaita, breeze, luna, aero, aqua
   focus	gestippeld, ring, kader

   Of laat een AI-assistent het schrijven

   Kopieer deze prompt naar uw AI-assistent en beschrijf aan het einde de gewenste look. Het geeft de assistent het formaat, de sleutels en de regels: leesbare tekst en een zichtbare focus aan beide zijden, en niets gekopieerd van andermans kunstwerk. Bekijk beide zijden zelf voordat u het resultaat deelt.

   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. Probeer het, zonder MDM te bouwen

   Plaats het bestand in de themamap van MDM. Beeld → Thema → Map met thema's openen opent deze, en maakt deze de eerste keer aan. Het bevindt zich in de gegevensmap van MDM:

   Windows

   %APPDATA%\misterdownloadmanager\themes

   Linux

   ~/.local/share/misterdownloadmanager/themes

   macOS

   ~/Library/Application Support/misterdownloadmanager/themes

   Draagbare kopie

   data\themesnaast het programma

   Binnen twee seconden verschijnt het in Beeld → Thema, onder de ingebouwde thema's, met de name die het zichzelf geeft. Kies het en het hele venster verandert onmiddellijk. Nadat u het bestand hebt bewerkt, kiest u het opnieuw in Beeld → Thema om de wijziging te zien. Beeld → Ondersteuning voor donkere modus en Altijd donker schakelen tussen de lichte en donkere kant.

   Beeld → Thema → Themabestand toevoegen… doet het voor u: kies het bestand, waar het ook staat, en MDM kopieert het naar de themamap en gebruikt het meteen.

   Hebt u al een Base16- of pywal-schema?

   Dat is al een thema. Een Base16- of Base24-schema (.yaml) of pywal's colors.json, op dezelfde manier toegevoegd, verandert alleen de kleuren van MDM: de achtergronden van het schema achter de lijst en de vensters, de tekst blijft leesbaar (4.5:1 of meer), het blauw op de focus, de selectie en de voortgangsbalk. Zodra wal is uitgevoerd, toont Beeld → Thema pywal, gelezen uit ~/.cache/wal/colors.json (%USERPROFILE%\.cache\wal\colors.jsonop Windows), en MDM volgt de kleuren van elk nieuw bureaubladachtergrond binnen twee seconden. De handleiding laat zien welke kleur waar hoort.

3. Delen

   Iets gemaakt dat anderen leuk zouden vinden? Open een pull-aanvraag op GitHub die het toevoegt aan crates/app/assets/themes, met:

   • het .toml-bestand, en de map met pictogrammen als die er is;
   • schermafbeeldingen van het hoofdvenster in de lichte en donkere modus;
   • een SOURCES.txt naast eventuele pictogrammen, met de naam van de ontwerper en de licentie. Pictogrammen moeten van uzelf zijn of onder een licentie vallen die MDM toestaat ze te delen (GPL-3.0), en mogen nooit van een ander programma zijn gekopieerd.

   Nog niet zeker? Laat het eerst zien in de discussies. De bijdragegids legt uit hoe pull-aanvragen hier werken.