Centaur Emacs

Build
Status License

Centaur Emacs

This is an Emacs distribution that aims to enhance the default Emacs experience. It alters a lot of the default settings, bundles a plethora of additional packages and adds its own core library to the mix. The final product offers an easy to use Emacs configuration for Emacs newcomers and lots of additional power for Emacs power users.

It’s able to run on Windows, GNU Linux and macOS. It is compatible ONLY with GNU Emacs 24.4 and above. In general you’re advised to always run with the latest stable release - currently 25.3.

Features

Prerequiste

OS

GNU Emacs

Please refer to Installing Emacs.

Optional

Recommend to use Centaur Dotfiles or oh-my-zsh.

Quick Start

Installation

Backup your .emacs.d if it exists,

mv ~/.emacs.d ~/.emacs.d.bak

then

git clone https://github.com/seagle0128/.emacs.d.git ~/.emacs.d

or download the zip
package directly and extract to ~./emacs.d.

Then start emacs. Wait for a while to install packages at the first startup. Enjoy!

Update

Run M-x update-config in Emacs, or

cd ~/.emacs.d && git pull

Customization

Copy custom-example.el to custom.el and change the configurations, then restart Emacs.

(setq my-logo nil)                        ; Logo file or nil (official logo)
(setq my-full-name "user name")           ; User full name
(setq my-mail-address "user@email.com")   ; Email address
(setq my-proxy "127.0.0.1:1080")          ; Network proxy
(setq my-package-archives 'emacs-china)   ; Package repo: melpa, emacs-china or tuna
(setq my-theme 'dark)                     ; Color theme: default, dark, light or daylight
(setq my-emoji-enabled t)                 ; Enable emoji: t or nil
(setq my-benchmark-enabled t)             ; Enable initialization benchmark: t or nil

Screenshots

Main (default theme)

Main

Programming (dark theme)

Programming

Org mode (dark theme)

Org

Search (light theme)

Search

Magit (daylight theme)

Magit