My personal configuration of DOOM Emacs, written as an Org Mode document.
I’m using macOS and the version of emacs that I’m using is emacs-plus@29.0. It can be installed by these commands.
brew tap d12frosted/emacs-plus
brew install emacs-plus@29
This file controls which Doom modules are enable and what order they load in. Remember to run doom sync
after modifying it!
;;; init.el -*- lexical-binding: t; -*-
NOTE Press SPC h d h
(or C-h d h
for non-vim users) to access Doom’s documentation. There you’ll find a “Module Index” link where you’ll find a comprehensive list of Doom’s modules and what flags they support.
NOTE Move your cursor over a module’s name (or its flags) and press K
(or C-c c k
for non-vim users) to view its documentation. This works on flags as well (those symbols that start with a plus).
Alternatively, press gd
(or C-c c d
) on a module to browse its directory (for easy access to its source code).
(doom! :input
;;bidi ; (tfel ot) thgir etirw uoy gnipleh
;;chinese
;;japanese
;;layout ; auie,ctsrnm is the superior home row
:completion
company ; the ultimate code completion backend
;;helm ; the *other* search engine for love and life
;;ido ; the other *other* search engine...
;;ivy ; a search engine for love and life
vertico ; the search engine of the future
:ui
;;deft ; notational velocity for Emacs
doom ; what makes DOOM look the way it does
doom-dashboard ; a nifty splash screen for Emacs
;;doom-quit ; DOOM quit-message prompts when you quit Emacs
(emoji +unicode) ; 🙂
hl-todo ; highlight TODO/FIXME/NOTE/DEPRECATED/HACK/REVIEW
;;hydra
indent-guides ; highlighted indent columns
ligatures ; ligatures and symbols to make your code pretty again
minimap ; show a map of the code on the side
modeline ; snazzy, Atom-inspired modeline, plus API
nav-flash ; blink cursor line after big motions
;;neotree ; a project drawer, like NERDTree for vim
ophints ; highlight the region an operation acts on
(popup +defaults) ; tame sudden yet inevitable temporary windows
;;tabs ; a tab bar for Emacs
treemacs ; a project drawer, like neotree but cooler
unicode ; extended unicode support for various languages
vc-gutter ; vcs diff in the fringe
vi-tilde-fringe ; fringe tildes to mark beyond EOB
;;window-select ; visually switch windows
workspaces ; tab emulation, persistence & separate workspaces
zen ; distraction-free coding or writing
:editor
(evil +everywhere) ; come to the dark side, we have cookies
file-templates ; auto-snippets for empty files
fold ; (nigh) universal code folding
(format +onsave) ; automated prettiness
;;god ; run Emacs commands without modifier keys
;;lispy ; vim for lisp, for people who don't like vim
multiple-cursors ; editing in many places at once
;;objed ; text object editing for the innocent
;;parinfer ; turn lisp into python, sort of
;;rotate-text ; cycle region at point between text candidates
snippets ; my elves. They type so I don't have to
word-wrap ; soft wrapping with language-aware indent
:emacs
(dired +icons) ; making dired pretty [functional]
electric ; smarter, keyword-based electric-indent
ibuffer ; interactive buffer management
undo ; persistent, smarter undo for your inevitable mistakes
vc ; version-control and Emacs, sitting in a tree
:term
eshell ; the elisp shell that works everywhere
;;shell ; simple shell REPL for Emacs
;;term ; basic terminal emulator for Emacs
vterm ; the best terminal emulation in Emacs
:checkers
syntax ; tasing you for every semicolon you forget
(spell +flyspell +hunspell +everywhere) ; tasing you for misspelling mispelling
grammar ; tasing grammar mistake every you make
:tools
;;ansible
;;biblio ; Writes a PhD for you (citation needed)
(debugger +lsp) ; FIXME stepping through code, to help you add bugs
direnv
(docker +lsp)
editorconfig ; let someone else argue about tabs vs spaces
;; ein ; tame Jupyter notebooks with emacs
(eval +overlay) ; run code, run (also, repls)
;;gist ; interacting with github gists
lookup ; navigate your code and its documentation
lsp ; M-x vscode
magit ; a git porcelain for Emacs
make ; run make tasks from Emacs
;;pass ; password manager for nerds
pdf ; pdf enhancements
;;prodigy ; FIXME managing external services & code builders
;;rgb ; creating color strings
taskrunner ; taskrunner for all your projects
;;terraform ; infrastructure as code
tmux ; an API for interacting with tmux
tree-sitter ; syntax and parsing, sitting in a tree...
upload ; map local to remote projects via ssh/ftp
:os
(:if IS-MAC macos) ; improve compatibility with macOS
tty ; improve the terminal Emacs experience
:lang
;;agda ; types of types of types of types...
;;beancount ; mind the GAAP
(cc +lsp) ; C > C++ == 1
;;clojure ; java with a lisp
;;common-lisp ; if you've seen one lisp, you've seen them all
;;coq ; proofs-as-programs
;;crystal ; ruby at the speed of c
;;csharp ; unity, .NET, and mono shenanigans
data ; config/data formats
(dart +flutter +lsp) ; paint ui and not much else
;;dhall
;;elixir ; erlang done right
;;elm ; care for a cup of TEA?
emacs-lisp ; drown in parentheses
;;erlang ; an elegant language for a more civilized age
;;ess ; emacs speaks statistics
;;factor
;;faust ; dsp, but you get to keep your soul
;;fortran ; in FORTRAN, GOD is REAL (unless declared INTEGER)
;;fsharp ; ML stands for Microsoft's Language
;;fstar ; (dependent) types and (monadic) effects and Z3
;;gdscript ; the language you waited for
(go +lsp) ; the hipster dialect
;;(graphql +lsp) ; Give queries a REST
;;(haskell +lsp) ; a language that's lazier than I am
;;hy ; readability of scheme w/ speed of python
;;idris ; a language you can depend on
(json +lsp) ; At least it ain't XML
(java +lsp) ; the poster child for carpal tunnel syndrome
(javascript +lsp) ; all(hope(abandon(ye(who(enter(here))))))
;;(julia +lsp) ; a better, faster MATLAB
kotlin ; a better, slicker Java(Script)
(latex +cdlatex +lsp ) ; writing papers in Emacs has never been so fun
;;lean ; for folks with too much to prove
;;ledger ; be audit you can be
;;lua ; one-based indices? one-based indices
(markdown +grip) ; writing docs for people to ignore
;;nim ; python + lisp at the speed of c
;;nix ; I hereby declare "nix geht mehr!"
;;ocaml ; an objective camel
(org +dragndrop +jupyter +pretty) ; organize your plain life in plain text
php ; perl's insecure younger brother
;;plantuml ; diagrams for confusing people more
;;purescript ; javascript, but functional
(python +lsp) ; beautiful is better than ugly
;;qt ; the 'cutest' gui framework ever
;;racket ; a DSL for DSLs
;;raku ; the artist formerly known as perl6
rest ; Emacs as a REST client
;;rst ; ReST in peace
;;(ruby +rails) ; 1.step {|i| p "Ruby is #{i.even? ? 'love' : 'life'}"}
(rust +lsp) ; Fe2O3.unwrap().unwrap().unwrap().unwrap()
;;scala ; java, but good
;;(scheme +guile) ; a fully conniving family of lisps
(sh +fish +lsp) ; she sells {ba,z,fi}sh shells on the C xor
;;sml
solidity ; do you need a blockchain? No.
swift ; who asked for emoji variables?
;;terra ; Earth and Moon in alignment for performance.
web ; the tubes
(yaml +lsp) ; JSON, but readable
;;zig ; C, but simpler
:email
(mu4e +org +gmail)
;;notmuch
;;(wanderlust +gmail)
:app
calendar
emms
everywhere ; *leave* Emacs!? You must be joking
;;irc ; how neckbeards socialize
(rss +org) ; emacs as an RSS reader
;;twitter ; twitter client https://twitter.com/vnought
:config
;;literate
(default +bindings +smartparens))
Place your private configuration here! Remember, you do not need to run doom sync
after modifying this file!
Here are some additional functions/macros that could help you configure Doom:
load!
for loading external *.el files relative to this oneuse-package!
for configuring packagesafter!
for running code after a package has loadedadd-load-path!
for adding directories to theload-path
, relative to this file. Emacs searches theload-path
when you load packages withrequire
oruse-package
.map!
for binding new keys
To get information about any of these functions/macros, move the cursor over the highlighted symbol at press K
(non-evil users must press C-c c k
).
This will open documentation for it, including demos of how they are used.
You can also try gd
(or C-c c d
) to jump to their definition and see how they are implemented.
;;; $DOOMDIR/config.el -*- lexical-binding: t; -*-
Some functionality uses this to identify you, e.g. GPG configuration, email clients, file templates and snippets.
(setq user-full-name "Masnun Siam")
Doom exposes five (optional) variables for controlling fonts in Doom. Here are the three important ones:
doom-font
doom-variable-pitch-font
doom-big-font
– used fordoom-big-font-mode
; use this for presentations or streaming.
They all accept either a font-spec, font string (“Input Mono-12”), or xlfd font string. You generally only need these two:
(setq doom-font (font-spec :family "monospace" :size 12 :weight 'semi-light) doom-variable-pitch-font (font-spec :family "sans" :size 13))
Set regular, variable pitch, and big fonts.
(setq doom-font (font-spec :family "CaskaydiaCove Nerd Font" :size 19)
doom-variable-pitch-font (font-spec :family "CaskaydiaCove Nerd Font" :size 19)
doom-big-font (font-spec :family "BlexMono Nerd Font" :size 24)
doom-unicode-font (font-spec :family "FiraCode Nerd Font" :size 18))
Enable bold and italic text.
(after! doom-themes
(setq doom-themes-enable-bold t
doom-themes-enable-italic t))
Make comments and keywords italicized.
(custom-set-faces!
'(font-lock-comment-face :slant italic)
'(font-lock-keyword-face :slant italic))
There are two ways to load a theme. Both assumes that theme is installed and available. You can either set doom-theme
or manually load a theme with the load-theme
function.
(setq doom-theme 'doom-one)
I normally hide the titlebar since it has no use
(add-to-list 'default-frame-alist '(undecorated . t))
(doom/set-frame-opacity 90)
This determines the style of line numbers in effect. If set to nil
, line numbers are disabled. For relative line numbers, set this to relative
.
(setq display-line-numbers-type t)
(setq global-hl-line-mode nil)
(setq-default tab-width 4)
;; (setq highlight-indent-guides-method 'nil')
;; (setq highlight-indent-guides-responsive 'stack)
;; (setq highlight-indent-guides-delay 0)
If non-nil, cause imenu to see doom-modeline
declarations. This is done by adjusting lisp-imenu-generic-expression
to include support for finding doom-modeline-def-*
forms. Must be set before loading doom-modeline.
;; (setq doom-modeline-support-imenu t)
How tall the mode-line should be. It’s only respected in GUI. If the actual char height is larger, it respects the actual height.
(setq doom-modeline-height 30)
How wide the mode-line bar should be. It’s only respected in GUI.
(setq doom-modeline-bar-width 4)
Whether to use hud instead of default bar. It’s only respected in GUI.
(setq doom-modeline-hud nil)
The limit of the window width. If window-width
is smaller than the limit, some information won’t be displayed. It can be an integer or a float number. `nil’ means no limit.”
(setq doom-modeline-window-width-limit 85)
How to detect the project root. nil means to use default-directory
. The project management packages have some issues on detecting project root. e.g. projectile
doesn’t handle symlink folders well, while project
is unable to handle sub-projects. You can specify one if you encounter the issue.
(setq doom-modeline-project-detection 'auto)
Determines the style used by doom-modeline-buffer-file-name
.
Given ~/Projects/FOSS/emacs/lisp/comint.el auto => emacs/lisp/comint.el (in a project) or comint.el truncate-upto-project => ~/P/F/emacs/lisp/comint.el truncate-from-project => ~/Projects/FOSS/emacs/l/comint.el truncate-with-project => emacs/l/comint.el truncate-except-project => ~/P/F/emacs/l/comint.el truncate-upto-root => ~/P/F/e/lisp/comint.el truncate-all => ~/P/F/e/l/comint.el truncate-nil => ~/Projects/FOSS/emacs/lisp/comint.el relative-from-project => emacs/lisp/comint.el relative-to-project => lisp/comint.el file-name => comint.el buffer-name => comint.el<2> (uniquify buffer name)
If you are experiencing the laggy issue, especially while editing remote files with tramp, please try file-name
style. Please refer to bbatsov/projectile#657.
(setq doom-modeline-buffer-file-name-style 'auto)
Whether display icons in the mode-line. While using the server mode in GUI, should set the value explicitly.
(setq doom-modeline-icon t)
Whether display the icon for major-mode
. It respects doom-modeline-icon
.
(setq doom-modeline-major-mode-icon t)
Whether display the colorful icon for major-mode
. It respects all-the-icons-color-icons
.
(setq doom-modeline-major-mode-color-icon t)
Whether display the icon for the buffer state. It respects doom-modeline-icon
.
(setq doom-modeline-buffer-state-icon t)
Whether display the modification icon for the buffer. It respects doom-modeline-icon
and doom-modeline-buffer-state-icon
.
(setq doom-modeline-buffer-modification-icon t)
Whether to use unicode as a fallback (instead of ASCII) when not using icons.
(setq doom-modeline-unicode-fallback nil)
Whether display the buffer name.
(setq doom-modeline-buffer-name t)
Whether display the minor modes in the mode-line.
(setq doom-modeline-minor-modes nil)
If non-nil, a word count will be added to the selection-info modeline segment.
(setq doom-modeline-enable-word-count t)
Major modes in which to display word count continuously. Also applies to any derived modes. Respects doom-modeline-enable-word-count
. If it brings the sluggish issue, disable doom-modeline-enable-word-count
or remove the modes from doom-modeline-continuous-word-count-modes
.
(setq doom-modeline-continuous-word-count-modes '(markdown-mode gfm-mode org-mode))
Whether display the buffer encoding.
(setq doom-modeline-buffer-encoding t)
Whether display the indentation information.
(setq doom-modeline-indent-info t)
If non-nil, only display one number for checker information if applicable.
(setq doom-modeline-checker-simple-format t)
The maximum number displayed for notifications.
(setq doom-modeline-number-limit 99)
The maximum displayed length of the branch name of version control.
(setq doom-modeline-vcs-max-length 12)
Whether display the workspace name. Non-nil to display in the mode-line.
(setq doom-modeline-workspace-name t)
Whether display the perspective name. Non-nil to display in the mode-line.
(setq doom-modeline-persp-name t)
If non nil the default perspective name is displayed in the mode-line.
(setq doom-modeline-display-default-persp-name nil)
If non nil the perspective name is displayed alongside a folder icon.
(setq doom-modeline-persp-icon t)
Whether display the `lsp’ state. Non-nil to display in the mode-line.
(setq doom-modeline-lsp t)
Whether display the GitHub notifications. It requires ghub
package.
(setq doom-modeline-github nil)
The interval of checking GitHub.
(setq doom-modeline-github-interval (* 30 60))
Whether display the modal state icon. Including evil
, overwrite
, god
, ryo
and xah-fly-keys
, etc.
(setq doom-modeline-modal-icon t)
Whether display the mu4e notifications. It requires mu4e-alert
package.
Also enable the start of mu4e-alert.
(setq doom-modeline-mu4e nil)
;; (mu4e-alert-enable-mode-line-display)
Whether display the gnus notifications.
(setq doom-modeline-gnus t)
Whether gnus should automatically be updated and how often (set to 0 or smaller than 0 to disable)
(setq doom-modeline-gnus-timer 2)
Whether groups should be excluded when gnus automatically being updated.
(setq doom-modeline-gnus-excluded-groups '("dummy.group"))
Whether display the IRC notifications. It requires circe
or erc
package.
(setq doom-modeline-irc nil)
Function to stylize the irc buffer names.
(setq doom-modeline-irc-stylize 'identity)
Whether display the environment version. Or for individual languages.
(setq doom-modeline-env-version t)
(setq doom-modeline-env-enable-python t)
(setq doom-modeline-env-enable-ruby t)
(setq doom-modeline-env-enable-perl t)
(setq doom-modeline-env-enable-go t)
(setq doom-modeline-env-enable-elixir t)
(setq doom-modeline-env-enable-rust t)
Change the executables to use for the language version string.
(setq doom-modeline-env-python-executable "python") ; or `python-shell-interpreter'
(setq doom-modeline-env-ruby-executable "ruby")
(setq doom-modeline-env-perl-executable "perl")
(setq doom-modeline-env-go-executable "go")
(setq doom-modeline-env-elixir-executable "iex")
(setq doom-modeline-env-rust-executable "rustc")
What to display as the version while a new one is being loaded.
(setq doom-modeline-env-load-string "...")
Hooks that run before/after the modeline version string is updated.
(setq doom-modeline-before-update-env-hook nil)
(setq doom-modeline-after-update-env-hook nil)
Changing the dired listing mode to show all files
(setq dired-lising-switches "-la")
If you use org
and don’t want your org files in the default location below, change org-directory
. It must be set before org loads!
(setq org-directory "~/org/")
(map! :leader
:desc "Org babel tangle" "m B" #'org-babel-tangle)
(use-package! org-auto-tangle
:defer t
:hook (org-mode . org-auto-tangle-mode)
:config
(setq org-auto-tangle-default t)
)
(setq org-src-preserve-indentation nil
org-edit-src-content-indentation 0)
(setq org-hide-emphasis-markers t)
(setq org-ellipsis " ▼ ")
(after! org-faces
(defun org-colors-dracula ()
"Enable Dracula colors for Org headers."
(interactive)
(dolist
(face
'((org-level-1 1.7 "#8be9fd" ultra-bold)
(org-level-2 1.6 "#bd93f9" extra-bold)
(org-level-3 1.5 "#50fa7b" bold)
(org-level-4 1.4 "#ff79c6" semi-bold)
(org-level-5 1.3 "#9aedfe" normal)
(org-level-6 1.2 "#caa9fa" normal)
(org-level-7 1.1 "#5af78e" normal)
(org-level-8 1.0 "#ff92d0" normal)))
(set-face-attribute (nth 0 face) nil :font doom-variable-pitch-font :weight (nth 3 face) :height (nth 1 face) :foreground (nth 2 face)))
(set-face-attribute 'org-table nil :font doom-font :weight 'normal :height 1.0 :foreground "#bfafdf"))
;; Load our desired org-colors-* theme on startup
(org-colors-dracula))
(setq org-superstar-headline-bullets-list '("◉" "●" "○" "◆" "●" "○" "◆"))
(setq org-superstar-item-bullet-alist '((?+ . ?➤) (?- . ?✦))) ; changes +/- symbols in item lists
(add-hook! org-mode (org-superstar-mode))
(custom-set-faces
'(markdown-header-face ((t (:inherit font-lock-function-name-face :weight bold :family "variable-pitch"))))
'(markdown-header-face-1 ((t (:inherit markdown-header-face :height 1.8))))
'(markdown-header-face-2 ((t (:inherit markdown-header-face :height 1.4))))
'(markdown-header-face-3 ((t (:inherit markdown-header-face :height 1.2)))))
(setq projectile-project-search-path '("~/Documents/projects/flutter/personal/" "~/Documents/projects/flutter/roxarth/" "~/Documents/projects/flutter/BF/" "~/.doom.d" "~/.config/"))
(with-eval-after-load 'projectile
(add-to-list 'projectile-project-root-files-bottom-up "pubspec.yaml")
(add-to-list 'projectile-project-root-files-bottom-up "BUILD"))
(add-hook! 'web-mode-hook 'prettier-js-mode)
(map! :map cdlatex-mode-map
:i "TAB" #'cdlatex-tab)
(add-to-list 'auto-mode-alist '("\\.m\\'" . octave-mode))
Revert buffers when the underlying file has changed
(global-auto-revert-mode 1)
(setq global-auto-revert-non-file-buffers t)
(define-globalized-minor-mode global-rainbow-mode rainbow-mode
(lambda () (rainbow-mode 1)))
(global-rainbow-mode 1)
(map! :map dap-mode-map
:leader
:prefix ("d" . "dap")
;; basics
:desc "dap next" "n" #'dap-next
:desc "dap step in" "i" #'dap-step-in
:desc "dap step out" "o" #'dap-step-out
:desc "dap continue" "c" #'dap-continue
:desc "dap hydra" "h" #'dap-hydra
:desc "dap debug restart" "r" #'dap-debug-restart
:desc "dap debug" "s" #'dap-debug
;; debug
:prefix ("dd" . "Debug")
:desc "dap debug recent" "r" #'dap-debug-recent
:desc "dap debug last" "l" #'dap-debug-last
;; eval
:prefix ("de" . "Eval")
:desc "eval" "e" #'dap-eval
:desc "eval region" "r" #'dap-eval-region
:desc "eval thing at point" "s" #'dap-eval-thing-at-point
:desc "add expression" "a" #'dap-ui-expressions-add
:desc "remove expression" "d" #'dap-ui-expressions-remove
:prefix ("db" . "Breakpoint")
:desc "dap breakpoint toggle" "b" #'dap-breakpoint-toggle
:desc "dap breakpoint condition" "c" #'dap-breakpoint-condition
:desc "dap breakpoint hit count" "h" #'dap-breakpoint-hit-condition
:desc "dap breakpoint log message" "l" #'dap-breakpoint-log-message)
(after! dap-mode
(setq dap-python-debugger 'debugpy))
;; accept completion from copilot and fallback to company
(use-package! copilot
:hook (prog-mode . copilot-mode)
:bind (:map copilot-completion-map
("<tab>" . 'copilot-accept-completion)
("TAB" . 'copilot-accept-completion)
("C-TAB" . 'copilot-accept-completion-by-word)
("C-<tab>" . 'copilot-accept-completion-by-word)))
To install a package with Doom you must declare them here and run doom sync
on the command line, then restart Emacs for the changes to take effect – or use M-x doom/reload
.
To install SOME-PACKAGE from MELPA, ELPA or emacsmirror:
(package! some-package)
To install a package directly from a remote git repo, you must specify a :recipe
. You’ll find documentation on what :recipe
accepts here: https://github.com/raxod502/straight.el#the-recipe-format
(package! another-package :recipe (:host github :repo "username/repo"))
If the package you are trying to install does not contain a PACKAGENAME.el file, or is located in a subdirectory of the repo, you’ll need to specify :files
in the :recipe
:
(package! this-package :recipe (:host github :repo "username/repo" :files ("some-file.el" "src/lisp/*.el")))
If you’d like to disable a package included with Doom, you can do so here with the :disable
property:
(package! builtin-package :disable t)
You can override the recipe of a built in package without having to specify all the properties for :recipe
. These will inherit the rest of its recipe from Doom or MELPA/ELPA/Emacsmirror:
(package! builtin-package :recipe (:nonrecursive t)) (package! builtin-package-2 :recipe (:repo "myfork/package"))
Specify a :branch
to install a package from a particular branch or tag. This is required for some packages whose default branch isn’t master
(which our package manager can’t deal with; see radian-software/straight.el#279)
(package! builtin-package :recipe (:branch "develop"))
Use :pin
to specify a particular commit to install.
(package! builtin-package :pin "1a2b3c4d5e")
Doom’s packages are pinned to a specific commit and updated from release to release. The unpin!
macro allows you to unpin single packages…
(unpin! pinned-package)
…or multiple packages
;(unpin! pinned-package another-pinned-package)
…Or all packages (NOT RECOMMENDED; will likely break things)
;(unpin! t)
;; -*- no-byte-compile: t; -*-
;;; $DOOMDIR/packages.el
(package! org-auto-tangle)
(package! git-modes)
(package! vimrc-mode)
(package! prettier-js)
(package! rainbow-mode)
(package! systemd)
(package! pkgbuild-mode)
(package! lua-mode)
(package! copilot
:recipe (:host github :repo "zerolfx/copilot.el" :files ("*.el" "dist")))