Skip to content

Latest commit

 

History

History
100 lines (80 loc) · 3.68 KB

README.md

File metadata and controls

100 lines (80 loc) · 3.68 KB
Raw

license MELPA

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

Seoul256-Emacs-Dark

Light

Seoul256-Emacs-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

M-x package-install RET seoul256-theme

Then, just load the theme with M-x 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 M-x load-theme RET 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 M-x 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., F1 for darken and F2 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)