Home

Awesome

Made with Doom Emacs Release tag MELPA Build status

Solaire mode

If only certain buffers could be so grossly incandescent.

<a href="https://winkla12.deviantart.com/art/Grossly-Incandescent-438305072"> <img src="/../screenshots/praise.jpg" width="100%" /> </a>

solaire-mode is an aesthetic plugin designed to visually distinguish "real" buffers (i.e. file-visiting code buffers where you do most of your work) from "unreal" buffers (like popups, sidebars, log buffers, terminals, etc) by giving the latter a slightly different -- often darker -- background:

solaire-mode at work

This plugin accomplishes this by doing two things when activated:

Praise the sun.

Note:

Install

Solaire-mode is available on MELPA: M-x package-install RET solaire-mode

Doom Emacs

Doom installs this package as part of the :ui doom module. No additional configuration is needed.

Configuration

Simply activate solaire-global-mode:

(solaire-global-mode +1)

Settings

Jolly cooperation with other plugins

Theme support for solaire-mode

solaire-mode will disable itself if the active theme doesn't support it, but to ensure support a theme must at least change solaire-default-face's :background. My recommendation is that it is be slightly darker or lighter than default's background.

For example doom-one (seen in the screenshot above) prefers solaire-default-face be darker than default:

doom-one screenshot

Others, like doom-vibrant prefer the opposite:

doom-vibrant screenshot

For full support, themes can customize the following faces:

FaceRemapped face
solaire-default-facedefault
solaire-fringe-facefringe
solaire-line-number-faceline-number
solaire-hl-line-facehl-line
solaire-org-hide-faceorg-hide, org-indent
solaire-mode-line-facemode-line
solaire-mode-line-inactive-facemode-line-inactive
solaire-header-line-faceheader-line

Themes that support solaire-mode out of the box

The only (known) themes to support solaire-mode are:

If you know of more, feel free to PR them.