File: modus-themes.el.html
The Modus themes conform with the highest standard for color-contrast accessibility between background and foreground values (WCAG AAA). This file contains all customization variables, helper functions, interactive commands, and face specifications. Please refer to the official Info manual for further documentation (distributed with the themes, or available at: <https://protesilaos.com/modus-themes>).
The themes share the following customization variables:
modus-themes-headings (alist)
modus-themes-org-agenda (alist)
modus-themes-bold-constructs (boolean)
modus-themes-inhibit-reload (boolean)
modus-themes-italic-constructs (boolean)
modus-themes-no-mixed-fonts (boolean)
modus-themes-scale-headings (boolean)
modus-themes-subtle-line-numbers (boolean)
modus-themes-success-deuteranopia (boolean)
modus-themes-variable-pitch-headings (boolean)
modus-themes-variable-pitch-ui (boolean)
modus-themes-completions (choice)
modus-themes-diffs (choice)
modus-themes-fringes (choice)
modus-themes-hl-line (choice)
modus-themes-lang-checkers (choice)
modus-themes-links (choice)
modus-themes-mail-citations (choice)
modus-themes-mode-line (choice)
modus-themes-org-blocks (choice)
modus-themes-paren-match (choice)
modus-themes-prompts (choice)
modus-themes-region (choice)
modus-themes-syntax (choice)
The default scale for headings is as follows (it can be customized as well---remember, no scaling takes place by default):
modus-themes-scale-1 1.05
modus-themes-scale-2 1.1
modus-themes-scale-3 1.15
modus-themes-scale-4 1.2
modus-themes-scale-title 1.3
There is another scaling-related option, which however is reserved for special cases and is not used for headings:
modus-themes-scale-small 0.9
There also exist two unique customization variables for overriding color palette values. The specifics are documented in the manual. The symbols are:
modus-themes-operandi-color-overrides (alist)
modus-themes-vivendi-color-overrides (alist)
Below is the list of explicitly supported packages or face groups
(there are implicitly supported packages as well, which inherit from
font-lock or some basic group). You are encouraged to report any
missing package or change you would like to see.
ace-window
ag
alert
all-the-icons
annotate
ansi-color
anzu
apropos
apt-sources-list
artbollocks-mode
auctex and TeX
auto-dim-other-buffers
avy
awesome-tray
bbdb
binder
bm
bongo
boon
bookmark
breakpoint (provided by built-in gdb-mi.el)
buffer-expose
calendar and diary
calfw
centaur-tabs
cfrs
change-log and log-view (vc-print-log and vc-print-root-log)
cider
circe
color-rg
column-enforce-mode
company-mode
company-posframe
compilation-mode
completions
consult
corfu
counsel
counsel-css
counsel-org-capture-string
cov
cperl-mode
css-mode
csv-mode
ctrlf
cursor-flash
custom (M-x customize)
dap-mode
dashboard (emacs-dashboard)
deadgrep
debbugs
define-word
deft
dictionary
diff-hl
diff-mode
dim-autoload
dir-treeview
dired
dired-async
dired-git
dired-git-info
dired-narrow
dired-subtree
diredc
diredfl
diredp (dired+)
disk-usage
display-fill-column-indicator-mode
doom-modeline
dynamic-ruler
easy-jekyll
easy-kill
ebdb
ediff
eglot
el-search
eldoc
eldoc-box
elfeed
elfeed-score
elpher
embark
emms
enh-ruby-mode (enhanced-ruby-mode)
epa
equake
erc
eros
ert
eshell
eshell-fringe-status
eshell-git-prompt
eshell-prompt-extras (epe)
eshell-syntax-highlighting
evil (evil-mode)
evil-goggles
evil-snipe
evil-visual-mark-mode
eww
exwm
eyebrowse
fancy-dabbrev
flycheck
flycheck-color-mode-line
flycheck-indicator
flycheck-posframe
flymake
flyspell
flyspell-correct
flx
freeze-it
frog-menu
focus
fold-this
font-lock (generic syntax highlighting)
forge
fountain (fountain-mode)
geiser
git-commit
git-gutter (and variants)
git-lens
git-rebase
git-timemachine
git-walktree
gnus
gotest
golden-ratio-scroll-screen
helm
helm-ls-git
helm-switch-shell
helm-xref
helpful
highlight-blocks
highlight-defined
highlight-escape-sequences (hes-mode)
highlight-indentation
highlight-numbers
highlight-symbol
highlight-tail
highlight-thing
hl-defined
hl-fill-column
hl-line-mode
hl-todo
hydra
hyperlist
ibuffer
icomplete
ido-mode
iedit
iflipb
imenu-list
indium
info
info-colors
interaction-log
ioccur
isearch, occur, etc.
isl (isearch-light)
ivy
ivy-posframe
jira (org-jira)
journalctl-mode
js2-mode
julia
jupyter
kaocha-runner
keycast
ledger-mode
line numbers (display-line-numbers-mode(var)/display-line-numbers-mode(fun) and global variant)
lsp-mode
lsp-ui
macrostep
magit
magit-imerge
make-mode
man
marginalia
markdown-mode
markup-faces (adoc-mode)
mentor
messages
minibuffer-line
minimap
mmm-mode
mode-line
mood-line
mpdel
mu4e
mu4e-conversation
multiple-cursors
neotree
no-emoji
notmuch
num3-mode
nxml-mode
objed
orderless
org
org-journal
org-noter
org-pomodoro
org-recur
org-roam
org-superstar
org-table-sticky-header
org-tree-slide
org-treescope
origami
outline-mode
outline-minor-faces
package (M-x list-packages)
page-break-lines
pandoc-mode
paradox
paren-face
parrot
pass
pdf-tools
persp-mode
perspective
phi-grep
phi-search
pkgbuild-mode
pomidor
popup
powerline
powerline-evil
prism (see "Note for prism.el" in the manual)
proced
prodigy
pulse
quick-peek
racket-mode
rainbow-blocks
rainbow-identifiers
rainbow-delimiters
rcirc
recursion-indicator
regexp-builder (also known as re-builder)
rg
ripgrep
rmail
ruler-mode
sallet
selectrum
selectrum-prescient
semantic
sesman
shell-script-mode
shortdoc
show-paren-mode
shr
side-notes
sieve-mode
skewer-mode
smart-mode-line
smartparens
smerge
spaceline
speedbar
spell-fu
spray
stripes
suggest
switch-window
swiper
swoop
sx
symbol-overlay
syslog-mode
tab-bar-groups
tab-bar-mode
tab-line-mode
table (built-in table.el)
telega
telephone-line
terraform-mode
term
tomatinho
transient (pop-up windows like Magit's)
trashed
treemacs
tty-menu
tuareg
typescript
undo-tree
vc (vc-dir.el, vc-hooks.el)
vc-annotate (C-x v g)
vdiff
vertico
vimish-fold
visible-mark
visual-regexp
volatile-highlights
vterm
wcheck-mode
web-mode
wgrep
which-function-mode
which-key
whitespace-mode
window-divider-mode
winum
writegood-mode
woman
xah-elisp-mode
xref
xterm-color (and ansi-colors)
yaml-mode
yasnippet
ztree
For a complete view of the project, also refer to the following files
(should be distributed in the same repository/directory as the
current item):
- modus-operandi-theme.el (Light theme)
- modus-vivendi-theme.el (Dark theme)
Defined variables (0)
Defined functions (0)
Defined faces (83)
modus-themes-active-blue | A blue background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-active-cyan | A cyan background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-active-green | A green background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-active-magenta | A magenta background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-active-red | A red background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-active-yellow | A yellow background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-bold | Generic face for applying a conditional bold weight. This behaves in accordance with `modus-themes-bold-constructs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-added | Combines green colors for the 'added' state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-changed | Combines yellow colors for the 'changed' state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-focus-added | Combines green colors for the focused 'added' state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-focus-changed | Combines yellow colors for the focused 'changed' state in. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-focus-removed | Combines red colors for the focused 'removed' state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-heading | Combines blue colors for the diff hunk heading. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-refine-added | Combines green colors for word-wise 'added' state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-refine-changed | Combines yellow colors for word-wise 'changed' state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-refine-removed | Combines red colors for word-wise 'removed' state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-removed | Combines red colors for the 'removed' state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fixed-pitch | Generic face for applying a conditional `fixed-pitch'. This behaves in accordance with `modus-themes-no-mixed-fonts'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-blue | A blue background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-cyan | A cyan background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-green | A green background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-magenta | A magenta background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-red | A red background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-yellow | A yellow background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-blue-0 | Special subdued blue face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-blue-1 | Special prominent blue face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-cyan-0 | Special subdued cyan face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-cyan-1 | Special prominent cyan face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-green-0 | Special subdued green face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-green-1 | Special prominent green face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-magenta-0 | Special subdued magenta face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-magenta-1 | Special prominent magenta face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-red-0 | Special subdued red face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-red-1 | Special prominent red face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-yellow-0 | Special subdued yellow face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-graph-yellow-1 | Special prominent yellow face for use in graphs. This is intended to be applied in contexts such as the Org agenda habit graph where faithfulness to the semantics of a color value is of paramount importance. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-hl-line | General purpose face for the current line. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-hl-line' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-blue | Intense blue background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-cyan | Intense cyan background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-green | Intense green background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-magenta | Intense magenta background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-neutral | Intense gray background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-red | Intense red background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-yellow | Intense yellow background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-key-binding | Generic face for key bindings. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-lang-error | Generic face for linter or spell checker errors. The exact attributes and color combinations are controlled by `modus-themes-lang-checkers'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-lang-note | Generic face for linter or spell checker notes. The exact attributes and color combinations are controlled by `modus-themes-lang-checkers'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-lang-warning | Generic face for linter or spell checker warnings. The exact attributes and color combinations are controlled by `modus-themes-lang-checkers'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-mark-alt | Combines yellow colors for marking special lines. This is intended for use in modes such as Dired, Ibuffer, Proced. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-mark-del | Combines red colors for marking deletable lines. This is intended for use in modes such as Dired, Ibuffer, Proced. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-mark-sel | Combines green colors for marking lines. This is intended for use in modes such as Dired, Ibuffer, Proced. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-mark-symbol | Applies a blue color and other styles for mark indicators. This is intended for use in modes such as Dired, Ibuffer, Proced. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-blue | A nuanced blue background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-cyan | A nuanced cyan background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-green | A nuanced green background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-magenta | A nuanced magenta background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-red | A nuanced red background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-yellow | A nuanced yellow background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-prompt | Generic face for command prompts. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-pseudo-header | Generic style for some elements that function like headings. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-blue | Combination of accented blue background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-cyan | Combination of accented cyan background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-green | Combination of accented green background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-magenta | Combination of accented magenta background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-red | Combination of accented red background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-yellow | Combination of accented yellow background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-reset-soft | Generic face to set most face properties to nil. This is intended to be inherited by faces that should not retain properties from their context (e.g. an overlay over an underlined text should not be underlined as well) yet still blend in. Also see `modus-themes-reset-hard'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-search-success | Generic face for successful search. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-search-success-lazy | Generic face for successful, lazily highlighted search. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-search-success-modeline | Generic mode line indicator for successful search. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-slant | Generic face for applying a conditional slant (italics). This behaves in accordance with `modus-themes-italic-constructs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-special-calm | Combines the 'special calm' background and foreground values. This is intended for cases when a neutral gray background is not suitable and where a combination of more saturated colors would not be appropriate. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-special-cold | Combines the 'special cold' background and foreground values. This is intended for cases when a neutral gray background is not suitable and where a combination of more saturated colors would not be appropriate. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-special-mild | Combines the 'special mild' background and foreground values. This is intended for cases when a neutral gray background is not suitable and where a combination of more saturated colors would not be appropriate. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-special-warm | Combines the 'special warm' background and foreground values. This is intended for cases when a neutral gray background is not suitable and where a combination of more saturated colors would not be appropriate. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-blue | Subtle blue background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-cyan | Subtle cyan background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-green | Subtle green background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-magenta | Subtle magenta background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-neutral | Subtle gray background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-red | Subtle red background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-yellow | Subtle yellow background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-variable-pitch | Generic face for applying a conditional `variable-pitch'. This behaves in accordance with `modus-themes-no-mixed-fonts', `modus-themes-variable-pitch-headings' for all heading levels, and `modus-themes-variable-pitch-ui'. The actual styling of the face is done by `modus-themes-faces'. |