Skip to content

Deep blue and colorful emacs theme like a clear night sky πŸŒƒ

License

Notifications You must be signed in to change notification settings

SFTtech/starlit-emacs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

36 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Starlit Theme for Emacs

License GPL 3 MELPA MELPA Stable

What?

Starlit customizes your Emacs to be deep blue with bright colors from a starlit sky.

Screenshot

Installation

Doom Emacs

in packages.el: (package! starlit-theme)

in your config:

(setq doom-theme 'starlit)

Spacemacs

Spacemacs automatically uses and installs starlit when you add it to the theme list:

;; within your dotspacemacs/init function, set:
dotspacemacs-themes '(starlit
                      ...other themes)

Package.el

Starlit is available in MELPA and MELPA stable.

To install it:

M-x package-install starlit-theme

To load the theme on Emacs startup:

(load-theme 'starlit t)

Manual

Clone https://github.com/SFTtech/starlit-emacs for example to ~/.emacs.d/themes/starlit-emacs. This path then needs to be loaded within your emacs config:

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

Alternatively, use this snippet to discover all theme directories in ~/.emacs.d/themes/:

(let ((basedir (locate-user-emacs-file "themes/")))
  (when (file-directory-p basedir)
    (dolist (f (directory-files basedir))
      (if (and (not (or (equal f ".") (equal f "..")))
               (file-directory-p (concat basedir f)))
          (add-to-list 'custom-theme-load-path (concat basedir f))))))

To load the theme, call load-theme interactively:

M-x load-theme RET starlit

Customization

Custom colors

You can change theme base colors by overriding values by customizing starlit-custom-colors. The base colors are defined in starlit-default-colors in starlit-theme.el.

Of course you can customize any other color too, or create a derived theme :)

Example to override theme base colors in your config instead of customize:

(setq starlit-custom-colors
      '(("current-line" . "#101114")
        ("background"   . "#091422")))
(load-theme 'starlit t)

Header scaling

You can toggle if headings have a larger font size than normal text. To configure this, customize starlit-scale-headlines. This change has to be applied before loading the theme.

To disable the header scaling outside of customize:

;; disable headline scaling
(setq starlit-scale-headlines nil)

FAQ

Does it work with terminal Emacs?

Yes it should look okay if your terminal supports at least 256 colors, although 32-bit color mode is needed to display all colors like intended.

The theme was tested successfully using the kitty terminal emulator.

Something looks ugly

Since not all emacs modes could be tested and customized, some faces may still look ugly. Please report or fix them.

Contributors

Everyone who contributed is likely listed here.

Contact

If you have questions, suggestions, encounter any problem, please join our Matrix channel and ask!

#sfttech:matrix.org

In case you didn't know anyway, you can report issues or - even better - submit pull requests.

License

This theme is distributed under the GNU General Public License, version 3 or later. See the LICENSE and authors list.

About

Deep blue and colorful emacs theme like a clear night sky πŸŒƒ

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published