/monokai-emacs

Primary LanguageEmacs Lisp

MELPA MELPA Stable

About

Monokai for Emacs is a port of the popular TextMate theme Monokai by Wimer Hazenberg. The inspiration for the theme came from Bozhidar Batsov and his Zenburn port and Sublime Text 2 which defaults to this color scheme.

I like the colors and I like Emacs. This followed.

The theme uses built-in theming support available Emacs 24 and later.

I recommend using Prelude in conjunction with this theme. Bozhidar Batsov has done some awesome work in making Emacs beautiful and accessible to a newcomer.

I've been using the theme with spacemacs and have really enjoyed it.

How it looks

first image second image

Installation

Manual

Download monokai-theme.el to the directory ~/.emacs.d/themes/. Add this to your .emacs:

(add-to-list 'custom-theme-load-path "~/.emacs.d/themes/")

Now you can load the theme with: M-x load-theme RET monokai

With package.el

Monokai is available in both Marmalade and MELPA. Keep in mind the fact the version in the Marmalade repo may not always be up-to-date.

You can install monokai with: M-x package-install monokai-theme

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

(load-theme 'monokai t)

With spacemacs

Add the theme to dotspacemacs-themes in your .spacemacs file:

(defun dotspacemacs/init ()
  (setq-default
    dotspacemacs-themes '(monokai)))

Customization

Please see full list of variables in the defcustom section.

You can override specific core colors using this in your init.el or equivalent file:

(setq ;; foreground and background
      monokai-foreground     "#ABB2BF"
      monokai-background     "#282C34"
      ;; highlights and comments
      monokai-comments       "#F8F8F0"
      monokai-emphasis       "#282C34"
      monokai-highlight      "#FFB269"
      monokai-highlight-alt  "#66D9EF"
      monokai-highlight-line "#1B1D1E"
      monokai-line-number    "#F8F8F0"
      ;; colours
      monokai-blue           "#61AFEF"
      monokai-cyan           "#56B6C2"
      monokai-green          "#98C379"
      monokai-gray           "#3E4451"
      monokai-violet         "#C678DD"
      monokai-red            "#E06C75"
      monokai-orange         "#D19A66"
      monokai-yellow         "#E5C07B")

org-mode headers

If you would like to change the font size of your org-mode headers you can do so with:

(setq monokai-height-minus-1 0.8
      monokai-height-plus-1 1.1
      monokai-height-plus-2 1.15
      monokai-height-plus-3 1.2
      monokai-height-plus-4 1.3)

Variable pitch

If you would like to use variable-pitch-mode you can enable it with:

(setq monokai-user-variable-pitch t)

This used to be enabled by default but broke the principle of least surprise which resulted in a couple of issues. See #62 & #56

Windows

If your're experiencing font issues using org-mode on Windows with emacs 25 try add this to your init.el or equivalent file:

(add-hook 'after-init-hook '(lambda () (load-theme 'monokai t)))

(when (and sys/win32p (> emacs-major-version 24))
  (add-hook 'window-setup-hook '(lambda () (load-theme 'monokai t))))

For more info check the thread in #56

Bugs & Improvements

Please, report any problems that you find on the projects integrated issue tracker. If you've added some improvements and you want them included upstream please send a pull request.

Thank you, Kelvin