Skip to content

hristoast/dot-emacs

Repository files navigation

/home/hristos/.emacs.d/

About

My Emacs configuration. Requires Emacs 29.1 or newer. It sports my fork of the Material Theme for Emacs and Smart Mode Line with the Dark theme. I recommend running this configuration in daemon mode - it's great for GUI Emacs or terminal Emacs.

It sets up Emacs with support for a wide variety of languages, as well as other more opinionated things like: color themes, many aspects of Emacs internals, code completion, and much much more.

Screenshots

Check out the screenshots page on the wiki.

Installation

Copy all .el files as well as the lib and straight directories from the root of this repository into your ~/.emacs.d, start Emacs. It may be wise to mv your current ~/.emacs.d out of the way and start fresh.

Two install methods are demonstrated below:

# Put it right in place:
mv -v ~/.emacs.d ~/$(date +%F)-emacs.d
git clone https://git.sr.ht/~hristoast/dot-emacs ~/.emacs.d

# Make symlinks
mv -v ~/.emacs.d ~/$(date +%F)-emacs.d
mkdir ~/.emacs.d
git clone https://git.sr.ht/~hristoast/dot-emacs ~/src/hristoast-dot-emacs
ln -sv ~/src/hristoast-dot-emacs/{init.el,lib,straight} ~/.emacs.d/

If you're an Emacs daemon user, your first run should not be in daemon mode so that you can accept the theme (if you choose to use that). After completing the first successful startup, where all packages and etc are installed, you may start the daemon.

After the first run is completed, before closing Emacs be sure to run M-x all-the-icons-install-fonts RET so that you get your fonts installed (unless you're not using that).

Configuring

Large portions of the overall configuration are toggle-able. See the config page on the wiki for more information.

Issues/Notes

  • When installing, this configuration should not be ran in daemon mode for the first run (you will need to trust themes that are loaded).
  • Some of my keybindings might not work well with terminal Emacs. If that's an issue, don't load them (see the config wiki page).
  • You can view the startup time in the *Messages* buffer, look for a line starting with [STARTUP] Loading ..., or in the dashboard (unless you disable that).