You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Yann Esposito (Yogsototh) f30aaed84c
minimize nord-light contrast
4 months ago
.github Add "link and list plugins" to PR template 7 months ago
test Remove -palette indirection 1 year ago
themes minimize nord-light contrast 4 months ago
.gitignore Add .gitignore 4 years ago
.travis.yml Remove 24.x tests & add 25.3/26.x tests 2 years ago
Cask v2.0.8 bump 3 years ago
LICENSE Update copyright 1 year ago
Makefile Forcefully load the test-helper file before tests 1 year ago
README.md Add: Documentation for Doom Ayu themes. 5 months ago
doom-themes-base.el Add keycast.el faces 4 months ago
doom-themes-ext-neotree.el Remove obsolete line 6 months ago
doom-themes-ext-org.el Refactor doom-themes-ext-org 5 months ago
doom-themes-ext-treemacs.el ext-treemacs: support more file extensions for icons 5 months ago
doom-themes-ext-visual-bell.el Partially fix doom-visual-bell face #339 1 year ago
doom-themes.el Add: Documentation for Doom Ayu themes. 5 months ago

README.md

Release tag MELPA Build Status MIT

doom-themes

DOOM Themes is an opinionated UI plugin and pack of themes extracted from my emacs.d, inspired by some of my favorite color themes.

See the screenshots.

Table of Contents

Theme list

Themes in testing

A list of themes which are usable, yet may need some minor adjustments.

  • [X] doom-homage-white: a minimalistic, colorless theme, inspired by eziam, tao and jbeans themes. (thanks to mskorzhinskiy)
  • [X] doom-homage-black: dark variant of doom-homage white. (thanks to mskorzhinskiy)
  • doom-plain-dark: based on plain (thanks to das-s)

Features

  • (doom-themes-visual-bell-config): flash the mode-line when the Emacs bell rings (i.e. an error occurs).
  • (doom-themes-neotree-config): a neotree theme that takes after Atom’s file drawer, and is simpler than the built in icon theme in neotree (screenshot, more details).

This requires all-the-icons’ fonts to be installed: M-x all-the-icons-install-fonts

  • (doom-themes-treemacs-config): two treemacs icon themes, one that takes after Atom’s, and a second more colorful implementation (WIP).
  • (doom-themes-org-config): corrects and improves some of org-mode’s native fontification.
    • Re-set org-todo' &org-headline-done’ faces to make them respect underlying faces (i.e. don’t override the :height or :background of underlying faces).
    • Make statistic cookies respect underlying faces.
    • Fontify item bullets (make them stand out)
    • Fontify item checkboxes (and when they’re marked done), like TODOs that are marked done.
    • Fontify dividers/separators (5+ dashes)
    • Fontify #hashtags and @at-tags, for personal convenience; see doom-org-special-tags to disable this.
  • Resources that may interest you:

Themes customization

There are several themes which have their own customization options. For example, doom-dark+ default modeline color can be changed with the doom-dark+-blue-modeline custom variable, or you can switch between doom-gruvbox-light variants with the doom-gruvbox-light-variant custom variable.

Install

Doom Emacs

The built-in :ui doom module installs doom-themes for you, and loads doom-one by default. You can change the theme by changing the doom-theme variable from ~/.doom.d/config.el:

(setq doom-theme 'doom-city-lights)

Or by loading it manually:

(load-theme 'doom-city-lights t)

Manually

doom-themes is available on MELPA.

  • Straight users can install it with M-x straight-use-package RET doom-themes
  • And package.el users: M-x package-install RET doom-themes

Here is a example configuration for doom-theme:

(use-package doom-themes
  :config
  ;; Global settings (defaults)
  (setq doom-themes-enable-bold t    ; if nil, bold is universally disabled
        doom-themes-enable-italic t) ; if nil, italics is universally disabled
  (load-theme 'doom-one t)

  ;; Enable flashing mode-line on errors
  (doom-themes-visual-bell-config)
  
  ;; Enable custom neotree theme (all-the-icons must be installed!)
  (doom-themes-neotree-config)
  ;; or for treemacs users
  (setq doom-themes-treemacs-theme "doom-colors") ; use the colorful treemacs theme
  (doom-themes-treemacs-config)
  
  ;; Corrects (and improves) org-mode's native fontification.
  (doom-themes-org-config))

The wiki contains details for customizing the neotree theme.

Common Issues

Fix this by setting :height explicitly for your line number plugins, after you’ve loaded the theme. e.g.

  (let ((height (face-attribute 'default :height)))
    ;; for all linum/nlinum users
    (set-face-attribute 'linum nil :height height)
    ;; only for `linum-relative' users:
    (set-face-attribute 'linum-relative-current-face nil :height height)
    ;; only for `nlinum-relative' users:
    (set-face-attribute 'nlinum-relative-current-face nil :height height))

Contribute

I welcome contributions of any kind, be they pull requests, bug reports or elisp pointers. Additional theme and plugin support requests are welcome too.