This is an Emacs configuration for a stubborn, melodramatic and shell-dwelling vimmer disappointed with the text-editor status quo.
Doom tries to look and act like modern editors (whatever that will mean to me on any given day), emulates vim as best it can and strives to surpass it in any way possible. All to fit my needs as a software developer, indie game developer, UX designer, scientist and doom enthusiast.
It was tailored for GUI Emacs 25+ on OSX 10.11+ and Arch Linux 4.7+. I use vim everywhere else.
NOTE: you can find the theme in a separate repo.
Depends on Cask and make:
git clone https://github.com/hlissner/.emacs.d ~/.emacs.d cd ~/.emacs.d make # installs plugins via cask and generates autoloads # OPTIONAL make compile # compiles core and autoloaded files make snippets # install hlissner/emacs-snippets into private/snippets
:bc! for a more comprehensive byte compile (
:bc will compile
the current, open *.el file).
For OSX users, I recommend Yukihiro Matsumoto’s fork of Emacs, which you can get through homebrew:
brew tap railwaycat/emacsmacport brew install emacs-mac --with-imagemagick --with-modern-icon --HEAD
To get a picture of what’s in here, check out:
- The Caskfile: lists installed plugins & where they’re configured.
- init.el: birds-eye view of loaded modules and load order.
- core/core-modeline.el: my modeline config.
- private/my-bindings.el: most of my custom keybinds.
- private/my-commands.el: custom ex commands.
- ext/*.sh: scripts that will set up external dependencies, such as irony-mode or racer.
See screenshots in the screenshots branch.
- Strong support for a large selection of languages, including C/C++, Ruby, Python, PHP, JS, Elisp, Haskell, Lua, Julia, Go, Crystal, Assembly, Java, Swift, (Ba|z)?sh, Scala, Rust, LaTeX, Processing, Octave, and more!
- Tamed popup windows with shackle. e.g. help buffers will always pop up at the bottom of the frame, and are removed with ESC.
- Workspaces & session persistence with workgroups2.
- Project and workspace-sensitive buffer navigation and functions
- A vim-like environment with evil-mode
- Fast search utilities:
- REPLs for many languages including Ruby, Python, PHP, JS, Elisp, Haskell and Lua.
- Minimalistic diffs in the fringe with git-gutter-fringe.
- Modded org-mode to be a modern note-taking/LaTeX/word-processing platform. (WIP)
- Code debugging interface with realgud (currently supports gdb, trepanjs, bashdb and zshdb, working on Python/Ruby support)
- A do-what-I-mean jump-to-definition implementation that either uses major-mode commands or falls back to dumb-jump/ctags.
- A pretty mode-line inspired by Atom’s. It
- evil-search/iedit/evil-substitute mode-line integration
- Macro-recording indicator
- Python/ruby version in mode-line (for rbenv/pyenv)
- Line numbers + highlight with nlinum
- On-demand [platform agnostic] shell with eshell
- Consistent marker-based code-folding with hideshow
- Inline code execution anywhere (once or live) with quickrun
- Snippet expansion and file templates with yasnippet
- Completion with company-mode
- Syntax checking with flycheck
- Custom O/S interaction commands, like os-reveal and os-open-in-browser
- Custom TODO, FIXME and NOTE highlighting and search (
- big-mode for presentations and demonstrations (
- Tmux integration with
Though this wasn’t designed with anyone else’s use in mind, I’d be happy to help anyone out with problems encountered using (or cribbing from) my config. Don’t hesitate to report bugs!
A few things to keep in mind:
- Cask can be flakey, especially with new builds. If you’re
getting odd errors when starting up Emacs, try to run
make installagain. I’ve also had cryptic cask errors that I had to reboot to resolve. YMMV.
- If you add new functions to any of the autoloaded
(core|modules)/defuns/*.ellibrary files, run
:reloadwill reload Emacs’ load-path if you have Emacs open while doing so.