MELI-THEMES(5)
meli-themes 💖 the manual, but make it cute
File Formats Manual · meli-themes(5)
✨ NAME ✨
meli-themes — themes for the meli(1) terminal e-mail client 🎀
🌸 SYNOPSIS 🌸
ok so meli ships with two themes out of the box, bestie: dark (that's the default, she's the moment) and light. 🌗
Custom themes are defined as lists of key-values in the configuration files:
$XDG_CONFIG_HOME/meli/config.toml
$XDG_CONFIG_HOME/meli/themes/*.tomlThe application theme is defined in the configuration as follows:
[terminal]
theme = "dark"🦋 DESCRIPTION 🦋
Themes for meli are described in the configuration language TOML, because they're key-value tables defined in the TERMINAL section of the configuration file. Every key defines the semantic location of the theme attribute inside the app. Like, mail.listing.compact.* keys? Those are the settings for the compact mail listing style. iykyk. 💅
A setting contains three fields:
fg— foreground colorbg— background colorattrs— text attribute
"widget.key.label" = { fg = "Default", bg = "Default", attrs = "Default" }Each field holds a value, and that value can be either a color/attribute, a link (aka a key name), or a valid alias. An alias is a string that starts with the "$" character, and no cap, it must be declared in advance in the color_aliases or attr_aliases fields of a theme. An alias' value can be literally any valid value — links and other aliases included — as long as they're valid. 🫶
When it's a link, the setting's real value depends on the value of the referred key. This is how you get defaults inside a group of associated values, slay. But bestie — cyclic references in a theme result in an error:
spooky theme contains a cycle: fg: mail.listing.compact.even ->
mail.listing.compact.highlighted -> mail.listing.compact.odd ->
mail.listing.compact.evenTwo themes are included by default, ‘light’ and ‘dark’. 👑
🎀 EXAMPLES 🎀
Specific settings from already defined themes can be overwritten:
[terminal]
theme = "dark"
[terminal.themes.dark]
"mail.sidebar_highlighted_account" = { bg = "#ff4529" }
"mail.listing.attachment_flag" = { fg = "#ff4529" }
"mail.view.headers" = { fg = "30" }
"mail.view.body" = {fg = "HotPink3", bg = "LightSalmon1"}
# Linked value keys can be whatever key:
"mail.listing.compact.even_unseen" = { bg = "mail.sidebar_highlighted_account" }
# Linked color value keys can optionally refer to another field:
"mail.listing.compact.odd_unseen" = { bg = "mail.sidebar_highlighted_account.fg" }
# define new theme. Undefined settings will inherit from the default "dark" theme.
[terminal.themes."hunter2"]
color_aliases= { "Jebediah" = "#b4da55" }
"mail.listing.tag_default" = { fg = "$Jebediah" }
"mail.view.headers" = { fg = "White", bg = "Black" }🌈 CUSTOM THEMES 🌈
Custom themes can live right inside your configuration files, or they can be saved independently in your $XDG_CONFIG_HOME/meli/themes/ directory as TOML files. ✨
Wanna start creating a theme right this second? You can begin by editing the default theme keys and values:
meli print-default-theme > ~/.config/meli/themes/new_theme.tomlnew_theme.toml will now include all keys and values of the "dark" theme. 💖
meli print-loaded-themeswill print all loaded themes with the links resolved. 🔥
💅 VALID ATTRIBUTE VALUES 💅
Case-sensitive. Don't play with her. 😤
"Default""Bold""Dim""Italics""Underline""Undercurl""Blink""Reverse""Hidden"- Any combo of the above separated by a bitwise XOR
"|"eg"Dim | Italics"
⭐ VALID COLOR VALUES ⭐
Color values are of type String with the following valid contents:
"Default"is the terminal default. (Case-sensitive)- Hex triplet e.g.
#FFFFFFfor RGB colors. Three character shorthand is also valid, e.g.#09c→#0099cc(Case-insensitive) 0-255byte for 256 colors.xterm(1)name but with some modifications (for a full table see COLOR NAMES addendum) (Case-sensitive)
🙈 NO COLOR 🙈
To completely disable ANSI colors, there are two options:
- Set the
use_coloroption (sectionterminal) tofalse, which istrueby default. - The
NO_COLORenvironmental variable, when present (regardless of its value), prevents the addition of ANSI color. When the configuration valueuse_coloris explicitly set totrueby the user,NO_COLORis ignored.
In this mode, cursor locations (i.e., currently selected entries/items) will use the ‘reverse video’ ANSI attribute to invert the terminal's default foreground/background colors. 🌀
👑 VALID KEYS 👑
theme_defaulterror_messagehighlightstatus.barstatus.command_barstatus.historystatus.history.hintsstatus.notificationtab.focusedtab.unfocusedtab.barwidgets.list.headerwidgets.form.labelwidgets.form.fieldwidgets.form.highlightedwidgets.options.highlightedmail.sidebarmail.sidebar_dividermail.sidebar_unread_countmail.sidebar_indexmail.sidebar_highlightedmail.sidebar_highlighted_unread_countmail.sidebar_highlighted_indexmail.sidebar_highlighted_accountmail.sidebar_highlighted_account_unread_countmail.sidebar_highlighted_account_indexmail.listing.compact.evenmail.listing.compact.oddmail.listing.compact.even_unseenmail.listing.compact.odd_unseenmail.listing.compact.even_selectedmail.listing.compact.odd_selectedmail.listing.compact.even_highlightedmail.listing.compact.odd_highlightedmail.listing.compact.even_highlighted_selectedmail.listing.compact.odd_highlighted_selectedmail.listing.plain.evenmail.listing.plain.oddmail.listing.plain.even_unseenmail.listing.plain.odd_unseenmail.listing.plain.even_selectedmail.listing.plain.odd_selectedmail.listing.plain.even_highlightedmail.listing.plain.odd_highlightedmail.listing.plain.even_highlighted_selectedmail.listing.plain.odd_highlighted_selectedmail.listing.conversationsmail.listing.conversations.subjectmail.listing.conversations.frommail.listing.conversations.datemail.listing.conversations.unseenmail.listing.conversations.highlightedmail.listing.conversations.selectedmail.listing.conversations.highlighted_selectedmail.view.headersmail.view.headers_namesmail.view.headers_areamail.view.bodymail.view.thread.indentation.amail.view.thread.indentation.bmail.view.thread.indentation.cmail.view.thread.indentation.dmail.view.thread.indentation.email.view.thread.indentation.fmail.listing.attachment_flagmail.listing.thread_snooze_flagmail.listing.tag_defaultpager.highlight_searchpager.highlight_search_current
✨ COLOR NAMES ✨
okay bestie, here's the full color name dictionary, and it's literally a rainbow of options. every name maps to a byte value, so you can use either the name or the number. no cap. first chunk:
Aqua—14Black—0Aquamarine1—122Maroon—1Aquamarine2—86Green—2Aquamarine3—79Olive—3Black—0Navy—4Blue—12Purple1—5Blue1—21Teal—6Blue2—19Silver—7Blue3—20Grey—8BlueViolet—57Red—9CadetBlue—72Lime—10CadetBlue1—73Yellow—11Chartreuse1—118Blue—12Chartreuse2—112Fuchsia—13Chartreuse3—82Aqua—14Chartreuse4—70White—15Chartreuse5—76Grey0—16Chartreuse6—64NavyBlue—17CornflowerBlue—69DarkBlue—18Cornsilk1—230Blue2—19Cyan1—51Blue3—20Cyan2—50Blue1—21Cyan3—43DarkGreen—22DarkBlue—18DeepSkyBlue5—23DarkCyan—36DeepSkyBlue6—24DarkGoldenrod—136DeepSkyBlue7—25DarkGreen—22DodgerBlue3—26DarkKhaki—143DodgerBlue2—27DarkMagenta—90Green4—28DarkMagenta1—91SpringGreen6—29
and here's the rest of the list, because it was too long for one table:
DarkOliveGreen1—192Turquoise4—30DarkOliveGreen2—155DeepSkyBlue3—31DarkOliveGreen3—191DeepSkyBlue4—32DarkOliveGreen4—107DodgerBlue1—33DarkOliveGreen5—113Green2—34DarkOliveGreen6—149SpringGreen4—35DarkOrange—208DarkCyan—36DarkOrange2—130LightSeaGreen—37DarkOrange3—166DeepSkyBlue2—38DarkRed—52DeepSkyBlue1—39DarkRed2—88Green3—40DarkSeaGreen—108SpringGreen5—41DarkSeaGreen1—158SpringGreen2—42DarkSeaGreen2—193Cyan3—43
...okay so the list literally keeps going, no cap 🌀 here's the next chunk of the palette, each name with its byte value:
DarkSeaGreen3→151·DarkTurquoise→44DarkSeaGreen4→157·Turquoise2→45DarkSeaGreen5→115·Green1→46DarkSeaGreen6→150·SpringGreen3→47DarkSeaGreen7→65·SpringGreen1→48DarkSeaGreen8→71·MediumSpringGreen→49DarkSlateGray1→123·Cyan2→50DarkSlateGray2→87·Cyan1→51DarkSlateGray3→116·DarkRed→52DarkTurquoise→44·DeepPink8→53DarkViolet→128·Purple4→54DarkViolet1→92·Purple5→55DeepPink1→199·Purple3→56DeepPink2→197·BlueViolet→57DeepPink3→198·Orange3→58DeepPink4→125·Grey37→59
okay and then the table literally flips its whole vibe 🙃 the left half gets labelled name ↓ with a plain byte column, and the right half is a plain name with byte ↓ — so the two sides are sorted in opposite directions. same tea though, just mirrored. here we go:
DeepPink6→162·MediumPurple6→60DeepPink7→89·SlateBlue2→61DeepPink8→53·SlateBlue3→62DeepPink9→161·RoyalBlue1→63DeepSkyBlue1→39·Chartreuse6→64DeepSkyBlue2→38·DarkSeaGreen7→65DeepSkyBlue3→31·PaleTurquoise4→66DeepSkyBlue4→32·SteelBlue→67DeepSkyBlue5→23·SteelBlue3→68DeepSkyBlue6→24·CornflowerBlue→69DeepSkyBlue7→25·Chartreuse4→70DodgerBlue1→33·DarkSeaGreen8→71DodgerBlue2→27·CadetBlue→72DodgerBlue3→26·CadetBlue1→73Fuchsia→13·SkyBlue3→74Gold1→220·SteelBlue1→75Gold2→142·Chartreuse5→76Gold3→178·PaleGreen4→77Green→2·SeaGreen4→78Green1→46·Aquamarine3→79Green2→34·MediumTurquoise→80Green3→40·SteelBlue2→81Green4→28·Chartreuse3→82GreenYellow→154·SeaGreen3→83Grey→8·SeaGreen1→84Grey0→16·SeaGreen2→85Grey100→231·Aquamarine2→86Grey11→234·DarkSlateGray2→87
and bestie we are still not done, hold on to ur seats 🫶
…and the list just keeps going, bestie, no cap 💅 this next chunk is still the name ➜ byte pairs, laid out exactly like the table does it: left name next to its right-hand neighbour. Every single one, nothing skipped, because we don't do "etc." in this house 🫶
Grey15=235 · DarkRed2=88Grey19=236 · DeepPink7=89Grey23=237 · DarkMagenta=90Grey27=238 · DarkMagenta1=91Grey3=232 · DarkViolet1=92Grey30=239 · Purple2=93Grey35=240 · Orange4=94Grey37=59 · LightPink3=95Grey39=241 · Plum4=96Grey42=242 · MediumPurple4=97Grey46=243 · MediumPurple5=98Grey50=244 · SlateBlue1=99Grey53=102 · Yellow4=100Grey54=245 · Wheat4=101Grey58=246 · Grey53=102Grey62=247 · LightSlateGrey=103Grey63=139 · MediumPurple=104Grey66=248 · LightSlateBlue=105Grey69=145 · Yellow5=106Grey7=233 · DarkOliveGreen4=107Grey70=249 · DarkSeaGreen=108Grey74=250 · LightSkyBlue2=109Grey78=251 · LightSkyBlue3=110Grey82=252 · SkyBlue2=111Grey84=188 · Chartreuse2=112Grey85=253 · DarkOliveGreen5=113Grey89=254 · PaleGreen3=114Grey93=255 · DarkSeaGreen5=115Honeydew2=194 · DarkSlateGray3=116HotPink=205 · SkyBlue1=117HotPink1=206 · Chartreuse1=118HotPink2=169 · LightGreen=119
okay and it rolls straight into the next block of rows, same vibe, same rules 🌸
HotPink3=132 · LightGreen1=120HotPink4=168 · PaleGreen1=121IndianRed=131 · Aquamarine1=122IndianRed1=167 · DarkSlateGray1=123IndianRed2=204 · Red2=124IndianRed3=203 · DeepPink4=125Khaki1=228 · MediumVioletRed=126Khaki3=185 · Magenta4=127LightCoral=210 · DarkViolet=128LightCyan2=195 · Purple=129LightCyan3=152 · DarkOrange2=130LightGoldenrod1=227 · IndianRed=131LightGoldenrod2=222 · HotPink3=132LightGoldenrod3=179 · MediumOrchid3=133
heads up bestie 👀 some names pop up more than once in here —Grey53lands on102twice, and so doIndianRedat131andHotPink3at132. not a typo, not a glitch, that's just literally what the list says, so don't come for me 💀
and yeah, that's only part of it — there's still more list coming, so stay with me 🦋
…and bestie the list just keeps going, because of course it does 💅 here's the next chunk of names and their bytes, in the exact order they show up:
LightGoldenrod4—221MediumOrchid—134LightGoldenrod5—186MediumPurple2—135LightGreen—119DarkGoldenrod—136LightGreen1—120LightSalmon2—137LightPink1—217RosyBrown—138LightPink2—174Grey63—139LightPink3—95MediumPurple3—140LightSalmon1—216MediumPurple1—141LightSalmon2—137Gold2—142LightSalmon3—173DarkKhaki—143LightSeaGreen—37NavajoWhite3—144LightSkyBlue1—153Grey69—145LightSkyBlue2—109LightSteelBlue3—146LightSkyBlue3—110LightSteelBlue—147LightSlateBlue—105Yellow6—148LightSlateGrey—103DarkOliveGreen6—149
okay and now a whole fresh table starts up, same deal: name ↓ on one side, byte on the other, then another name with byte ↓. literally the same energy, new page 🦋
LightSteelBlue—147DarkSeaGreen6—150LightSteelBlue1—189DarkSeaGreen3—151LightSteelBlue3—146LightCyan3—152LightYellow3—187LightSkyBlue1—153Lime—10GreenYellow—154Magenta1—201DarkOliveGreen2—155Magenta2—165PaleGreen2—156Magenta3—200DarkSeaGreen4—157Magenta4—127DarkSeaGreen1—158Magenta5—163PaleTurquoise1—159Magenta6—164Red3—160Maroon—1DeepPink9—161MediumOrchid—134DeepPink6—162MediumOrchid1—171Magenta5—163MediumOrchid2—207Magenta6—164MediumOrchid3—133Magenta2—165MediumPurple—104DarkOrange3—166MediumPurple1—141IndianRed1—167MediumPurple2—135HotPink4—168MediumPurple3—140HotPink2—169MediumPurple4—97Orchid—170MediumPurple5—98MediumOrchid1—171MediumPurple6—60Orange2—172MediumSpringGreen—49LightSalmon3—173MediumTurquoise—80LightPink2—174MediumVioletRed—126Pink3—175MistyRose1—224Plum3—176
ngl bestie, yes some of these names show up more than once with the same byte — that's not a typo on my part, it's just how the table rolls 🙈 keep scrolling, there's more coming…
okay so the roster just keeps GOING and honestly? iconic 💅 this is still the same two-column situation — name on the left, byte on the right, twice across, and every single one of them matters. no skimming, bestie, we're collecting them all like Pokémon ✨
MistyRose3→181·Violet→177NavajoWhite1→223·Gold3→178NavajoWhite3→144·LightGoldenrod3→179
new block, same energy 🌸
Navy→4·Tan→180NavyBlue→17·MistyRose3→181Olive→3·Thistle3→182Orange1→214·Plum2→183Orange2→172·Yellow3→184Orange3→58·Khaki3→185Orange4→94·LightGoldenrod5→186OrangeRed1→202·LightYellow3→187Orchid→170·Grey84→188Orchid1→213·LightSteelBlue1→189Orchid2→212·Yellow2→190PaleGreen1→121·DarkOliveGreen3→191PaleGreen2→156·DarkOliveGreen1→192PaleGreen3→114·DarkSeaGreen2→193PaleGreen4→77·Honeydew2→194PaleTurquoise1→159·LightCyan2→195PaleTurquoise4→66·Red1→196PaleVioletRed1→211·DeepPink2→197Pink1→218·DeepPink3→198Pink3→175·DeepPink1→199Plum1→219·Magenta3→200Plum2→183·Magenta1→201Plum3→176·OrangeRed1→202Plum4→96·IndianRed3→203Purple→129·IndianRed2→204Purple1→5·HotPink→205Purple2→93·HotPink1→206Purple3→56·MediumOrchid2→207Purple4→54·DarkOrange→208Purple5→55·Salmon1→209
yes, a few names show up more than once across these tables. that's not me glitching, that's literally how it's written. eyes on the bytes, bestie 👀
and the last stretch of this block 🦋
Red→9·LightCoral→210Red1→196·PaleVioletRed1→211Red2→124·Orchid2→212Red3→160·Orchid1→213RosyBrown→138·Orange1→214RoyalBlue1→63·SandyBrown→215Salmon1→209·LightSalmon1→216SandyBrown→215·LightPink1→217SeaGreen1→84·Pink1→218SeaGreen2→85·Plum1→219SeaGreen3—83🌊 ·Gold1—220✨SeaGreen4—78🌊 ·LightGoldenrod4—221🌾Silver—7🪩 ·LightGoldenrod2—222🌾SkyBlue1—117☁️ ·NavajoWhite1—223🏜️SkyBlue2—111☁️ ·MistyRose1—224🌷SkyBlue3—74☁️ ·Thistle1—225💜SlateBlue1—99🟦 ·Yellow1—226💛SlateBlue2—61🟦 ·LightGoldenrod1—227🌾SlateBlue3—62🟦 ·Khaki1—228🧥SpringGreen1—48🌱 ·Wheat1—229🌾SpringGreen2—42🌱 ·Cornsilk1—230🌽SpringGreen3—47🌱 ·Grey100—231🩶SpringGreen4—35🌱 ·Grey3—232🩶SpringGreen5—41🌱 ·Grey7—233🩶SpringGreen6—29🌱 ·Grey11—234🩶SteelBlue—67🔩 ·Grey15—235🩶SteelBlue1—75🔩 ·Grey19—236🩶SteelBlue2—81🔩 ·Grey23—237🩶SteelBlue3—68🔩 ·Grey27—238🩶Tan—180🧸 ·Grey30—239🩶
okay and here's the next chunk of the list, same deal, name ↓ / byte / name / byte ↓:
Teal—6🫖 ·Grey35—240🩶Thistle1—225💜 ·Grey39—241🩶Thistle3—182💜 ·Grey42—242🩶Turquoise2—45🩵 ·Grey46—243🩶Turquoise4—30🩵 ·Grey50—244🩶Violet—177🟣 ·Grey54—245🩶Wheat1—229🌾 ·Grey58—246🩶Wheat4—101🌾 ·Grey62—247🩶White—15🤍 ·Grey66—248🩶Yellow—11💛 ·Grey70—249🩶Yellow1—226💛 ·Grey74—250🩶Yellow2—190💛 ·Grey78—251🩶Yellow3—184💛 ·Grey82—252🩶Yellow4—100💛 ·Grey85—253🩶Yellow5—106💛 ·Grey89—254🩶Yellow6—148💛 ·Grey93—255🩶
and that's the whole rainbow bestie, every single name accounted for, not one byte skipped 💅✨
🌸 SEE ALSO 🌸
📜 STANDARDS 📜
- TOML Standard v.0.5.0: https://toml.io/en/v0.5.0
- NO_COLOR: disabling ANSI color output by default: https://no-color.org/
👑 AUTHORS 👑
Copyright 2017–2024 Manos Pitsidianakis <manos@pitsidianak.is> 🫶
Released under the GPL, version 3 or greater. This software carries no warranty of any kind. (See COPYING for full copyright and warranty notices.)
no cap, zero warranty, they said it, not me 😭 read COPYING for the full receipts fr fr
🔗 Links
- Website: https://meli-email.org
- Main git repository and issue tracker: https://git.meli-email.org/meli/meli
- Official read-only git mirror on codeberg.org: https://codeberg.org/meli/meli
- Official read-only git mirror on github.com: https://github.com/meli/meli
- meli crate on crates.io: https://crates.io/crates/meli
and that's a wrap on the whole page bestie 🎀 this version dropped as part of the Debian build, dated March 10, 2024, and yes it's the MELI-THEMES(5) page you just read top to bottom like a champ. go make something gorgeous 💖✨
📦 where this page comes from
- alpine 3.24: meli-doc 0.8.13-r0 · GPL-3.0-or-later
- debian trixie: meli 0.8.11+dfsg-1+b1 · GPL-3.0-or-later
- nixos 26.05: meli 0.8.13
- nixpkgs unstable: meli 0.8.13
- opensuse-leap 16.0: meli 0.8.10-bp160.1.14 · GPL-3.0-or-later
- opensuse-leap 16.0: meli 0.8.10-bp160.1.14 · GPL-3.0-or-later
- opensuse-leap 16.0: meli 0.8.10-bp160.1.14 · GPL-3.0-or-later
- opensuse-leap 16.0: meli 0.8.10-bp160.1.14 · GPL-3.0-or-later
- ubuntu questing: meli 0.8.11+dfsg-1
- ubuntu resolute: meli 0.8.13+dfsg-3 · GPL-3.0-or-later
- ubuntu stonking: meli 0.8.13+dfsg-4build1 · GPL-3.0-or-later
- Copyright 2017-2020 Manos Pitsidianakis
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms