Zenburn for Emacs is a direct port of the popular Zenburn theme for vim, developed by Jani Nurminen. It's my personal belief (and that of its many users I presume) that it's one of the best low contrast color themes out there and that it is exceptionally easy on the eyes.
This theme uses the "new"1 built-in theming support available starting with Emacs 24.1.
You can support the development of Zenburn for Emacs via GitHub Sponsors, ko-fi, PayPal and Patreon.
Download zenburn-theme.el to the directory ~/.emacs.d/themes/. Add this to your .emacs (or init.el):
(add-to-list 'custom-theme-load-path "~/.emacs.d/themes/")
Now you can load the theme with the interactive function load-theme like this:
M-x load-theme RET zenburn
Zenburn is available in NonGNU ELPA, MELPA Stable and MELPA.
You can install zenburn with the following command:
M-x package-install zenburn-theme
To load it automatically on Emacs startup add this to your init file:
If you prefer to use use-package just add the following:
(use-package zenburn-theme :config (load-theme 'zenburn t))
Zenburn for Emacs is already bundled into Emacs Prelude. If you're a Prelude user - you're probably already using Zenburn, since it's Prelude's default color theme. You can load Zenburn at any time by M-x load-theme zenburn.
Users of Debian 9 or later or Ubuntu 16.10 or later may simply apt-get install elpa-zenburn-theme.
If want to change some faces you can do it with custom-theme-set-faces or use-package. Here's an example:
(use-package zenburn-theme
:preface
(setq my/zenburn-colors-alist
'((fg . "#DCDCCC") (bg . "#1C1C1C") (cyan . "#93E0E3")))
:custom-face
(region ((t (:background ,(alist-get my/zenburn-colors-alist 'cyan)))))
:config
(load-theme 'zenburn t))
See this article for more details.
If you'd like to tweak the theme by changing just a few colors, you can do so by defining new values in the zenburn-override-colors-alist variable before loading the theme.
For example, to customize just the lighter background colors, you could add to your init file:
(setq zenburn-override-colors-alist
'(("zenburn-bg+05" . "#282828")
("zenburn-bg+1" . "#2F2F2F")
("zenburn-bg+2" . "#3F3F3F")
("zenburn-bg+3" . "#4F4F4F")))
(load-theme 'zenburn t)
To see the full list of color names you can override, consult the zenburn-theme.el source file.
The theme supports scaling the font size for some headings and titles as well as using a variable-pitch font for those. To enable this, use the following settings before loading zenburn-theme:
;; use variable-pitch fonts for some headings and titles (setq zenburn-use-variable-pitch t) ;; scale headings in org-mode (setq zenburn-scale-org-headlines t) ;; scale headings in outline-mode (setq zenburn-scale-outline-headlines t)
The screenshot above shows the default setting with no scaled or variable-pitch fonts. With scaled headings and variable-pitch fonts it looks like this:
Wrong colors in the terminal Emacs versionIf your Emacs looks considerably uglier in a terminal (compared to the GUI version) try adding this to your .bashrc or .zshrc:
export TERM=xterm-256color
Source the .bashrc (or .zshrc) file and start Emacs again.
Please, report any problems that you find on the project's integrated issue tracker. If you've added some improvements and you want them included upstream don't hesitate to send me a patch or even better - a GitHub pull request. These contributors have done so.
You can support my work on Zenburn and all my other OSS projects via the following platforms:
Here's a list of all the people who have contributed to the development of Zenburn for Emacs.
A fairly extensive changelog is available here.
Copyright © 2010-2024 Bozhidar Batsov and contributors.
Distributed under the GNU General Public License, version 3
It used to be new in 2010 when I created this package. ↩
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4
