Un tema cambia l'aspetto di DDM, ma mantiene tutto al suo posto: le stesse finestre, menu e pulsanti nelle stesse posizioni, disegnati con altri colori, forme e icone. Ogni tema ha un lato chiaro e uno scuro.
Scegli un tema
Apri Visualizza → Tema e fai clic su un tema: l'intera finestra cambia subito, senza bisogno di riavviare. Visualizza → Supporto modalità scura e Visualizza → Sempre scuro scelgono poi il lato chiaro o scuro, come per l'aspetto classico (Modalità scura).
I temi integrati sono Classico (l'aspetto predefinito di DDM), Nativo (colore principale e contrasto del sistema), Contrasto elevato e i temi di stile Metro, Adwaita, Breeze, Luna, Aero, Aqua e Smeraldo, ognuno con le proprie forme dei controlli e icone, e su Windows la propria barra del titolo. La pagina Per iniziare descrive ogni tema; la pagina Temi del sito web li mostra tutti, chiari e scuri.
Dove vanno i file dei temi
I file dei temi che crei o scarichi vanno nella cartella dei temi di DDM. Visualizza → Tema → Apri la cartella dei temi la apre (e la crea la prima volta). Si trova nella cartella dei dati di DDM:
| Sistema | Cartella |
|---|---|
| Windows | %APPDATA%\dannexdownloadmanager\themes |
| Linux | ~/.local/share/dannexdownloadmanager/themes |
| macOS | ~/Library/Application Support/dannexdownloadmanager/themes |
| Copia portatile | data\themesaccanto al programma |
Entro due secondi un nuovo file appare in Visualizza → Tema, sotto i temi integrati, con il name che si dà. Dopo aver modificato un file, selezionalo di nuovo in Visualizza → Tema per vedere la modifica.
Un tema può essere un singolo file (harbour.toml) o una propria cartella (harbour/theme.toml) quando include icone.
Visualizza → Tema → Aggiungi un file di tema… lo fa per te: scegli un file ovunque si trovi e DDM lo copia nella cartella dei temi e lo usa subito. Un file che non è un tema viene rifiutato e DDM spiega perché.
Combinazioni di colori Base16 e pywal
Le combinazioni di colori create per altri programmi sono anch'esse temi, senza bisogno di conversioni:
- Una combinazione Base16, il file
.yamlin cui sono contenute le combinazioni Base16 e Base24: sia il layout classico (scheme:e dabase00abase0Fin alto) sia quello più recente (name:e un bloccopalette:). Una combinazione Base24 viene letta come i suoi primi 16 colori. - Il file
colors.jsondi pywal, o il file di qualsiasi programma nella forma di pywal (il modello pywal di wallust).
Aggiungilo con Visualizza → Tema → Aggiungi un file di tema…, oppure mettilo tu stesso nella cartella dei temi. Appare in Visualizza → Tema sotto il nome della combinazione (name: o scheme:; quello di pywal prende il nome dallo sfondo).
pywal stesso: una volta che wal è stato eseguito, Visualizza → Tema elenca pywal, letto direttamente da dove pywal scrive i suoi colori: ~/.cache/wal/colors.json (su Windows %USERPROFILE%\.cache\wal\colors.json, dove winwal e pywal lo scrivono; $PYWAL_CACHE_DIR o $XDG_CACHE_HOME/wal quando li imposti). Selezionalo e DDM seguirà il tuo sfondo: ogni volta che wal scrive nuovi colori, DDM li riprende entro due secondi. Controlla solo la data e la dimensione del file, ogni due secondi, e solo mentre pywal è il tema. Una copia aggiunta con Aggiungi un file di tema… mantiene i colori che aveva.
Una combinazione cambia solo i colori, nell'aspetto classico: ogni finestra, pulsante e menu resta dove era. Una combinazione scura rende DDM scuro e una chiara lo rende chiaro, indipendentemente da ciò che dice Visualizza → Sempre scuro. I colori della combinazione vanno dove significano la stessa cosa:
| DDM | Base16 | pywal |
|---|---|---|
| L'elenco dei download, le caselle di testo e i menu | base00(lo sfondo) |
special.background |
| Finestre, finestre secondarie, la barra degli strumenti, la barra dei menu e le intestazioni di colonna | base01(lo sfondo più chiaro) |
lo sfondo un passo verso il primo piano |
| Testo | base05(il primo piano) |
special.foreground |
| Testo secondario (dimensioni, note) | base04 |
color8 |
| Stato attivo, pulsanti predefiniti, caselle di controllo, collegamenti, la selezione e la barra di avanzamento | base0D(blu) |
color4 |
| Errori | base08(rosso) |
color1 |
| Avvisi | base0A(giallo) |
color3 |
| Successo, i misuratori e le parti di un torrent | base0B(verde) |
color2 |
I bordi e le sfumature al passaggio del puntatore e alla pressione sono ricavati da questi colori, come per il [seeds] di un file di tema. Il testo resta leggibile: testo e testo secondario con un contrasto di almeno 4,5:1 rispetto a ogni sfondo su cui si trovano (WCAG AA), il colore principale di almeno 3:1. Se una combinazione non raggiunge questi valori, quei colori vengono resi un po' più scuri (più chiari in una combinazione scura) finché non li raggiungono; il log di DDM indica quali.
Per cambiare più dei colori, crea un file di tema che erediti la combinazione tramite il suo nome file e aggiunga ciò che desideri:
name = "Gruvbox, my way"
inherits = "gruvbox-dark-medium" # gruvbox-dark-medium.yaml, beside it
icons = "accent"
[sizes]
radius = 6
inherits = "pywal"funziona allo stesso modo e segue anche wal.
Il file
Un tema è un piccolo file di testo in TOML (o JSON, .json; o una combinazione di colori, .yaml). Nomina solo ciò che cambia; tutto il resto proviene dal tema che 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: ciò che Visualizza → Tema elenca; il nome del file quando non ce n'è uno.inherits: il tema da cui il tuo parte:classic(il predefinito se omesso), l'ID di un tema integrato (metro,adwaita,breeze,luna,aero,aqua,high-contrast) o un altro file di tema nella stessa cartella, con il suo nome file senza.toml. Un file che eredita un altro può essere ereditato a sua volta; un tema non può ereditare se stesso.[seeds]: una manciata di colori (background,surface,header,text,accent,selection,error,warning,success) che DDM distribuisce su ogni controllo.[seeds.light]e[seeds.dark]danno a ogni lato il suo.[colors]: ruoli di colore singolo (comewindow,accento"segments.done") su entrambi i lati;[light]e[dark]su un solo lato. Un colore è#rrggbb, o#rrggbbaacon trasparenza. I ruoli impostati da un file prevalgono sui suoi semi.[sizes]: raggi degli angoli, larghezze dei bordi, dimensioni dei caratteri e altezze delle righe, in pixel.[controls]: la forma di caselle di testo, caselle di controllo, pulsanti, barre di avanzamento, barre di scorrimento, il contorno dello stato attivo e la barra del titolo.icons:color,mono(un colore) oaccent.contrast = "high": rafforza tutti i bordi e i colori del testo, oltre al resto.
Ogni ruolo di colore, dimensione e stile di controllo, con ciò che imposta, è elencato nella pagina dei temi del sito web (letta dal codice di DDM, quindi non si discosta mai). I temi integrati sono scritti allo stesso modo: leggili su GitHub.
Una chiave che DDM non conosce, o un valore che non può leggere, viene saltata e scritta nel log di DDM (la cartella logs accanto alla cartella dei temi), in modo che un file creato per un DDM più recente si carichi comunque. Un file che non è un TOML o JSON valido non si carica, e il log dice perché. Un file con lo stesso nome di un tema integrato (metro.toml) viene ignorato: dai al tuo un nome proprio.
Icone
Un tema in una propria cartella (harbour/theme.toml) può portare le sue icone in icons/16 e icons/24 (e, per le immagini PNG, icons/32 e icons/48, usate su uno schermo scalato al 150% e oltre), ognuna nominata per ciò che mostra (tb-add-url.svg, cat-music.png…). I file SVG e PNG mantengono i loro colori; quelli -symbolic.svg e -symbolic.png, come li chiamano GNOME e KDE, assumono il colore del testo del tema. Un'icona che il set non ha viene disegnata come la disegna l'aspetto classico. L'elenco completo dei nomi è in themeicons.rs (NEEDS).
Creane uno
- Visualizza → Tema → Apri la cartella dei temi, e lì crea un nuovo file
.toml(qualsiasi editor di testo). - Inizia dall'esempio sopra: cambia i colori dei semi, poi aggiungi ruoli e dimensioni man mano.
- Selezionalo in Visualizza → Tema, e guarda entrambi i lati: Visualizza → Sempre scuro attivo e disattivo. Verifica che il testo sia leggibile e il contorno dello stato attivo visibile in entrambi.
La pagina dei temi del sito web ha un prompt che puoi dare a un assistente AI, con il formato, ogni chiave e le regole, per scrivere un tema per te da una descrizione.
Condividilo
Hai creato qualcosa che piacerebbe ad altri? Apri una pull request che lo aggiunga a crates/app/assets/themes, con:
- il file
.tomle la sua cartella di icone, se ne ha una; - screenshot della finestra principale nel suo lato chiaro e nel suo lato scuro;
- una
SOURCES.txtaccanto a ogni icona, che indichi chi l'ha disegnata e con quale licenza. Le icone devono essere tue o sotto una licenza che permetta a DDM di condividerle (GPL-3.0), mai copiate da un altro programma.
Non sei ancora sicuro? Prima mostralo nelle discussioni. CONTRIBUTING.md spiega come funzionano le pull request qui.
Passi successivi
Gratuito, open source, senza pubblicità, senza periodo di prova.
Scarica Dannex Download Manager