Awesome
Seoul256 for Emacs
Seoul256 for Emacs is an Emacs theme port of seoul256 color scheme for vim by Junegunn Choi. This is a work in progress.
Screenshots
Dark
Light
Installation & Usage
There are two ways of installing the seoul256 theme.
MELPA
The recommended way to install the soul256 theme is through MELPA. Assuming you have set up MELPA, you can install this theme by simply doing
<kbd>M-x</kbd> package-install
<kbd>RET</kbd> seoul256-theme
Then, just load the theme with <kbd>M-x</kbd> load-theme
.
Manual
Download and save the following file into your custom theme directory (e.g.,
~/.emacs.d/themes
):
Make sure Emacs knows about your custom theme directory. You may do this by adding something like the following in your init file:
(add-to-list 'custom-theme-load-path "~/.emacs.d/themes")
Now you can load the theme using <kbd>M-x</kbd> load-theme
<kbd>RET</kbd>
seoul256
.
Customization
Color Variants
Like the original, this port offers different background colors. To change the
background, use the variable seoul256-background
before loading the theme,
e.g.,
;;; dark variants
;; Range: 233 (darkest) ~ 239 (lightest)
;; Default: 237
(setq seoul256-background 235)
(load-theme 'seoul256 t)
;;; light variants
;; Range: 252 (darkest) ~ 256 (lightest)
;; Default: 253
(setq seoul256-background 255)
(load-theme 'seoul256 t)
The variant of the theme (dark or light) is determined by this variable. Dark variants range from 233 to 239 and light variants range from 252 to 256. By default, the theme uses a dark variant.
Background-switching
Sometimes, it is beneficial to be able to switch between two variants of the
theme using a key binding. For this purpose, this theme offers an interactive
function seoul256-switch-background
that switches between
seoul256-background
(default 237, dark unless set by the user) and
seoul256-alternate-background
(default 253, light unless set by the user), but
you could set them to anything of your choice. For example, perhaps you don't
like light variants, but want to switch between the darkest and lightest
contrasts of the dark theme. You could do the following:
(setq seoul256-background 233
seoul256-alternate-background 239)
(load-theme 'seoul256 t)
Then switch using <kbd>M-x</kbd> seoul256-switch-background
. For easier
switching, bind this function to a key.
Changing background darkness/brightness
This theme also comes with two helper functions, seoul256-darken-background
and seoul256-brighten-background
that lets you change the contrast of the
background. Internally, these functions change seoul256-background
to the next
(or previous) in the range within the limits allowed by the theme. You could
bind these functions to keys of your choice (e.g., <kbd>F1</kbd> for
darken and <kbd>F2</kbd> for brighten).
Overriding Default Colors
If you don't like the default colors, you can override them by defining new
colors in seoul256-override-colors-alist
variable before loading the theme:
;; Change comments to grey from green.
(setq seoul256-override-colors-alist
'((65 . "#a6a6a6")))
(load-theme 'seoul256 t)