Skip to content

Fabiokleis/kanagawa-emacs

Repository files navigation

kanagawa-themes for Emacs

https://melpa.org/packages/kanagawa-themes-badge.svg https://img.shields.io/badge/License-GPLv3-blue.svg

Kanagawa for Emacs is a port of the elegant kanagawa.nvim, developed by Tommaso Laurenzi.

Kanagawa now has three variants: wave (default), dragon, and lotus.

Kanagawa for Emacs supports officially Emacs 24+.

Installation

Manual

Download kanagawa-emacs to the directory ~/.emacs.d/site-lisp/. Add this to your .emacs (or init.el):

(add-to-list 'load-path (concat user-emacs-directory "site-lisp"))
(require 'kanagawa-themes)

Now you can load the theme with the interactive function load-theme like this:

M-x load-theme RET kanagawa-wave (or kanagawa-dragon, kanagawa-lotus)

Package.el

Kanagawa is available in MELPA.

You can install kanagawa-themes with the following command:

M-x package-install kanagawa-themes

To load it automatically on Emacs startup add this to your init file:

(load-theme 'kanagawa-wave t)

Or use use-package macro:

(use-package kanagawa-themes
  :ensure t
  :config
  (load-theme 'kanagawa-wave t))

Customization

Custom colors

If you’d like to tweak the theme by changing just a few colors, you can do so by defining new values in the kanagawa-themes-custom-colors variable before loading the theme.

For example, to customize just the lighter background colors, you could add to your init file:

(setq kanagawa-themes-custom-colors '((bg "#0A0E14")))
(load-theme 'kanagawa-wave t)

Options

  • kanagawa-themes-comment-italic:

This toggles italics for comments and will also add a lighter color to it.

  • kanagawa-themes-keyword-italic:

This toggles italics for keywords.

  • kanagawa-themes-org-agenda-height:

This toggles the use of varying org agenda heights.

  • kanagawa-themes-org-bold:

This toggles bold text for org headings.

  • kanagawa-themes-org-height:

This toggles the use of varying org headings heights.

  • kanagawa-themes-org-highlight:

This toggles highlighting of org headings.

  • kanagawa-themes-org-priority-bold:

This toggles bold text for priority items in agenda view.

FAQ

Wrong colors in the terminal Emacs version

Enable true color, otherwise Kanagawa won’t support.