;-*- eval: (load-file “./init-dev.el”); -*-
This is a literate configuration for Emacs.
Tangling this file creates an Elisp file, ~/.emacs.d/lisp/init.el.
;;; early-init.el --- Emacs pre package.el & GUI configuration -*- lexical-binding: t; -*-
;;; Code:(setq package-enable-at-startup nil)
(setq inhibit-default-init nil)(setq native-comp-async-report-warnings-errors nil)Running this form will launch the debugger after loading a package.
This is useful for finding out when a dependency is requiring a package (perhaps earlier than you want).
Use by tangling this block and launching Emacs with emacs --debug-init.
(unless (string-empty-p file)
(eval-after-load file
'(debug)))Similarly, this variable will hit the debugger when a message matches its regexp.
(setq debug-on-message "")Adding a variable watcher can be a useful way to track down initialization and mutation of a variable.
(add-variable-watcher 'org-capture-after-finalize-hook
(lambda (symbol newval operation where)
(debug)
(message "%s set to %s" symbol newval)))(setq debug-on-error t)Skipping a bunch of regular expression searching in the file-name-handler-alist should improve start time.
(defvar default-file-name-handler-alist file-name-handler-alist)
(setq file-name-handler-alist nil)gc-cons-threshold (800 KB) and gc-cons-percentage (0.1) control when the Emacs garbage collector can kick in.
Temporarily turning these off during init should decrease startup time.
Resetting them afterward will ensure that normal operations don’t suffer from a large GC periods.
The following is a table shows values from popular Emacs configurations.
| Distribution | gc-cons-threshold |
|---|---|
| Default | 800000 |
| Doom | 16777216 |
| Spacemacs | 100000000 |
(setq gc-cons-threshold most-positive-fixnum
gc-cons-percentage 1)
(defun +gc-after-focus-change ()
"Run GC when frame loses focus."
(run-with-idle-timer
5 nil
(lambda () (unless (frame-focus-state) (garbage-collect)))))(defun +reset-init-values ()
(run-with-idle-timer
1 nil
(lambda ()
(setq file-name-handler-alist default-file-name-handler-alist
gc-cons-percentage 0.1
gc-cons-threshold 100000000)
(message "gc-cons-threshold & file-name-handler-alist restored")
(when (boundp 'after-focus-change-function)
(add-function :after after-focus-change-function #'+gc-after-focus-change)))))
(with-eval-after-load 'elpaca
(add-hook 'elpaca-after-init-hook '+reset-init-values))Turning off these visual elements before UI initialization should speed up init.
(push '(menu-bar-lines . 0) default-frame-alist)
(push '(tool-bar-lines . 0) default-frame-alist)
(push '(vertical-scroll-bars) default-frame-alist)Prevent instructions on how to close an emacsclient frame.
(setq server-client-instructions nil)Implicitly resizing the Emacs frame adds to init time. Fonts larger than the system default can cause frame resizing, which adds to startup time.
(setq frame-inhibit-implied-resize t)Set default and backup fonts
(push '(font . "Source Code Pro") default-frame-alist)
(set-face-font 'default "Source Code Pro")
(set-face-font 'variable-pitch "DejaVu Sans")
(copy-face 'default 'fixed-pitch)Ignore X resources.
(advice-add #'x-apply-session-resources :override #'ignore)Taken from:
https://github.com/vsemyonoff/emacsrc/blob/14649a5bafea99cc7e13e7d048e9d15aed7926ce/early-init.el
This helps with a bug I was hitting when using desktop-save-mode’s desktop-read.
(setq desktop-restore-forces-onscreen nil)Silence the bell function
(setq ring-bell-function #'ignore
inhibit-startup-screen t)(provide 'early-init)
;;; early-init.el ends hereThe following line turns on lexical binding for performance reasons.
;; -*- lexical-binding: t; -*-This function displays how long Emacs took to start. It’s a rough way of knowing when/if I need to optimize my init file.
(add-hook 'elpaca-after-init-hook
(lambda ()
(message "Emacs loaded in %s with %d garbage collections."
(format "%.2f seconds"
(float-time
(time-subtract (current-time) before-init-time)))
gcs-done)))We can also enable the profiler to view a report after init.
(profiler-start 'cpu+mem)
(add-hook 'elpaca-after-init-hook (lambda () (profiler-stop) (profiler-report)))ELP is useful for seeing which functions in a package are “hot”.
(require 'elp)
(with-eval-after-load file
(elp-instrument-package file))
(add-hook 'elpaca-after-init-hook
(lambda () (elp-results) (elp-restore-package (intern file))))(setq initial-buffer-choice t) ;;*scratch*I prefer to keep my themes in a sub-folder of ~/.emacs.d
(setq custom-theme-directory "~/.emacs.d/themes/")I’m working on a theme that is readable and attractive.
(defvar +theme 'mine "Default theme.")
(require 'cl-lib)
(require 'custom)
;; remove synthetic use-package theme
(unless (remq 'use-package custom-enabled-themes) (load-theme +theme t))An elisp package manager
(defvar elpaca-installer-version 0.7)
(defvar elpaca-directory (expand-file-name "elpaca/" user-emacs-directory))
(defvar elpaca-builds-directory (expand-file-name "builds/" elpaca-directory))
(defvar elpaca-repos-directory (expand-file-name "repos/" elpaca-directory))
(defvar elpaca-order '(elpaca :repo "https://github.com/progfolio/elpaca.git"
:ref nil :depth nil
:pre-build ("git" "remote" "set-url" "origin" "git@github.com:progfolio/elpaca.git")
:files (:defaults "elpaca-test.el" (:exclude "extensions"))
:build (:not elpaca--activate-package)))
(let* ((repo (expand-file-name "elpaca/" elpaca-repos-directory))
(build (expand-file-name "elpaca/" elpaca-builds-directory))
(order (cdr elpaca-order))
(default-directory repo))
(add-to-list 'load-path (if (file-exists-p build) build repo))
(unless (file-exists-p repo)
(make-directory repo t)
(condition-case-unless-debug err
(if-let ((buffer (pop-to-buffer-same-window "*elpaca-bootstrap*"))
((zerop (call-process "git" nil buffer t "clone"
(plist-get order :repo) repo)))
((zerop (call-process "git" nil buffer t "checkout"
(or (plist-get order :ref) "--"))))
(emacs (concat invocation-directory invocation-name))
((zerop (call-process emacs nil buffer nil "-Q" "-L" "." "--batch"
"--eval" "(byte-recompile-directory \".\" 0 'force)")))
((require 'elpaca))
((elpaca-generate-autoloads "elpaca" repo)))
(and (message "%S" (buffer-string)) (kill-buffer buffer))
(error "%s" (with-current-buffer buffer (buffer-string))))
((error) (warn "%s" err) (delete-directory repo 'recursive))))
(unless (require 'elpaca-autoloads nil t)
(require 'elpaca)
(elpaca-generate-autoloads "elpaca" repo)
(load "./elpaca-autoloads")))
(add-hook 'after-init-hook #'elpaca-process-queues)
(elpaca `(,@elpaca-order :depth nil))
(setq elpaca-queue-limit 30)(with-eval-after-load 'evil
(evil-make-intercept-map elpaca-ui-mode-map))Keychain is a gpg/ssh agent that allows me to cache my credentials. This package gets the correct environment variables so elpaca can use the ssh protocol.
;; We need this loaded for SSH protocol
(elpaca-queue
(elpaca keychain-environment
(require 'keychain-environment)
(keychain-refresh-environment)))An Elpaca menu for MELPA submissions.
(elpaca-queue
(elpaca (melpulls :host github :repo "progfolio/melpulls" :protocol ssh)
(add-to-list 'elpaca-menu-functions 'melpulls)))(defmacro use-feature (name &rest args)
"Like `use-package' but accounting for asynchronous installation.
NAME and ARGS are in `use-package'."
(declare (indent defun))
`(use-package ,name
:ensure nil
,@args))(elpaca elpaca-use-package
(require 'elpaca-use-package)
(elpaca-use-package-mode)
(setq use-package-always-ensure t))(if debug-on-error
(setq use-package-verbose t
use-package-expand-minimally nil
use-package-compute-statistics t)
(setq use-package-verbose nil
use-package-expand-minimally t))Packages that I’m developing or aren’t part of any online repositories go in ~/emacs.d/lisp/.
(let ((default-directory "~/.emacs.d/lisp/"))
(when (file-exists-p default-directory)
(normal-top-level-add-to-load-path '("."))
(normal-top-level-add-subdirs-to-load-path)))(setq literate-file (concat user-emacs-directory "init.org"))(defun +terminal ()
"Set the terimnal coding system."
(unless (display-graphic-p)
(set-terminal-coding-system 'utf-8)))
(add-hook 'server-after-make-frame-hook #'+terminal)I keep my sensitive, personal information in a separate file so I can publish this configuration publicly.
(load-file "~/Documents/emacs-secrets.el")general.el provides a more convenient method for binding keys in emacs (for both evil and non-evil users).
Load general before the remaining packages so they can make use of the :general keyword in their declarations.
(use-package general
:ensure (:wait t)
:demand t
:config
(general-override-mode)
(general-auto-unbind-keys)
<<general-config>>)(general-define-key
:keymaps 'override
:states '(insert normal hybrid motion visual operator emacs)
:prefix-map '+prefix-map
:prefix "SPC"
:global-prefix "S-SPC")
(general-create-definer global-definer
:wk-full-keys nil
:keymaps '+prefix-map)(global-definer
"SPC" 'execute-extended-command
"/" 'occur
"!" 'shell-command
":" 'eval-expression
"." 'repeat
"h" (general-simulate-key "C-h" :which-key "help")
"z" '((lambda (local) (interactive "p")
(unless repeat-mode (repeat-mode))
(let ((local current-prefix-arg)
(current-prefix-arg nil))
(call-interactively (if local #'text-scale-adjust #'global-text-scale-adjust))))
:which-key "zoom"))We define a global-leader definer to access major-mode specific bindings:
(general-create-definer global-leader
:keymaps 'override
:states '(insert normal hybrid motion visual operator)
:prefix "SPC m"
:non-normal-prefix "S-SPC m"
"" '( :ignore t
:which-key
(lambda (arg)
(cons (cadr (split-string (car arg) " "))
(replace-regexp-in-string "-mode$" "" (symbol-name major-mode))))))And a macro to ease the creation of nested menu bindings:
(defmacro +general-global-menu! (name prefix-key &rest body)
"Create a definer named +general-global-NAME wrapping global-definer.
Create prefix map: +general-global-NAME-map. Prefix bindings in BODY with PREFIX-KEY."
(declare (indent 2))
(let* ((n (concat "+general-global-" name))
(prefix-map (intern (concat n "-map"))))
`(progn
(general-create-definer ,(intern n)
:wrapping global-definer
:prefix-map (quote ,prefix-map)
:prefix ,prefix-key
:wk-full-keys nil
"" '(:ignore t :which-key ,name))
(,(intern n) ,@body))))(+general-global-menu! "application" "a"
"p" '(:ignore t "elpaca")
"pb" 'elpaca-browse
"pr" '((lambda () (interactive)
(let ((current-prefix-arg (not current-prefix-arg))
(this-command 'elpaca-rebuild))
(call-interactively #'elpaca-rebuild)))
:which-key "rebuild")
"pm" 'elpaca-manager
"pl" 'elpaca-log
"pi" 'elpaca-info
"pI" '((lambda () (interactive) (info "Elpaca"))
:which-key "elpaca-info")
"ps" 'elpaca-status
"pt" 'elpaca-try
"pv" 'elpaca-visit)(+general-global-menu! "buffer" "b"
"d" 'kill-current-buffer
"o" '((lambda () (interactive) (switch-to-buffer nil))
:which-key "other-buffer")
"p" 'previous-buffer
"r" 'rename-buffer
"R" 'revert-buffer
"M" '((lambda () (interactive) (switch-to-buffer "*Messages*"))
:which-key "messages-buffer")
"n" 'next-buffer
"s" 'scratch-buffer
"TAB" '((lambda () (interactive) (switch-to-buffer nil))
:which-key "other-buffer"))(+general-global-menu! "bookmark" "B")(+general-global-menu! "eval" "e"
"b" 'eval-buffer
"d" 'eval-defun
"e" 'eval-expression
"p" 'pp-eval-last-sexp
"s" 'eval-last-sexp)(+general-global-menu! "file" "f"
"d" '((lambda (&optional arg)
(interactive "P")
(let ((buffer (when arg (current-buffer))))
(diff-buffer-with-file buffer))) :which-key "diff-with-file")
"e" '(:ignore t :which-key "edit")
"ed" '((lambda () (interactive) (find-file-existing literate-file) (widen))
:which-key "dotfile")
"f" 'find-file
"l" '((lambda (&optional arg)
(interactive "P")
(call-interactively (if arg #'find-library-other-window #'find-library)))
:which-key "+find-library")
"p" 'find-function-at-point
"P" 'find-function
"R" 'rename-file-and-buffer
"s" 'save-buffer
"v" 'find-variable-at-point
"V" 'find-variable)(+general-global-menu! "frame" "F"
"D" 'delete-other-frames
"F" 'select-frame-by-name
"O" 'other-frame-prefix
"c" '(:ingore t :which-key "color")
"cb" 'set-background-color
"cc" 'set-cursor-color
"cf" 'set-foreground-color
"f" 'set-frame-font
"m" 'make-frame-on-monitor
"n" 'next-window-any-frame
"o" 'other-frame
"p" 'previous-window-any-frame
"r" 'set-frame-name)(+general-global-menu! "git/version-control" "g")(+general-global-menu! "link" "l")(+general-global-menu! "narrow" "n"
"d" 'narrow-to-defun
"p" 'narrow-to-page
"r" 'narrow-to-region
"w" 'widen)(+general-global-menu! "project" "p"
"b" '(:ignore t :which-key "buffer"))(+general-global-menu! "quit" "q"
"q" 'save-buffers-kill-emacs
"r" 'restart-emacs
"Q" 'kill-emacs)(+general-global-menu! "spelling" "s")(+general-global-menu! "text" "x"
"i" 'insert-char
"I" (general-simulate-key "C-x 8" :which-key "iso"))
(+general-global-menu! "tab" "t")(+general-global-menu! "toggle" "T"
"d" '(:ignore t :which-key "debug")
"de" 'toggle-debug-on-error
"dq" 'toggle-debug-on-quit
"s" '(:ignore t :which-key "spelling"))(+general-global-menu! "window" "w"
"?" 'split-window-vertically
"=" 'balance-windows
"/" 'split-window-horizontally
"O" 'delete-other-windows
"X" '((lambda () (interactive) (call-interactively #'other-window) (kill-buffer-and-window))
:which-key "kill-other-buffer-and-window")
"d" 'delete-window
"h" 'windmove-left
"j" 'windmove-down
"k" 'windmove-up
"l" 'windmove-right
"o" 'other-window
"t" 'window-toggle-side-windows
"." '(:ingore :which-key "resize")
".h" '((lambda () (interactive)
(call-interactively (if (window-prev-sibling) #'enlarge-window-horizontally
#'shrink-window-horizontally)))
:which-key "divider left")
".l" '((lambda () (interactive)
(call-interactively (if (window-next-sibling) #'enlarge-window-horizontally
#'shrink-window-horizontally)))
:which-key "divider right")
".j" '((lambda () (interactive)
(call-interactively (if (window-next-sibling) #'enlarge-window #'shrink-window)))
:which-key "divider up")
".k" '((lambda () (interactive)
(call-interactively (if (window-prev-sibling) #'enlarge-window #'shrink-window)))
:which-key "divider down")
"x" 'kill-buffer-and-window);;vim-like completion
(general-create-definer completion-def
:prefix "C-x")Evil is an extensible vi layer for Emacs. It emulates the main features of Vim, and provides facilities for writing custom extensions.
(use-package evil
:demand t
:preface (setq evil-want-keybinding nil)
:custom
(evil-symbol-word-search t "search by symbol with * and #.")
(evil-shift-width 2 "Same behavior for vim's '<' and '>' commands")
(evil-complete-all-buffers nil)
(evil-want-integration t)
(evil-want-C-i-jump t)
(evil-search-module 'evil-search "use vim-like search instead of 'isearch")
(evil-undo-system 'undo-redo)
:hook
(lisp-interaction-mode . (lambda () (setq-local evil-lookup-func #'+evil-lookup-elisp-symbol)))
(emacs-lisp-mode . (lambda () (setq-local evil-lookup-func #'+evil-lookup-elisp-symbol)))
:config
(defun +evil-lookup-elisp-symbol ()
"Lookup elisp symbol at point."
(if-let ((symbol (thing-at-point 'symbol)))
(describe-symbol (intern symbol))
(user-error "No symbol at point")))
(+general-global-window
"H" 'evil-window-move-far-left
"J" 'evil-window-move-very-bottom
"K" 'evil-window-move-very-top
"L" 'evil-window-move-far-right)
(+general-global-menu! "quit" "q"
":" 'evil-command-window-ex
"/" 'evil-command-window-search-forward
"?" 'evil-command-window-search-backward)
;;I want Emacs regular mouse click behavior
(define-key evil-motion-state-map [down-mouse-1] nil)
(evil-mode))anzu for evil-mode
Shows match counts in mode line.
(use-package evil-anzu
:after (evil anzu))This is a collection of Evil bindings for the parts of Emacs that Evil does not cover properly by default.
(use-package evil-collection
:ensure (:remotes ("origin"
("fork" :repo "progfolio/evil-collection")))
:after (evil)
:config
(setq evil-collection-mode-list (remq 'elpaca evil-collection-mode-list))
(evil-collection-init)
:init (setq evil-collection-setup-minibuffer t)
:custom
(evil-collection-elpaca-want-g-filters nil)
(evil-collection-ement-want-auto-retro t))(use-package accord
:ensure (accord :host github :repo "progfolio/accord" :protocol ssh)
:general
(+general-global-application
"a" '(:ignore t :which-key "accord")
"aa" 'accord)
:config
(global-leader
:major-modes '(accord-mode)
:keymaps '(accord-mode-map)
"/" 'accord-channel-search
";" 'accord-channel-last
"S" '(:ignore t :which-key "Server")
"SN" 'accord-server-next
"SP" 'accord-server-prev
"c" '(:ignore t :which-key "channel")
"c;" 'accord-channel-last
"c/" 'accord-channel-search
"cj" 'accord-channel-scroll-down
"ck" 'accord-channel-scroll-up
"cn" 'accord-channel-next
"cp" 'accord-channel-prev
"cr" 'accord-channel-mark-read
"cu" 'accord-channel-goto-unread
"cu" 'accord-channel-scroll-up
;; These look superfluous, but without the :which-key value
;; we're picking up names from org mode leader bindings...
;; Not sure if it's a bug with general.el or my init.
"d" '(accord-delete-message :which-key "accord-delete-message")
"e" '(accord-edit-message :which-key "accord-edit-message")
"s" '(accord-send-message :which-key "accord-send-message"))
(+general-global-application
"a/" 'accord-channel-search
"a;" 'accord-channel-last
"ac" '(:ignore t :which-key "channel")
"ac/" 'accord-channel-search
"ac;" 'accord-channel-last
"acj" 'accord-channel-scroll-down
"ack" 'accord-channel-scroll-up
"acn" 'accord-channel-next
"acp" 'accord-channel-prev
"acr" 'accord-channel-mark-read
"acu" 'accord-channel-goto-unread
"acu" 'accord-channel-scroll-up
"ad" 'accord-delete-message
"ae" 'accord-edit-message
"as" 'accord-send-message)
(add-to-list 'display-buffer-alist
'("\\*accord\\*" display-buffer-below-selected (window-height . 0.20)))
(defun accord-setup ()
(flyspell-mode)
(visual-line-mode))
(add-hook 'accord-mode-hook 'accord-setup))Dark color theme with a deep blue background
(use-package afternoon-theme :defer t)A collection of almost monochrome emacs themes in a couple of variants. https://github.com/cryon/almost-mono-themes
(use-package almost-mono-themes :defer t)anzu.el provides a minor mode which displays ‘current match/total matches’ in the mode-line in various search modes. This makes it easy to understand how many matches there are in the current buffer for your search query.
(use-package anzu
:defer 10
:config (global-anzu-mode))I usually want lines to wrap at 80 chars (Emacs defaults to 70).
(use-feature simple
:general
(+general-global-toggle
"f" 'auto-fill-mode)
:custom
(eval-expression-debug-on-error nil)
(fill-column 80 "Wrap at 80 columns."))Automatically revert a buffer if its file has changed on disk. This is useful when checking out different versions of a file in version control. It also helps if multiple instances of Emacs are editing the same file.
(use-feature autorevert
:defer 2
:custom
(auto-revert-interval 0.01 "Instantaneously revert")
:config
(global-auto-revert-mode t))(use-package auto-tangle-mode
:ensure (auto-tangle-mode
:host github
:repo "progfolio/auto-tangle-mode.el"
:local-repo "auto-tangle-mode")
:commands (auto-tangle-mode))(use-feature bookmark
:custom (bookmark-fontify nil)
:general
(+general-global-bookmark
"j" 'bookmark-jump
"s" 'bookmark-set
"r" 'bookmark-rename))Buttercup is a behavior-driven development framework for testing Emacs Lisp code.
(use-package buttercup
:commands (buttercup-run-at-point))Completion At Point Extensions
(use-package cape
:commands (cape-file))(use-package cleanroom
:ensure (cleanroom :host github :repo "progfolio/cleanroom" :protocol ssh)
:defer t)(use-feature compile
:commands (compile recompile)
:custom (compilation-scroll-output 'first-error)
:config
(defun +compilation-colorize ()
"Colorize from `compilation-filter-start' to `point'."
(require 'ansi-color)
(let ((inhibit-read-only t))
(ansi-color-apply-on-region (point-min) (point-max))))
(add-hook 'compilation-filter-hook #'+compilation-colorize))Consulting completing-read
(use-package consult
:demand t
:config
(consult-customize
consult-recent-file
consult--source-recent-file
consult--source-buffer
consult--source-bookmark
:preview-key nil)
(global-leader
:major-modes '(org-mode)
:keymaps '(org-mode-map)
"/" 'consult-org-heading)
(global-definer "/" 'consult-line)
(+general-global-buffer "b" 'consult-buffer)
(+general-global-project "a" 'consult-grep)
(+general-global-file
;;"f" 'consult-file
"r" 'consult-recent-file))Completion Overlay Region FUnction
“Corfu enhances completion at point with a small completion popup.”
(use-package corfu
:ensure (corfu :host github :repo "minad/corfu" :files (:defaults "extensions/*"))
:defer 5
:custom
(corfu-cycle t)
(corfu-seperator ?-)
:config
(global-corfu-mode)
(with-eval-after-load 'evil
(setq evil-complete-next-func (lambda (_) (completion-at-point)))))(use-feature cus-edit
:custom
(custom-file null-device "Don't store customizations"))(use-feature dictionary
:defer t
:general
(global-definer "W" 'dictionary-lookup-definition)
(+general-global-application "D" 'dictionary-search)
(+general-global-text "d" 'dictionary-search)
:custom
(dictionary-create-buttons nil)
(dicitonary-use-single-buffer t))Directory browsing commands
(use-feature dired
:commands (dired)
:custom
(dired-listing-switches "-alh" "Human friendly file sizes.")
(dired-kill-when-opening-new-dired-buffer t)
(dired-omit-files "\\(?:\\.+[^z-a]*\\)")
:hook (dired-mode-hook . dired-omit-mode)
:general
(+general-global-application "d" 'dired))doct is a function that provides an alternative, declarative syntax for describing Org capture templates.
(use-package doct
:ensure (doct :branch "development" :protocol ssh :depth nil :autoloads nil)
:commands (doct))A fancy and fast mode-line inspired by minimalism design.
(use-package doom-modeline
:defer 2
:config
(column-number-mode 1)
(doom-modeline-mode)
:custom
(doom-modeline-icon t "Show icons in the modeline"))DOOM Themes is an opinionated UI plugin and pack of themes extracted from [hlissner’s] emacs.d, inspired by some of my favorite color themes.
(use-package doom-themes :ensure (:local-repo "doom-themes") :defer t)This minor mode allows programmers to step through Emacs Lisp source code while executing functions. You can also set breakpoints, trace (stopping at each expression), evaluate expressions as if outside Edebug, reevaluate and display a list of expressions, trap errors normally caught by debug, and display a debug style backtrace.
(use-feature edebug
:config
(global-leader
:major-modes '(emacs-lisp-mode lisp-interaction-mode t)
:keymaps '(emacs-lisp-mode-map lisp-interaction-mode-map)
"d" '(:ignore t :which-key "debug")
"dA" 'edebug-all-defs
"db" '(:ignore t :which-key "breakpoint")
"dbU" 'edebug-unset-breakpoints
"dbc" 'edebug-set-conditional-breakpoint
"dbg" 'edebug-set-global-break-condition
"dbn" 'edebug-next-breakpoint
"dbs" 'edebug-set-breakpoint
"dbt" 'edebug-toggle-disable-breakpoint
"dbu" 'edebug-unset-breakpoint
"dw" 'edebug-where))(use-feature ediff
:defer t
:custom
(ediff-window-setup-function #'ediff-setup-windows-plain)
(ediff-split-window-function #'split-window-horizontally)
:config
(add-hook 'ediff-quit-hook #'winner-undo))Elfeed is an extensible web feed reader for Emacs, supporting both Atom and RSS.
I’ve put my elfeed database in under version control.
I may move it from its default location (~/.elfeed), in elfeed-db-directory.
(use-package elfeed
:commands (elfeed)
:config
(defvar +elfeed-feed-file (expand-file-name "~/Documents/rss-feeds.org"))
(setq elfeed-feeds
(with-current-buffer (find-file-noselect +elfeed-feed-file)
(save-excursion
(save-restriction
(org-fold-show-all)
(goto-char (point-min))
(let ((found nil))
(org-element-map (org-element-parse-buffer) 'link
(lambda (node) (when-let ((props (cadr node))
(standards (plist-get props :standard-properties))
(tags (org-get-tags (aref standards 0)))
((member "elfeed" tags))
((not (member "ignore" tags))))
(push (cons (plist-get props :raw-link)
(delq 'elfeed (mapcar #'intern tags)))
found)))
nil nil t)
(nreverse found))))))
(defun +elfeed-play-in-mpv ()
"Play selected videos in a shared mpv instance in chronological order."
(interactive)
(mapc (lambda (entry)
(emp-open-url (elfeed-entry-link entry))
(message "Playing %S in MPV" (elfeed-entry-title entry)))
(nreverse (elfeed-search-selected)))
(elfeed-search-untag-all-unread))
(defun +elfeed-download ()
"Download selected videos."
(interactive)
(let ((default-directory (expand-file-name "~/Videos/youtube")))
(dolist (entry (nreverse (elfeed-search-selected)))
(let ((title (elfeed-entry-title entry)))
(message "Attempting to download %S" (elfeed-entry-title entry))
(make-process
:name "elfeed-download"
:buffer "elfeed-download"
:command (list "youtube-dl" (elfeed-entry-link entry))
:sentinel (lambda (process _event)
(when (= 0 (process-exit-status process))
(message "Successfully downloaded %S" title))))))
(elfeed-search-untag-all-unread)))
(general-define-key
:states '(normal)
:keymaps 'elfeed-search-mode-map
"p" '+elfeed-play-in-mpv
"d" '+elfeed-download)
(general-define-key
:states '(normal)
:keymaps 'elfeed-show-mode-map
"J" 'elfeed-show-next
"K" 'elfeed-show-prev)
:general (+general-global-application "e" 'elfeed))(use-feature elisp-mode
:config
(global-leader
:major-modes '(emacs-lisp-mode lisp-interaction-mode t)
:keymaps '(emacs-lisp-mode-map lisp-interaction-mode-map)
"e" '(:ignore t :which-key "eval")
"eb" 'eval-buffer
"ed" 'eval-defun
"ee" 'eval-expression
"ep" 'pp-eval-last-sexp
"es" 'eval-last-sexp
"i" 'elisp-index-search))These settings defined in C code, so we use the emacs pseudo-package to set them.
(use-feature emacs
:demand t
:custom
(scroll-conservatively 101 "Scroll just enough to bring text into view")
(enable-recursive-minibuffers t "Allow minibuffer commands in minibuffer")
(frame-title-format '(buffer-file-name "%f" ("%b"))
"Make frame title current file's name.")
(find-library-include-other-files nil)
(indent-tabs-mode nil "Use spaces, not tabs")
(inhibit-startup-screen t)
(history-delete-duplicates t "Don't clutter history")
(pgtk-use-im-context-on-new-connection nil "Prevent GTK from stealing Shift + Space")
(sentence-end-double-space nil "Double space sentence demarcation breaks sentence navigation in Evil")
(tab-stop-list (number-sequence 2 120 2))
(tab-width 2 "Shorter tab widths")
(completion-styles '(flex basic partial-completion emacs22))
(report-emacs-bug-no-explanations t)
(report-emacs-bug-no-confirmation t))Ement.el is a new Matrix client for Emacs. It aims to be simple, fast, featureful, and reliable. ~ https://github.com/alphapapa/ement.el
(use-package ement
:ensure (ement :host github :repo "alphapapa/ement.el" :branch nil)
:commands (ement-connect)
:custom
(ement-room-avatars t)
(ement-room-images t)
(ement-room-compose-method 'compose-buffer)
(ement-room-compose-buffer-window-auto-height-min 10)
(ement-save-sessions t)
(ement-sessions-file "~/.cache/ement.eld.gpg")
:config
(require 'ement-tabulated-room-list)
(add-to-list 'display-buffer-alist
(cons "^\\*Ement compose: "
(cons 'display-buffer-below-selected
'((window-height . 6)
(inhibit-same-window . t)
(reusable-frames . nil)))))
(add-to-list 'display-buffer-alist
'("\\*Ement image:" (display-buffer-reuse-window)
(reusable-frames . nil)))
(define-advice ement-disconnect (:around (fn &rest args) "no-epa-key-prompt")
(let ((epa-file-select-keys 'symmetric)) (apply fn args)))
(define-advice ement--kill-emacs-hook (:around (fn &rest args) "no-epa-key-prompt")
(let ((epa-file-select-keys 'symmetric)) (apply fn args)))
(+general-global-application ;; "c" for chat
"cl" 'ement-room-list
"cn" 'ement-notify-switch-to-notifications-buffer
"cm" 'ement-notify-switch-to-mentions-buffer
"cs" 'ement-directory-search)
:general
(+general-global-application ;; "c" for chat
"c" '(:ignore t :which-key "Matrix")
"ce" '(lambda () (interactive) (call-interactively (if (bound-and-true-p ement-sessions) #'ement-room-list #'ement-connect)))))MPV integration
(use-package emp
:ensure (emp :host github :repo "progfolio/emp")
:config
:general
(+general-global-application
"v" '(:ignore t :which-key "video/audio")
"vQ" 'emp-kill
"vf" '(:ignore t :which-key "frame")
"vfb" 'emp-frame-back-step
"vff" 'emp-frame-step
"vi" 'emp-insert-playback-time
"vo" 'emp-open
"vO" 'emp-cycle-osd
"v SPC" 'emp-pause
"vs" 'emp-seek
"vr" 'emp-revert-seek
"vt" 'emp-seek-absolute
"vv" 'emp-set-context
"vS" 'emp-speed-set))(use-feature epg-config
:defer t
:init (setq epg-pinentry-mode 'loopback))(use-feature epa-file
:defer t
:init (setq epa-file-cache-passphrase-for-symmetric-encryption t))
(use-package epoch
:ensure (epoch :host github :repo "progfolio/epoch")
:after (org)
:commands (epoch-todo epoch-agenda-todo))By default Emacs saves backups in the current buffer’s working directory. I’d rather have everything in one folder to keep my file system tidy.
(use-feature files
;;:hook
;;(before-save . delete-trailing-whitespace)
:config
;; source: http://steve.yegge.googlepages.com/my-dot-emacs-file
(defun rename-file-and-buffer (new-name)
"Renames both current buffer and file it's visiting to NEW-NAME."
(interactive "sNew name: ")
(let ((name (buffer-name))
(filename (buffer-file-name)))
(if (not filename)
(message "Buffer '%s' is not visiting a file." name)
(if (get-buffer new-name)
(message "A buffer named '%s' already exists." new-name)
(progn
(rename-file filename new-name 1)
(rename-buffer new-name)
(set-visited-file-name new-name)
(set-buffer-modified-p nil))))))
:custom
(require-final-newline t "Automatically add newline at end of file")
(backup-by-copying t)
(backup-directory-alist `((".*" . ,(expand-file-name
(concat user-emacs-directory "backups"))))
"Keep backups in their own directory")
(auto-save-file-name-transforms `((".*" ,(concat user-emacs-directory "autosaves/") t)))
(delete-old-versions t)
(kept-new-versions 10)
(kept-old-versions 5)
(version-control t)
(safe-local-variable-values
'((eval load-file "./init-dev.el")
(org-clean-refile-inherit-tags))
"Store safe local variables here instead of in emacs-custom.el"))(use-feature find-func
:defer t
:config (setq find-function-C-source-directory
(expand-file-name "~/repos/emacs/src/")))(use-feature display-fill-column-indicator
:custom
(display-fill-column-indicator-character
(plist-get '( triple-pipe ?┆
double-pipe ?╎
double-bar ?║
solid-block ?█
empty-bullet ?◦)
'triple-pipe))
:general
(+general-global-toggle
"F" '(:ignore t :which-key "fill-column-indicator")
"FF" 'display-fill-column-indicator-mode
"FG" 'global-display-fill-column-indicator-mode))Flycheck is a modern on-the-fly syntax checking extension for GNU Emacs, intended as replacement for the older Flymake extension which is part of GNU Emacs.
(use-package flycheck
:commands (flycheck-mode)
:custom (flycheck-emacs-lisp-load-path 'inherit "necessary with alternatives to package.el"))package-lint integration for flycheck.
(use-package flycheck-package
:after (flychceck)
:config (flycheck-package-setup)
(add-to-list 'display-buffer-alist
'("\\*Flycheck errors\\*" display-buffer-below-selected (window-height . 0.15))))(use-feature flymake
:general
(global-leader
:major-modes '(emacs-lisp-mode lisp-interaction-mode t)
:keymaps '(emacs-lisp-mode-map lisp-interaction-mode-map)
"f" '(:ignore t :which-key "flymake")
"ff" '((lambda () (interactive) (flymake-mode 'toggle)) :which-key "toggle flymake-mode")
"fn" 'flymake-goto-next-error
"fp" 'flymake-goto-prev-error)
:hook (flymake-mode . (lambda () (or (ignore-errors flymake-show-project-diagnostics)
(flymake-show-buffer-diagnostics))))
:config
(add-to-list 'display-buffer-alist
'("\\`\\*Flymake diagnostics.*?\\*\\'"
display-buffer-in-side-window (window-parameters (window-height 0.10)) (side . bottom)))
(defun +flymake-elpaca-bytecomp-load-path ()
"Augment `elisp-flymake-byte-compile-load-path' to support Elpaca."
(setq-local elisp-flymake-byte-compile-load-path
`("./" ,@(mapcar #'file-name-as-directory
(nthcdr 2 (directory-files (expand-file-name "builds" elpaca-directory) 'full))))))
(add-hook 'flymake-mode-hook #'+flymake-elpaca-bytecomp-load-path))(use-package flymake-guile
:defer t
:hook (scheme-mode . flymake-guile))(use-feature flyspell
:commands (flyspell-mode flyspell-prog-mode)
:general
(+general-global-toggle
"ss" 'flyspell-mode
"sp" 'flyspell-prog-mode)
(+general-global-spelling
"n" 'flyspell-goto-next-error
"b" 'flyspell-buffer
"w" 'flyspell-word
"r" 'flyspell-region)
:hook ((org-mode mu4e-compose-mode git-commit-mode) . flyspell-mode))“This package provides functionality for correcting words via custom interfaces.” – https://d12frosted.io/posts/2016-05-09-flyspell-correct-intro.html
(use-package flyspell-correct
:after (flyspell)
:general
(+general-global-spelling
"B" 'flyspell-correct-wrapper
"p" 'flyspell-correct-at-point))Fontify symbols representing faces with that face.
(use-package fontify-face
:commands (fontify-face-mode))Fountain Mode is a screenwriting program for GNU Emacs using the Fountain plain text markup format.
(use-package fountain-mode
:mode "\\.fountain\\'")Work with Git forges from the comfort of Magit
https://github.com/magit/forge
(use-package transient :defer t) ;; Use MELPA until built-in version updated.
(use-package forge
:ensure (:files (:defaults "docs/*"))
:after magit
:init (setq forge-add-default-bindings nil
forge-display-in-status-buffer nil
forge-add-pullreq-refspec nil))(use-package geiser
:defer t
:config
(global-leader
:major-modes '(scheme-mode)
:keymaps '(scheme-mode-map)
"e" '(:ignore t :which-key "eval")
"eb" 'geiser-eval-buffer
"es" 'geiser-eval-last-sexp
"es" 'geiser-eval-region
"i" 'geiser-doc-module
"]" 'geiser-squarify))(use-package geiser-guile :defer t)(use-feature gnus
:defer t
:config
(setq user-mail-address (+email-address +email-dev)
gnus-select-method '(nntp "news.gmane.io")
gnus-use-dribble-file nil
gnus-thread-sort-functions
'(gnus-thread-sort-by-most-recent-date
(not gnus-thread-sort-by-number))
gnus-use-cache t
gnus-interactive-exit nil
gnus-ignored-newsgroups "^to\\.\\|^[0-9. ]+\\( \\|$\\)\\|^[\"]\"[#'()]")
(require 'nnimap)
(add-to-list 'gnus-secondary-select-methods '(nntp "news.gmane.io"))
(add-to-list 'gnus-secondary-select-methods
'(nnimap "gmail"
(nnimap-address "imap.gmail.com")
(nnimap-server-port "imaps")
(nnimap-stream ssl)
(nnir-search-engine imap)
(gnus-topic-set-parameters "gmail" '((display . 200)))
(nnmail-expiry-target "nnimap+gmail:[Gmail]/Trash")
(nnmail-expiry-wait 90))))(use-feature help
:defer 1
:custom
(help-window-select t "Always select the help window"))(use-feature savehist
:defer 1
:config
(savehist-mode 1))I’d like to see holidays and anniversaries in my org-agenda and calendar I’ve removed the default holiday lists that I don’t need.
(use-feature holidays
:commands (org-agenda)
:custom
(holiday-bahai-holidays nil)
(holiday-hebrew-holidays nil)
(holiday-islamic-holidays nil)
(holiday-oriental-holidays nil))This package converts the buffer text and the associated decorations to HTML.
This is necessary for exporting Org files to HTML.
(use-package htmlize
:defer t)Provides a nice interface to evaluating Emacs Lisp expressions. Input is handled by the comint package, and output is passed through the pretty-printer.
ielm.el commentary
(use-feature ielm
:config
(global-leader
:major-modes '(inferior-emacs-lisp-mode)
:keymaps '(inferior-emacs-lisp-mode-map)
"b" '(:ignore t :which-key "buffer")
"bb" 'ielm-change-working-buffer
"bd" 'ielm-display-working-buffer
"bp" 'ielm-print-working-buffer
"c" 'comint-clear-buffer)
;;@TODO: fix this command.
;;This should be easier
:general
(+general-global-application "i"
'("ielm" . (lambda ()
(interactive)
(let* ((b (current-buffer))
(i (format "*ielm<%s>*" b)))
(setq ielm-prompt (concat (buffer-name b) ">"))
(ielm i)
(ielm-change-working-buffer b)
(next-buffer)
(switch-to-buffer-other-window i))))))An expansion of conf-mode to bring proper syntax highlighting to your i3wm config.
(use-package i3wm-config-mode
:ensure (i3wm-config-mode
:host github :repo "Alexander-Miller/i3wm-Config-Mode")
:commands (i3wm-config-mode))Improved JavaScript editing mode for GNU Emacs
(use-package js2-mode
:commands (js2-mode)
:mode "\\.js\\'"
:interpreter (("nodejs" . js2-mode) ("node" . js2-mode)))Need to investigate, but js-mode might have been fixed/updated.
Major mode for Lilypond music engraver.
Installing Lilypond puts these in /usr/share/Emacs/site-lisp, but I plan on editing these.
(use-package lilypond-mode
:ensure (lilypond-mode :host gitlab :repo "lilypond/lilypond"
:remotes (("fork" :host github :repo "progfolio/lilypond" :branch "fix/lilypond-mode" :protocol ssh)
"origin")
:files ("elisp/*.el" "elisp/out/lilypond-words.el")
:protocol ssh
:pre-build (("./autogen.sh" "--noconfigure")
("./configure")
("bash" "-c"
"cd elisp && make && \
echo ';; Local Variables:\n;; no-byte-compile: t\n;; End:' \
>> out/lilypond-words.el")))
:mode "\\.ly\\'"
:general
(global-leader
:major-modes '(lilypond-mode t)
:keymaps '(lilypond-mode-map)
"l" 'lilypond-compile-file
"p" 'lilypond-play))macrostep is an Emacs minor mode for interactively stepping through the expansion of macros in Emacs Lisp source code.
(use-package macrostep
:config
(global-leader
:major-modes '(emacs-lisp-mode lisp-interaction-mode t)
:keymaps '(emacs-lisp-mode-map lisp-interaction-mode-map)
"m" '(:ignore t :which-key "macrostep")
"me" 'macrostep-expand
"mc" 'macrostep-collapse
"mj" 'macrostep-next-macro
"mk" 'macrostep-prev-macro))Magit is an interface to the version control system Git, implemented as an Emacs package.
(use-package magit
:defer t
:after (general)
:custom
(magit-repository-directories (list (cons elpaca-repos-directory 1)))
(magit-diff-refine-hunk 'all)
:general
(+general-global-git/version-control
"b" 'magit-branch
"B" 'magit-blame
"c" 'magit-clone
"f" '(:ignore t :which-key "file")
"ff" 'magit-find-file
"fh" 'magit-log-buffer-file
"i" 'magit-init
"L" 'magit-list-repositories
"m" 'magit-dispatch
"S" 'magit-stage-file
"s" 'magit-status
"U" 'magit-unstage-file)
:config
(transient-bind-q-to-quit))Enrich existing commands with completion annotations
(use-package marginalia
:defer 2
:config (marginalia-mode))markdown-mode is a major mode for editing Markdown-formatted text.
(use-package markdown-mode
:commands (markdown-mode gfm-mode)
:mode
(("README\\.md\\'" . gfm-mode)
("\\.md\\'" . markdown-mode)
("\\.markdown\\'" . markdown-mode))
:custom
(markdown-command "/usr/bin/pandoc"))(use-feature minibuffer
:custom (read-file-name-completion-ignore-case t)
:config
(defun +minibuffer-up-dir ()
"Trim rightmost directory component of `minibuffer-contents'."
(interactive)
(unless (minibufferp) (user-error "Minibuffer not selected"))
(let* ((f (directory-file-name (minibuffer-contents)))
(s (file-name-directory f)))
(delete-minibuffer-contents)
(when s (insert s))))
(define-key minibuffer-local-filename-completion-map
(kbd "C-h") #'+minibuffer-up-dir)
(minibuffer-depth-indicate-mode))A package for miscellaneous functions.
(use-package miscellany
:ensure (miscellany
:host github
:repo "progfolio/miscellany.el"
:local-repo "miscellany"
:branch "master"
:pre-build ((require 'ob-tangle)
(setq org-confirm-babel-evaluate nil)
(org-babel-tangle-file "./miscellany.org")))
:after (general)
:commands (+alternate-buffer
+change-theme
+compute-blood-pressure-table-row
+kill-other-buffers
+org-fix-close-times
+org-remove-timestamp-time
+org-toggle-hide-emphasis-markers
+recompile-user-package-dir
+server-eval-all
+toggle-maximize-buffer
+toggle-relative-lines
+toggle-syntax-highlighting
+universal-arg)
:general
(global-definer
"u" '(+universal-arg :which-key "universal-arg"))
(+general-global-buffer
"a" '(+alternate-buffer :which-key "alternate-buffer")
"q" 'bury-buffer
"m" '(+kill-other-buffers :which-key "kill-other-buffers")
"N" '(+normalize-buffer :which-key "normalize-buffer")
"u" 'unbury-buffer)
(+general-global-window
"f" '(+toggle-maximize-buffer
:which-key "toggle-maximize-buffer"))
(+general-global-toggle
"S" '(+toggle-syntax-highlighting :which-key "syntax-highlighting")
"m" '(+toggle-mode :which-key "mode")
"n" '(+toggle-relative-lines :which-key "relative-lines")
"t" '(:ignore t :which-key "theme")
"tt" '(+change-theme :which-key "toggle-theme")
"tn" '((lambda () (interactive) (+theme-nth 1)) :which-key "theme-next")
"tp" '((lambda () (interactive) (+theme-nth -1)) :which-key "theme-prev")))An emacs-based e-mail client which uses mu as its back-end.
(use-package mu4e
:ensure `(mu4e :host github :files ("mu4e/*.el" "build/mu4e/mu4e-meta.el" "build/mu4e/mu4e-config.el" "build/mu4e/mu4e.info") :repo "djcb/mu"
:main "mu4e/mu4e.el"
:pre-build (("./autogen.sh" "-Dtests=disabled")
("ninja" "-C" "build")
(make-symbolic-link (expand-file-name "./build/mu/mu")
(expand-file-name "~/bin/mu") 'ok-if-exists))
:build (:not elpaca--compile-info)
:post-build (("mu" "init" "--quiet" "--maildir" ,(concat (getenv "HOME") "/Documents/emails")
"--my-address=" ,secret-personal-email-address
"--my-address=" ,secret-work-email-address)
("mu" "--quiet" "index")))
:commands (mu4e mu4e-update-index)
:custom
(mu4e-update-interval 900 "Update every fifteen minutes")
(mail-user-agent 'mu4e-user-agent "Use mu4e as default email program.")
(mu4e-org-support t)
(mu4e-maildir (expand-file-name "~/Documents/emails/"))
(mu4e-attachment-dir "~/Downloads")
(mu4e-completing-read-function 'completing-read)
(mu4e-compose-signature-auto-include nil)
(mu4e-use-fancy-chars t)
(mu4e-view-show-addresses t)
(mu4e-view-show-images t)
(mu4e-sent-messages-behavior 'sent)
(mu4e-get-mail-command "mbsync -c ~/.mbsyncrc -a")
(mu4e-change-filenames-when-moving t "Needed for mbsync")
(mu4e-confirm-quit nil)
(mu4e-html2text-command 'mu4e-shr2text)
(mu4e-context-policy 'pick-first)
(mu4e-compose-context-policy 'always-ask)
:config
(setq mu4e-contexts
(list
(make-mu4e-context
:name "personal"
:enter-func (lambda () (mu4e-message "Entering personal context"))
:leave-func (lambda () (mu4e-message "Leaving personal context"))
:match-func (lambda (msg)
(when msg
(mu4e-message-contact-field-matches
msg '(:from :to :cc :bcc) secret-personal-email-account)))
:vars `((user-mail-address . ,secret-personal-email-address)
(user-full-name . ,secret-personal-email-name)
(mu4e-compose-format-flowed . t)
(message-send-mail-function . smtpmail-send-it)
(smtpmail-smtp-user . ,secret-personal-email-account)
(smtpmail-auth-credentials . (expand-file-name "~/.authinfo.gpg"))
(smtpmail-smtp-server . "smtp.gmail.com")
(smtpmail-smtp-service . 587)
(smtpmail-debug-info . t)
(smtpmail-debug-verbose . t)))
(make-mu4e-context
:name "work"
:enter-func (lambda () (mu4e-message "Entering work context"))
:leave-func (lambda () (mu4e-message "Leaving work context"))
:match-func (lambda (msg)
(when msg
(mu4e-message-contact-field-matches
msg '(:from :to :cc :bcc) secret-work-email-account)))
:vars `((user-mail-address . ,secret-work-email-address)
(user-full-name . ,secret-work-email-name)
(mu4e-compose-format-flowed . t)
(message-send-mail-function . smtpmail-send-it)
(smtpmail-smtp-user . ,secret-work-email-account)
(smtpmail-starttls-credentials . (("smtp.gmail.com" 587 nil nil)))
(smtpmail-auth-credentials . (expand-file-name "~/.authinfo.gpg"))
(smtpmail-default-smtp-server . "smtp.gmail.com")
(smtpmail-smtp-server . "smtp.gmail.com")
(smtpmail-smtp-service . 587)
(smtpmail-debug-info . t)
(smtpmail-debug-verbose . t)))))
(add-to-list 'mu4e-view-actions
'("ViewInBrowser" . mu4e-action-view-in-browser) t)
(add-to-list 'mu4e-bookmarks
'( :name "straight.el"
:query "list:straight.el.radian-software.github.com"
:key ?s)
'append)
(add-to-list 'mu4e-bookmarks
'( :name "Elpaca"
:query "list:elpaca.progfolio.github.com"
:key ?e)
'append)
(defun +mu4e-view-settings ()
"Settings for mu4e-view-mode."
(visual-line-mode)
(olivetti-mode)
(variable-pitch-mode))
(add-hook 'mu4e-view-mode-hook #'+mu4e-view-settings)
;;Fold all threads by default.
;;(add-hook 'mu4e-thread-mode-hook #'mu4e-thread-fold-all)
(global-leader :keymaps '(mu4e-compose-mode-map) "a" 'mml-attach-file)
:general
(+general-global-application "m" 'mu4e :which-key "mail"))Major mode for reading EPUB files in Emacs
(use-package nov
:ensure (nov :depth nil)
:custom
(nov-text-width 80)
:mode
("\\.epub\\'" . nov-mode)
:commands
(nov-mode))This feature tries to help new users by disabling certain potentially destructive or confusing commands. Don’t need it.
(use-feature novice
:custom
(disabled-command-function nil "Enable all commands"))A simple Emacs minor mode for a nice writing environment.
(use-package olivetti
:commands (olivetti-mode))Completion style for matching regexps in any order
(use-package orderless
:defer 1
:custom
(completion-styles '(orderless basic))
(completion-category-overrides '((file (styles partial-completion)))))(use-package org
:ensure (:autoloads "org-loaddefs.el")
:defer t
:general
;;<tab> is for GUI only. TAB maps to C-i on terminals.
(+general-global-application
"o" '(:ignore t :which-key "org")
"oc" 'org-capture
"oC" '+org-capture-again
"oi" 'org-insert-link
"oj" 'org-chronicle
"ok" '(:ignore t :which-key "clock")
"okg" 'org-clock-goto
"oki" 'org-clock-in-last
"okj" 'org-clock-jump-to-current-clock
"oko" 'org-clock-out
"okr" 'org-resolve-clocks
"ol" 'org-store-link
"om" 'org-tags-view
"os" 'org-search-view
"oT" 'org-todo-list
"ot" '(:ignore t :which-key "timer")
"ott" 'org-timer
"otS" 'org-timer-stop
"otC" 'org-timer-change-times-in-region
"otc" 'org-timer-set-timer
"ots" 'org-timer-start
"oti" 'org-timer-item
"otp" 'org-timer-pause-or-continue
"otr" 'org-timer-show-remaining-time)
:config
(general-define-key :states '(normal) :keymaps 'org-mode-map
(kbd "<tab>") 'org-cycle
(kbd "<backtab>") 'org-shifttab)
(general-define-key :states '(normal insert) :keymaps 'org-mode-map
(kbd "M-l") 'org-metaright
(kbd "M-h") 'org-metaleft
(kbd "M-k") 'org-metaup
(kbd "M-j") 'org-metadown
(kbd "M-L") 'org-shiftmetaright
(kbd "M-H") 'org-shiftmetaleft
(kbd "M-K") 'org-shiftmetaup
(kbd "M-J") 'org-shiftmetadown)
(general-define-key :states '(motion) :keymaps 'org-mode-map
(kbd "RET") 'org-open-at-point)
(global-leader
;;for terminals
:keymaps '(org-mode-map)
"TAB" 'org-cycle
"." 'org-time-stamp
"!" 'org-time-stamp-inactive
"<" 'org-date-from-calendar
">" 'org-goto-calendar
"C" '(:ignore t :which-key "clock")
"Cc" 'org-clock-cancel
"Ci" 'org-clock-in
"Co" 'org-clock-out
"Cr" 'org-clock-report
"CR" 'org-resolve-clocks
"d" '(:ignore t :which-key "dates")
"dd" 'org-deadline
"df" '((lambda () (interactive) (+org-fix-close-times))
:which-key "org-fix-close-time")
"ds" 'org-schedule
"di" 'org-time-stamp-inactive
"dt" 'org-time-stamp
"e" '(:ignore t :which-key "export")
"ee" 'org-export-dispatch
"h" '(:ignore t :which-key "heading")
"hf" 'org-forward-heading-same-level
"hb" 'org-backward-heading-same-level
"i" '(:ignore t :which-key "insert")
"id" 'org-insert-drawer
"ie" 'org-set-effort
"if" 'org-footnote-new
"iH" 'org-insert-heading-after-current
"ih" 'org-insert-heading
"ii" 'org-insert-item
"il" 'org-insert-link
"in" 'org-add-note
"ip" 'org-set-property
"is" 'org-insert-structure-template
"it" 'org-set-tags-command
"n" '(:ignore t :which-key "narrow")
"nb" 'org-narrow-to-block
"ne" 'org-narrow-to-element
"ns" 'org-narrow-to-subtree
"nt" 'org-toggle-narrow-to-subtree
"nw" 'widen
"s" '(:ignore t :which-key "trees/subtrees")
"sA" 'org-archive-subtree
"sa" 'org-toggle-archive-tag
"sb" 'org-tree-to-indirect-buffer
"sc" 'org-cut-subtree
"sh" 'org-promote-subtree
"sj" 'org-move-subtree-down
"sk" 'org-move-subtree-up
"sl" 'org-demote-subtree
"sp" '(:ignore t :which-key "priority")
"spu" 'org-priority-up
"spd" 'org-priority-down
"sps" 'org-priority-show
"sm" 'org-match-sparse-tree
"sn" 'org-toggle-narrow-to-subtree
"sr" 'org-refile
"sS" 'org-sort
"ss" '+org-sparse-tree
"t" '(:ignore t :which-key "tables")
"ta" 'org-table-align
"tb" 'org-table-blank-field
"tc" 'org-table-convert
"td" '(:ignore t :which-key "delete")
"tdc" 'org-table-delete-column
"tdr" 'org-table-kill-row
"tE" 'org-table-export
"te" 'org-table-eval-formula
"tH" 'org-table-move-column-left
"th" 'org-table-previous-field
"tI" 'org-table-import
"ti" '(:ignore t :which-key "insert")
"tic" 'org-table-insert-column
"tih" 'org-table-insert-hline
"tiH" 'org-table-hline-and-move
"tir" 'org-table-insert-row
"tJ" 'org-table-move-row-down
"tj" 'org-table-next-row
"tK" 'org-table-move-row-up
"tL" 'org-table-move-column-right
"tl" 'org-table-next-field
"tN" 'org-table-create-with-table.el
"tn" 'org-table-create
"tp" 'org-plot/gnuplot
"tr" 'org-table-recalculate
"ts" 'org-table-sort-lines
"tt" '(:ignore t :which-key "toggle")
"ttf" 'org-table-toggle-formula-debugger
"tto" 'org-table-toggle-coordinate-overlays
"tw" 'org-table-wrap-region
"T" '(:ignore t :which-key "toggle")
"Tc" 'org-toggle-checkbox
"Te" 'org-toggle-pretty-entities
"TE" '+org-toggle-hide-emphasis-markers
"Th" 'org-toggle-heading
"Ti" 'org-toggle-item
"TI" 'org-toggle-inline-images
"Tl" 'org-toggle-link-display
"TT" 'org-todo
"Tt" 'org-show-todo-tree
"Tx" 'org-latex-preview
"RET" 'org-ctrl-c-ret
"#" 'org-update-statistics-cookies
"'" 'org-edit-special
"*" 'org-ctrl-c-star
"-" 'org-ctrl-c-minus
"A" 'org-attach)
(defun +org-sparse-tree (&optional arg type)
(interactive)
(funcall #'org-sparse-tree arg type)
(org-remove-occur-highlights))
(defun +insert-heading-advice (&rest _args)
"Enter insert mode after org-insert-heading. Useful so I can tab to control level of inserted heading."
(when evil-mode (evil-insert 1)))
(advice-add #'org-insert-heading :after #'+insert-heading-advice)
(defun +org-update-cookies ()
(interactive)
(org-update-statistics-cookies "ALL"))
;; Offered a patch to fix this upstream. Too much bikeshedding for such a simple fix.
(defun +org-tags-crm (fn &rest args)
"Workaround for bug which excludes \",\" when reading tags via `completing-read-multiple'.
I offered a patch to fix this, but it was met with too much resistance to be
worth pursuing."
(let ((crm-separator "\\(?:[[:space:]]*[,:][[:space:]]*\\)"))
(unwind-protect (apply fn args)
(advice-remove #'completing-read-multiple #'+org-tags-crm))))
(define-advice org-set-tags-command (:around (fn &rest args) comma-for-crm)
(advice-add #'completing-read-multiple :around #'+org-tags-crm)
(apply fn args))
:custom
;;default:
;;(org-w3m org-bbdb org-bibtex org-docview org-gnus org-info org-irc org-mhe org-rmail)
;;org-toc is interesting, but I'm not sure if I need it.
(org-modules '(org-habit))
(org-todo-keywords
'((sequence "TODO(t)" "STARTED(s!)" "NEXT(n!)" "BLOCKED(b@/!)" "|" "DONE(d)")
(sequence "IDEA(i)" "|" "CANCELED(c@/!)" "DELEGATED(D@/!)")
(sequence "RESEARCH(r)" "|"))
;;move to theme?
org-todo-keyword-faces
`(("CANCELED" . (:foreground "IndianRed1" :weight bold))
("TODO" . (:foreground "#ffddaa"
:weight bold
:background "#202020"
:box (:line-width 3 :width -2 :style released-button)))))
(org-ellipsis (nth 5 '("↴" "˅" "…" " ⬙" " ▽" "▿")))
(org-priority-lowest ?D)
(org-fontify-done-headline t)
(org-M-RET-may-split-line nil "Don't split current line when creating new heading"))(use-feature org-agenda
:after (general evil)
:config
(defun +org-agenda-archives (&optional arg)
"Toggle `org-agenda-archives-mode' so that it includes archive files by default.
Inverts normal logic of ARG."
(interactive "P")
(let ((current-prefix-arg (unless (or org-agenda-archives-mode arg) '(4))))
(call-interactively #'org-agenda-archives-mode)))
(defun +org-agenda-place-point ()
"Place point on first agenda item."
(goto-char (point-min))
(org-agenda-find-same-or-today-or-agenda))
(add-hook 'org-agenda-finalize-hook #'+org-agenda-place-point 90)
(global-leader :keymaps 'org-mode-map "a" 'org-agenda)
:general
<<org-agenda-keybindings>>
:custom
<<org-agenda-custom>>)(+general-global-application
"o#" 'org-agenda-list-stuck-projects
"o/" 'org-occur-in-agenda-files
"oa" '((lambda () (interactive) (org-agenda nil "a")) :which-key "agenda")
"oe" 'org-store-agenda-views
"oo" 'org-agenda)Consider cribbing evilified-state from Spacemacs?
(with-eval-after-load 'org-agenda
(evil-make-intercept-map org-agenda-mode-map)
(general-define-key
:keymaps 'org-agenda-mode-map
;;:states '(emacs normal motion)
"A" '+org-agenda-archives
"C" 'org-agenda-clockreport-mode
"D" 'org-agenda-goto-date
"E" 'epoch-agenda-todo
"H" 'org-habit-toggle-habits
"J" 'org-agenda-next-item
"K" 'org-agenda-previous-item
"R" 'org-agenda-refile
"S" 'org-agenda-schedule
"RET" 'org-agenda-recenter
"a" '+org-capture-again
"c" 'org-agenda-capture
"j" 'org-agenda-next-line
"k" 'org-agenda-previous-line
"m" 'org-agenda-month-view
"t" 'org-agenda-set-tags
"T" 'org-agenda-todo
"u" 'org-agenda-undo))When saving, I want changes to my org-files reflected in any open org agenda buffers.
:config
;;for org-agenda-icon-alist
(evil-set-initial-state 'org-agenda-mode 'normal)
(defun +org-agenda-redo-all ()
"Rebuild all agenda buffers"
(interactive)
(dolist (buffer (buffer-list))
(with-current-buffer buffer
(when (derived-mode-p 'org-agenda-mode)
(org-agenda-maybe-redo)))))
(add-hook 'org-mode-hook
(lambda ()
(add-hook 'after-save-hook '+org-agenda-redo-all nil t)
(setq prettify-symbols-unprettify-at-point 'right-edge)
(setq prettify-symbols-alist
(mapcan (lambda (el) (list el (cons (upcase (car el)) (cdr el))))
'(("#+begin_src" . "λ")
("#+end_src" . "λ")
(":properties:" . "⚙")
(":end:" . "∎")
("#+results:" . "→"))))
(prettify-symbols-mode 1)))(org-agenda-custom-commands
'(("w" "Work Schedule" agenda "+work"
((org-agenda-files '("~/Documents/todo/work.org"))
(org-agenda-span 'week)
(org-mode-hook nil)
(org-agenda-start-on-weekday 2)
(org-agenda-timegrid-use-ampm t)
(org-agenda-time-leading-zero t)
(org-agenda-use-time-grid nil)
(org-agenda-archives-mode t)
(org-agenda-weekend-days '(2 3))
(org-agenda-format-date "%a %m-%d")
(org-agenda-prefix-format '((agenda . " %t")))
(org-agenda-finalize-hook
'((lambda ()
"Format custom agenda command for work schedule."
(save-excursion
(goto-char (point-min))
(while (re-search-forward "TODO Work" nil 'noerror)
(replace-match ""))
(goto-char (point-min))
(forward-line) ;skip header
(while (not (eobp))
(when (get-text-property (point) 'org-agenda-date-header)
(let (fn)
(save-excursion
(forward-line)
(setq fn
(cond ((or (eobp)
(get-text-property (point) 'org-agenda-date-header))
(lambda () (end-of-line) (insert " OFF")))
((get-text-property (point) 'time)
(lambda () (forward-line) (join-line))))))
(funcall fn)))
(forward-line))))))))
("n" "Agenda and all TODOs" ((agenda "") (alltodo "")))))(org-agenda-skip-deadline-prewarning-if-scheduled nil "Show approaching deadlines even when scheduled.")I prefer the agenda to start on the current day view instead of the week. It’s generally faster to generate and usually what I want.
(org-agenda-span 'day)These settings should speed up agenda generation:
(org-agenda-inhibit-startup t)But, I’m not sure about this one. It doesn’t seem to speed things up that much for me and I like to see inherited tags on tasks.
(org-agenda-use-tag-inheritance nil)I find category icons to be a nice visual shorthand that keeps the agenda less cluttered.
(org-agenda-prefix-format '((agenda . " %i %?-12t% s")))
(org-agenda-category-icon-alist
(let ((image-dir (expand-file-name "images/org/" user-emacs-directory))
(categories '(("[Aa]ccounting" "accounting.svg")
("[Bb]irthday" "birthday.svg")
("[Cc]alendar" "calendar.svg")
("[Cc]hore" "chore.svg" :height 25)
("[Ee]xercise" "exercise.svg" :height 24)
("[Ff]ood" "food.svg")
("[Hh]abit" "habit.svg")
("[Hh]ealth" "health.svg")
("[Ii]n" "in.svg")
("[Ll]isten" "listen.svg")
("[Oo]ut" "out.svg")
("[Pp]lay" "play.svg")
("[Rr]efile" "refile.svg")
("[Rr]ead" "read.svg")
("[Ww]atch" "watch.svg")
("[Ww]ork" "work.svg"))))
(mapcar (lambda (category)
(list (nth 0 category)
(expand-file-name (nth 1 category) image-dir)
'svg
nil
:height (or (plist-get category :height) 20)
:ascent (or (plist-get category :ascent) 'center)))
categories)))This sorting strategy will place habits in/next to the agenda time-grid.
(org-agenda-sorting-strategy
'((agenda time-up priority-down category-keep)
(todo priority-down category-keep)
(tags priority-down category-keep)
(search category-keep)))I want the agenda clock report table to skip files that don’t have any time clocked for the current agenda view.
(org-agenda-clockreport-parameter-plist
'(:link t :maxlevel 2 :stepskip0 t :fileskip0 t))I don’t need to see the word “Scheduled” before scheduled items.
(org-agenda-scheduled-leaders '("" "%2dx "))Align tags to column 80 in the agenda view:
(org-agenda-tags-column -80)(use-feature ob-tangle
:after (org)
:custom
(org-src-window-setup 'current-window)
(org-src-preserve-indentation t)
:general
(global-leader :keymaps 'org-mode-map
"b" '(:ignore t :which-key "babel")
"bt" 'org-babel-tangle
"bT" 'org-babel-tangle-file
"be" '(:ignore t :which-key "execute")
"beb" 'org-babel-execute-buffer
"bes" 'org-babel-execute-subtree)
:config
<<org-babel-config>>)I want language specific code block templates. I may use yasnippets for this later to have more flexibility.
(dolist (template '(("f" . "src fountain")
("se" . "src emacs-lisp :lexical t")
("ss" . "src shell")
("sj" . "src javascript")))
(add-to-list 'org-structure-template-alist template))If C-c-c refuses to run code blocks and you get an error message:
“evaluation of language x disabled”
delete the *.el(c) files and restart
(use-feature ob-js
:commands (org-babel-execute:js))
(use-feature ob-python
:commands (org-babel-execute:python))
(use-feature ob-shell
:commands (org-babel-execute:bash
org-babel-execute:shell
org-babel-expand-body:generic)
:config (add-to-list 'org-babel-load-languages '(shell . t))
(org-babel-do-load-languages 'org-babel-load-languages org-babel-load-languages))(use-feature org-capture
:config
(define-advice org-capture-fill-template (:around (fn &rest args) comma-for-crm)
(advice-add #'completing-read-multiple :around #'+org-tags-crm)
(apply fn args))
(add-hook 'org-capture-mode-hook #'evil-insert-state)Utility functions for use inside Org capture templates.
(defun +org-schedule-relative-to-deadline ()
"For use with my appointment capture template. User is first prompted for an
optional deadline. Then an optional schedule time. The scheduled default time is
the deadline. This makes it easier to schedule relative to the deadline using
the -- or ++ operators.
Quitting during either date prompt results in an empty string for that prompt."
(interactive)
(condition-case nil
(org-deadline nil)
(quit nil))
(let ((org-overriding-default-time (or (org-get-deadline-time (point))
org-overriding-default-time)))
(org-schedule nil (org-element-interpret-data
(org-timestamp-from-time
org-overriding-default-time
(and org-overriding-default-time 'with-time))))
(let ((org-log-reschedule nil))
(condition-case nil
(org-schedule nil)
(quit (org-schedule '(4)))))))
(defun +org-capture-again (&optional arg)
"Call `org-capture' with last selected template.
Pass ARG to `org-capture'.
If there is no previous template, call `org-capture'."
(interactive "P")
(org-capture arg (plist-get org-capture-plist :key)))
(defun +org-capture-here ()
"Convenience command to insert a template at point"
(interactive)
(org-capture 0))
(defun +org-capture-property-drawer ()
"Hook function run durning `org-capture-mode-hook'.
If a template has a :properties keyword, add them to the entry."
(when (eq (org-capture-get :type 'local) 'entry)
(when-let ((properties (doct-get :properties t)))
(dolist (property properties)
(org-set-property
(symbol-name (car property))
(replace-regexp-in-string
"\n.*" ""
(org-capture-fill-template
(doct--replace-template-strings (cadr property)))))))))
(defun +org-capture-todo ()
"Set capture entry to TODO automatically"
(org-todo "TODO"))(setq org-capture-templates
(doct `(("Appointment"
:keys "a"
:id "2cd2f75e-b600-4e9b-95eb-6baefeaa61ac"
:properties ((Created "%U"))
:template ("* %^{appointment} %^g" "%?")
:hook (lambda ()
(+org-capture-property-drawer)
(unless org-note-abort (+org-schedule-relative-to-deadline))))
("Account"
:keys "A"
:properties ((Created "%U"))
:template ("* TODO %^{description} %^g" "%?")
:hook +org-capture-property-drawer
:children (("Buy"
:keys "b"
:id "e1dcca6e-6d85-4c8e-b935-d50492b2cc58")
("Borrow"
:keys "B"
:id "a318b8ba-ed1a-4767-84bd-4f45eb409aab"
:template ("* TODO Return %^{description} to %^{person} %^g"
"DEADLINE: %^T"
"%?"))
("Loan"
:keys "l"
:id "cfdd301d-c437-4aae-9738-da022eae8056"
:template ("* TODO Get %^{item} back from %^{person} %^g"
"DEADLINE: %^T"
"%?"))
("Favor"
:keys "f"
:id "9cd02444-2465-4692-958b-f73edacd997f")
("Sell"
:keys "s"
:id "9c4a39c5-3ba6-4665-ac43-67e72f461c15")))
("Bookmark"
:keys "b"
:hook +org-capture-property-drawer
:id "7c20c705-80a3-4f5a-9181-2ea14a18fa75"
:properties ((Created "%U"))
:template ("* [[%x][%^{title}]] %^g" "%?"))
("Health"
:keys "h"
:children (("Blood Pressure"
:keys "b"
:type table-line
:id "4d0c16dd-ce99-4e1b-bf9f-fb10802e48a1"
:template "%(+compute-blood-pressure-table-row)|%?|"
:table-line-pos "II-1")))
("Listen"
:keys "l"
:hook (lambda () (+org-capture-property-drawer) (+org-capture-todo))
:template ("* TODO %^{Title} %^g" "%^{Genre}")
:children (("Audio Book"
:keys "a"
:id "55a01ad5-24f5-40ec-947c-ed0bc507d4e8"
:template "* TODO %^{Title} %^g %^{Author}p %^{Year}p %^{Genre}p")
("Music"
:keys "m"
:id "dc9cfb0f-c65b-4ebe-a082-e751bb3261a6"
:template "%(wikinforg-capture \"album\")")
("Podcast"
:keys "p"
:id "881ee183-37aa-4e76-a5af-5be8446fc346"
:properties ((URL "[[%^{URL}][%^{Description}]]")))
("Radio"
:keys "r"
:id "78da1d3e-c83a-4769-9fb2-91e8ff7ab5da")))
("Note"
:keys "n"
:file ,(defun +org-capture-repo-note-file ()
"Find note for current repository."
(require 'projectile)
(let* ((coding-system-for-write 'utf-8)
;;@MAYBE: extract this to a global variable.
(notedir "~/Documents/devops/repo-notes/")
(project-root (projectile-project-root))
(name (concat (file-name-base (directory-file-name project-root)) ".org"))
(path (expand-file-name name (file-truename notedir))))
(with-current-buffer (find-file-noselect path)
(unless (derived-mode-p 'org-mode) (org-mode)
;;set to utf-8 because we may be visiting raw file
(setq buffer-file-coding-system 'utf-8-unix))
(when-let ((headline (doct-get :headline)))
(unless (org-find-exact-headline-in-buffer headline)
(goto-char (point-max))
(insert "* " headline)
(org-set-tags (downcase headline))))
(unless (file-exists-p path) (write-file path))
path)))
:template (lambda () (concat "* %{todo-state} " (when (y-or-n-p "Link? ") "%A\n") "%?"))
:todo-state "TODO"
:children (("bug" :keys "b" :headline "Bug")
("design" :keys "d" :headline "Design")
("documentation" :keys "D" :headline "Documentation")
("enhancement" :keys "e" :headline "Enhancement" :todo-state "IDEA")
("feature" :keys "f" :headline "Feature" :todo-state "IDEA")
("optimization" :keys "o" :headline "Optimization")
("miscellaneous" :keys "m" :headline "Miscellaneous")
("security" :keys "s" :headline "Security")))
("Play"
:keys "p"
:id "be517275-3779-477f-93cb-ebfe0204b614"
:hook +org-capture-todo
:template "%(wikinforg-capture \"game\")")
("Read"
:keys "r"
:template "%(wikinforg-capture \"book\")"
:hook +org-capture-todo
:children (("fiction"
:keys "f"
:id "0be106fc-a920-4ab3-8585-77ce3fb793e8")
("non-fiction"
:keys "n"
:id "73c29c94-fb19-4012-ab33-f51158c0e59b")))
("Say"
:keys "s"
:children (("word" :keys "w"
:id "55e43a15-5523-49a6-b16c-b6fbae337f05"
:template ("* %^{Word}" "%?"))
("Phrase" :keys "p"
:id "c3dabe22-db69-423a-9737-f90bfc47238a"
:template ("* %^{Phrase}" "%?"))
("Quote" :keys "q"
:id "8825807d-9662-4d6c-a28f-6392d3c4dbe2"
:template ("* %^{Quote}" "%^{Quotee}p"))))
("Todo" :keys "t"
:id "0aeb95eb-25ee-44de-9ef5-2698514f6208"
:hook (lambda ()
(+org-capture-property-drawer)
;;swallow org-todo quit so we don't abort the whole capture
(condition-case nil (org-todo) (quit nil)))
:properties ((Created "%U"))
:template ("* %^{description} %^g" "%?"))
("use-package" :keys "u"
:file ,(expand-file-name "init.org" user-emacs-directory)
:function
,(defun +org-capture-use-package-form ()
"place point for use-package capture template."
(org-fold-show-all)
(goto-char (org-find-entry-with-id "f8affafe-3a4c-490c-a066-006aeb76f628"))
(org-narrow-to-subtree)
;;popping off parent headline, evil and general.el since they are order dependent.
(when-let* ((name (read-string "package name: "))
(headlines (nthcdr 4 (caddr (org-element-parse-buffer 'headline 'visible))))
(packages (mapcar (lambda (headline) (cons (plist-get (cadr headline) :raw-value)
(plist-get (cadr headline) :contents-end)))
headlines))
(target (let ((n (downcase name)))
(cdr
(cl-some (lambda (package) (and (string-greaterp n (downcase (car package))) package))
(nreverse packages))))))
;;put name on template's doct plist
(setq org-capture-plist
(plist-put org-capture-plist :doct
(plist-put (org-capture-get :doct) :use-package name)))
(goto-char target)
(org-end-of-subtree)
(open-line 1)
(forward-line 1)))
:type plain
:empty-lines-after 1
:template ("** %(doct-get :use-package)"
"#+begin_quote"
"%(read-string \"package description:\")"
"#+end_quote"
"#+begin_src emacs-lisp"
"(use-package %(doct-get :use-package)%?)"
"#+end_src"))
("Watch":keys "w"
:template "%(wikinforg-capture \"%{entity}\")"
:hook +org-capture-todo
:children (("Film" :keys "f" :id "a730a2db-7033-40af-82c1-9b73528ab7d9" :entity "film")
("TV" :keys "t" :id "4a18a50e-909e-4d36-aa7a-b09e8c3b01f8" :entity "show")
("Presentation" :keys "p" :id "343fe4f4-867a-4033-b31a-8b57aba0345e"
:template "* %^{Title} %^g %^{Year}p"))))))make-capture-frame cobbled together from:
- http://cestlaz.github.io/posts/using-emacs-24-capture-2/
- https://stackoverflow.com/questions/23517372/hook-or-advice-when-aborting-org-capture-before-template-selection
Don’t use this within Emacs. Rather, invoke it when connecting an Emacs client to a server with:
emacsclient --create-frame \
--socket-name 'capture' \
--alternate-editor='' \
--frame-parameters='(quote (name . "capture"))' \
--no-wait \
--eval "(+org-capture-make-frame)"
(defun +org-capture-delete-frame (&rest _args)
"Delete frame with a name frame-parameter set to \"capture\""
(when (and (daemonp) (string= (frame-parameter (selected-frame) 'name) "capture"))
(delete-frame)))
(add-hook 'org-capture-after-finalize-hook #'+org-capture-delete-frame 100)(defun +org-capture-make-frame ()
"Create a new frame and run org-capture."
(interactive)
(select-frame-by-name "capture")
(delete-other-windows)
(cl-letf (((symbol-function 'switch-to-buffer-other-window) #'switch-to-buffer))
(condition-case err
(org-capture)
;; "q" signals (error "Abort") in `org-capture'
;; delete the newly created frame in this scenario.
(user-error (when (string= (cadr err) "Abort") (delete-frame)))))):commands (+org-capture-make-frame)
:general
(:states 'normal
:keymaps 'org-capture-mode-map
",c" 'org-capture-finalize
",k" 'org-capture-kill
",r" 'org-capture-refile):custom
(org-capture-dir (concat (getenv "HOME") "/Documents/todo/")))(use-package org-chronicle
:ensure (:host github :repo "progfolio/org-chronicle")
:commands (org-chronicle)
:custom (org-chronicle-directory "~/Documents/journal/")
(org-chronicle-file-format-string "%Y.%m.%d"))(use-package org-clean-refile
:ensure (org-clean-refile :host github :repo "progfolio/org-clean-refile" :protocol ssh)
:commands (org-clean-refile)
:after (org)
:general
(global-leader
:keymaps 'org-mode-map
"sr" 'org-clean-refile))(use-package org-contrib)A minor mode that displays org priorities as custom strings.
(use-package org-fancy-priorities
:commands (org-fancy-priorities-mode)
:hook (org-mode . org-fancy-priorities-mode)
:config
;;"Eisenhower Matrix of Importance and Urgency"
(defvar +org-fancy-priorities-eisenhower-matrix
"↑ |-----------+-----------|
I | Eisenhower Matrix |
M |-----------+-----------|
P | | |
O | Schedule | Immediate |
R | | |
T |-----------+-----------|
A | | |
N | Eliminate | Delegate |
C | | |
E |-----------+-----------|
URGENCY →"
"Eisenhower Matrix help text.")
(setq org-fancy-priorities-list
(mapcar
(lambda (cell) (format (car cell)
(propertize
(cdr cell)
'help-echo +org-fancy-priorities-eisenhower-matrix)))
'(("I∧U (%s)" . "I")
("I¬U (%s)" . "S")
("¬IU (%s)" . "D")
("¬I¬U (%s)" . "E")))))(use-feature org-habit
:after (org)
:config
(defun +org-habit-graph-on-own-line (graph)
"Place org habit consitency graph below the habit."
(let* ((count 0)
icon)
(save-excursion
(beginning-of-line)
(while (and (eq (char-after) ? ) (not (eolp)))
(when (get-text-property (point) 'display) (setq icon t))
(setq count (1+ count))
(forward-char)))
(add-text-properties (+ (line-beginning-position) count) (line-end-position)
`(display ,(concat (unless icon " ")
(string-trim-left (thing-at-point 'line))
(make-string (or org-habit-graph-column 0) ? )
(string-trim-right
(propertize graph 'mouse-face 'inherit)))))))
<<org-habit-graph-placement-advice>>
:custom
<<org-habit-custom>>)
(integerp nil)(org-habit-today-glyph #x1f4c5)
(org-habit-completed-glyph #x2713)
(org-habit-preceding-days 29)
(org-habit-following-days 1)
(org-habit-graph-column 3)
(org-habit-show-habits-only-for-today nil)(defun +org-habit-insert-consistency-graphs (&optional line)
"Insert consistency graph for any habitual tasks."
(let ((inhibit-read-only t)
(buffer-invisibility-spec '(org-link))
(moment (time-subtract nil (* 3600 org-extend-today-until))))
(save-excursion
(goto-char (if line (line-beginning-position) (point-min)))
(while (not (eobp))
(let ((habit (get-text-property (point) 'org-habit-p)))
(when habit
(let ((graph (org-habit-build-graph
habit
(time-subtract moment (days-to-time org-habit-preceding-days))
moment
(time-add moment (days-to-time org-habit-following-days)))))
(+org-habit-graph-on-own-line graph))))
(forward-line)))))
(advice-add #'org-habit-insert-consistency-graphs
:override #'+org-habit-insert-consistency-graphs)(use-feature org-indent
:after (org)
:hook (org-mode . org-indent-mode)
:config
(define-advice org-indent-refresh-maybe (:around (fn &rest args) "when-buffer-visible")
"Only refresh indentation when buffer's window is visible.
Speeds up `org-agenda' remote operations."
(when (get-buffer-window (current-buffer) t) (apply fn args))))This function allows me to refile within the currently open org files as well as agenda files. Useful for structural editing. Stolen from: stackoverflow: how to org-refile to a target within the current file?
(defun +org-files-list ()
"Returns a list of the file names for currently open Org files"
(delq nil
(mapcar (lambda (buffer)
(when-let* ((file-name (buffer-file-name buffer))
(directory (file-name-directory file-name)))
(unless (string-suffix-p "archives/" directory)
file-name)))
(org-buffer-list 'files t))))(setq +org-max-refile-level 20)
(setq org-outline-path-complete-in-steps nil
org-refile-allow-creating-parent-nodes 'confirm
org-refile-use-outline-path 'file
org-refile-targets `((org-agenda-files :maxlevel . ,+org-max-refile-level)
(+org-files-list :maxlevel . ,+org-max-refile-level)))(setq org-agenda-files '("~/Documents/todo")
org-agenda-text-search-extra-files '(agenda-archives)
org-fold-catch-invisible-edits 'show-and-error
org-confirm-babel-evaluate nil
org-enforce-todo-dependencies t
org-hide-emphasis-markers t
org-hierarchical-todo-statistics nil
org-log-done 'time
org-log-reschedule t
org-return-follows-link t
org-reverse-note-order t
org-src-tab-acts-natively t
org-file-apps
'((auto-mode . emacs)
("\\.mm\\'" . default)
("\\.mp[[:digit:]]\\'" . "/usr/bin/mpv --force-window=yes %s")
;;("\\.x?html?\\'" . "/usr/bin/firefox-beta %s")
("\\.x?html?\\'" . "/usr/bin/bash -c '$BROWSER %s'")
("\\.pdf\\'" . default)))Set clock report duration format to floating point hours
;;(setq org-duration-format '(h:mm))
(setq org-duration-format '(("h" . nil) (special . 2)))This package makes it easy to have one or more customizable tables of contents in Org files. They can be updated manually, or automatically when the file is saved. Links to headings are created compatible with GitHub’s Org renderer.
(use-package org-make-toc
:commands (org-make-toc))org-mime can be used to send HTML email using Org-mode HTML export.
(use-package org-mime
:after (org)
:commands (org-mime-htmlize
org-mime-org-buffer-htmlize
org-mime-org-subtree-htmlize)
:config
(setq org-mime-export-options '( :with-latex dvipng
:section-numbers nil
:with-author nil
:with-toc nil)))“Modern looks for Org”
(use-package org-modern :after (org)
:config
(global-org-modern-mode)
(remove-hook 'org-agenda-finalize-hook 'org-modern-agenda))(use-package org-region-link
:ensure (org-region-link :host github :repo "progfolio/org-region-link" :protocol ssh)
:after (org))(use-package org-roam
:ensure (org-roam :host github :repo "org-roam/org-roam")
:disabled t
:general
(+general-global-application
"or" '(:ignore t :which-key "org-roam-setup"))
:init (setq org-roam-v2-ack t))(use-package org-relativity
:after (org)
:ensure (:host github :repo "progfolio/org-relativity"))Prettify headings and plain lists in Org mode. This package is a direct descendant of ‘org-bullets’
(use-package org-superstar
:ensure (org-superstar :host github :repo "integral-dw/org-superstar-mode")
:after (org))Github flavored Markdown back-end for Org export engine
(use-package ox-gfm :defer t)Export org-mode docs as HTML compatible with Twitter Bootstrap.
(use-package ox-twbs
:disabled t
:after (org)
:defer t)This library provides a linter for the metadata in Emacs Lisp files which are intended to be packages. You can integrate it into your build process.
(use-package package-lint
:defer t
:commands (package-lint-current-buffer +package-lint-elpaca)
:config
<<+package-lint-elpaca>>)(defun +package-lint-elpaca ()
"Help package-lint deal with elpaca."
(interactive)
(require 'package)
(setq package-user-dir "/tmp/elpa")
(add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t)
(package-initialize)
(package-refresh-contents))
(+package-lint-elpaca)I want to have matching delimiters highlighted when point is on them so that I can make sure they’re balanced easily.
(use-feature paren
:defer 1
:config (show-paren-mode))Projectile is a project interaction library for Emacs. Its goal is to provide a nice set of features operating on a project level without introducing external dependencies (when feasible).
(use-package projectile
:after (general)
:general
(+general-global-project
"!" 'projectile-run-shell-command-in-root
"%" 'projectile-replace-regexp
"&" 'projectile-run-async-shell-command-in-root
"A" 'projectile-toggle-between-implementation-and-test
"bn" 'projectile-next-project-buffer
"bp" 'projectile-previous-project-buffer
"c" 'projectile-compile-project
"D" 'projectile-dired
"e" 'projectile-edit-dir-locals
"g" 'projectile-find-tag
"G" 'projectile-regenerate-tags
"I" 'projectile-invalidate-cache
"k" 'projectile-kill-buffers
"R" 'projectile-replace
"s" 'projectile-save-project-buffers
"T" 'projectile-test-project
"v" 'projectile-vc)
:config
(add-to-list 'projectile-globally-ignored-directories "*node_modules")
(projectile-mode))PDF Tools is, among other things, a replacement of DocView for PDF files. The key difference is that pages are not pre-rendered by e.g. ghostscript and stored in the file-system, but rather created on-demand and stored in memory.
This allows me to customize the color of the generated pdf.
(use-package pdf-tools
:ensure (pdf-tools :pre-build ("./server/autobuild") :files (:defaults "server/epdfinfo"))
:functions (pdf-isearch-batch-mode)
:commands (pdf-tools-install pdf-view-mode)
:custom (pdf-view-midnight-colors '("#AFA27C" . "#0F0E16"))
:config (add-hook 'pdf-view-mode-hook
(lambda ()
;; get rid of borders on pdf's edges
(set (make-local-variable 'evil-normal-state-cursor) (list nil))
;;for fast i-search in pdf buffers
(pdf-isearch-minor-mode)
(pdf-isearch-batch-mode)
(pdf-view-dark-minor-mode)
(pdf-view-midnight-minor-mode)))
:mode (("\\.pdf\\'" . pdf-view-mode)))Colorize color names in buffers
(use-package rainbow-mode
:commands (rainbow-mode))Emacs has a horrible regexp syntax. A tool called re-builder allows you to live preview regular expressions. This variable reduces some of the escaping necessary when building regular expressions.
(use-feature re-builder
:custom
(reb-re-syntax 'rx)
:commands (re-builder))I want to have more recent files saved. This was originally set to ten, but opening my org agenda files wipes that list out.
(use-feature recentf
:defer 1
:config (recentf-mode)
:custom
(recentf-max-menu-items 1000 "Offer more recent files in menu")
(recentf-max-saved-items 1000 "Save more recent files"))(use-feature sendmail
:defer t
:custom (send-mail-function 'smtpmail-send-it "inform emacs-bug-report how we want to send mail"))(use-feature shr-color
:custom
(shr-color-visible-luminance-min 85 "For clearer email/eww rendering of bg/fg colors")
(shr-use-colors nil "Don't use colors (for HTML email legibility)"))(use-feature smtpmail
:custom
(smtpmail-queue-mail nil))(elpaca (straight.el :host github
:depth nil
:repo "radian-software/straight.el"
:branch "develop"
:files ("straight*.el")
:protocol ssh
:remotes ("origin"
("fork" :repo "progfolio/straight.el"))))(use-feature tab-bar
:custom
(tab-bar-close-button-show nil "Dont' show the x button on tabs")
(tab-bar-new-button-show nil)
(tab-bar-show 1 "only show tab bar when more than one tab")
:general
(+general-global-tab
"b" 'tab-bar-history-back
"d" 'tab-bar-close-tab
"f" 'tab-bar-history-forward
"N" 'tab-bar-new-tab
"n" 'tab-bar-switch-to-next-tab
"p" 'tab-bar-switch-to-prev-tab
"L" '((lambda (arg) (interactive "p") (tab-bar-move-tab arg))
:which-key "tab-bar-move-tab-right")
"l" 'tab-bar-switch-to-next-tab
"H" '((lambda (arg) (interactive "p") (tab-bar-move-tab (- arg)))
:which-key "tab-bar-move-tab-left")
"h" 'tab-bar-switch-to-prev-tab
"r" 'tab-bar-rename-tab
"t" 'tab-bar-switch-to-tab
"u" 'tab-bar-undo-close-tab
"O" 'tab-bar-close-other-tabs
"w" 'tab-bar-move-tab-to-frame))
(use-feature tab-line
:custom
(tab-line-close-button-show nil)
(tab-line-new-button-show nil))Tern is a stand-alone, editor-independent JavaScript analyzer that can be used to improve the JavaScript integration of existing editors.
(use-package tern
:disabled t
:commands (tern-mode)
:hook (js2-mode . tern-mode))(use-package joymacs
:ensure (joymacs :host github :repo "skeeto/joymacs"
:main "joydemo.el"
:pre-build ("make")
:files (:defaults "joymacs.c" "joymacs.so")
:remotes (("fork" :repo "progfolio/joymacs")
"origin"))
:defer t)(use-package padscape
:ensure (padscape :host github :repo "progfolio/padscape" :protocol ssh)
:commands (padscape)
:config
(add-to-list 'display-buffer-alist '("\\*padscape\\*" display-buffer-below-selected
(window-height . 0.20))))(use-package speedo
:ensure (speedo :host github :repo "progfolio/speedo"
:depth nil :protocol ssh
:files (:defaults "test"))
:commands (speedo speedo-load-file akogare)
:custom
(speedo-directory "~/.emacs.d/elpaca/repos/speedo/test/")
(speedo-default-splits-file "./Akogare-Mario-World.spd")
(speedo-confirm-evaluate nil)
:general
(+general-global-application
"s" '(:ignore t :which-key "speedo")
"ss" 'speedo
"sl" 'speedo-load-file)
:config
(defun akogare ()
(interactive)
(speedo)
(tab-bar-mode -1)
(padscape))
(evil-make-intercept-map speedo-mode-map)
(defvar +speedo-debounce-interval 0.5)
(defvar +speedo-debounce-timer nil)
(defun +speedo-debounced-mistake (advised)
"Execute `speedo-mistake' after last key press.
This allows me to spam the button to get through the retry screen
as fast as possible without recording multiple mistakes."
(when +speedo-debounce-timer (cancel-timer +speedo-debounce-timer))
(setq +speedo-debounce-timer (run-at-time +speedo-debounce-interval nil advised)))
(advice-add 'speedo-mistake :around #'+speedo-debounced-mistake)
(defun +speedo-ensure-controller-support ()
"Launch controller program if it isn't already running."
(interactive)
(when (string-empty-p (shell-command-to-string "pgrep antimicrox"))
(make-process
:name "antimicrox"
:noquery t ; Don't ask to kill this process when exiting Emacs.
:buffer "*antimicrox*"
:command '("antimicrox" "--tray"))))
(add-hook 'speedo-mode-hook #'+speedo-ensure-controller-support))
(use-feature speedo-review
:defer t
:general
(+general-global-application
"sr" '(:ignore t :which-key "review")
"srr" 'speedo-review
"srt" 'speedo-review-top-runs
"srl" '(:ignore t :which-key "review-last")
"srlr" 'speedo-review-last-runs
"srla" 'speedo-review-last-attempts)
:config
(evil-make-intercept-map speedo-review-mode-map))
(use-feature speedo-edit
:defer t
:config
(evil-make-intercept-map speedo-edit-mode-map))I like to see the date and time in my mode line. I use doom-modeline for the rest of my mode line configuration.
(use-feature time
:custom
(display-time-day-and-date t "Show date, day, and time")
:config
(display-time))(use-feature tramp
:defer t
:custom (tramp-terminal-type "tramp")
:config (setq debug-ignored-errors (cons 'remote-file-error debug-ignored-errors)))(use-package typst-ts-mode
:ensure (:type git :host sourcehut :repo "meow_king/typst-ts-mode")
:custom
(typst-ts-mode-watch-options "--open")
(typst-ts-mode-enable-raw-blocks-highlight t)
(typst-ts-mode-highlight-raw-blocks-at-startup t))You probably want this 99% of the time and it will skip an annoying prompt.
(use-feature vc-hooks
:custom
(vc-follow-symlinks t "Visit real file when editing a symlink without prompting."))VERTical Interactive COmpletion
(use-package vertico
:demand t
:custom (vertico-cycle t)
:config
(setf (car vertico-multiline) "\n") ;; don't replace newlines
(vertico-mode)
(define-key vertico-map (kbd "C-h") #'+minibuffer-up-dir))Emacs-libvterm (vterm) is fully-fledged terminal emulator inside GNU Emacs based on libvterm, a C library.
(use-package vterm
:ensure (vterm :post-build
(progn
(setq vterm-always-compile-module t)
(require 'vterm)
;;print compilation info for elpaca
(with-current-buffer (get-buffer-create vterm-install-buffer-name)
(goto-char (point-min))
(while (not (eobp))
(message "%S"
(buffer-substring (line-beginning-position)
(line-end-position)))
(forward-line)))
(when-let ((so (expand-file-name "./vterm-module.so"))
((file-exists-p so)))
(make-symbolic-link
so (expand-file-name (file-name-nondirectory so)
"../../builds/vterm")
'ok-if-already-exists))))
:commands (vterm vterm-other-window)
:general
(+general-global-application
"t" '(:ignore t :which-key "terminal")
"tt" 'vterm-other-window
"t." 'vterm)
:config
(evil-set-initial-state 'vterm-mode 'emacs))which-key is a minor mode for Emacs that displays the key bindings following your currently entered incomplete command (a prefix) in a popup.
(use-package which-key
:demand t
:init
(setq which-key-enable-extended-define-key t)
:config
(which-key-mode)
:custom
(which-key-side-window-location 'bottom)
(which-key-sort-order 'which-key-key-order-alpha)
(which-key-side-window-max-width 0.33)
(which-key-idle-delay 0.2))(use-package wikinfo
:ensure (wikinfo :host github :repo "progfolio/wikinfo"
:branch "develop" :protocol ssh :depth nil)
:defer t)(use-package wikinforg
:ensure (wikinforg :host github :repo "progfolio/wikinforg"
:protocol ssh :depth nil)
:commands (wikinforg wikinforg-capture)
:custom
(wikinforg-include-thumbnail t)
(wikinforg-post-insert-hook '(org-redisplay-inline-images))
(wikinforg-thumbnail-directory
(expand-file-name "wikinforg" user-emacs-directory))
:config
(add-hook 'wikinforg-mode-hook #'visual-line-mode)
(add-hook 'wikinforg-mode-hook #'olivetti-mode)
(add-hook 'wikinforg-mode-hook (lambda () (writegood-mode -1)))
;; So we can bury temp buffers without evil bindings taking precedence
(evil-make-intercept-map wikinforg-mode-map))(use-feature winner
:defer 5
:config
(+general-global-window
"u" 'winner-undo
"r" 'winner-redo)
(winner-mode))(use-feature window
:custom
(switch-to-buffer-obey-display-actions t)
(switch-to-prev-buffer-skip-regexp
'("\\*Help\\*" "\\*Calendar\\*" "\\*mu4e-last-update\\*"
"\\*Messages\\*" "\\*scratch\\*" "\\magit-.*")))(use-package wordel
:ensure (wordel :host github :repo "progfolio/wordel"
:files (:defaults "words") :depth nil :protocol ssh)
:defer t
:config
(evil-make-intercept-map wordel-mode-map)
(evil-set-initial-state 'wordel-mode 'insert)
(evil-make-intercept-map wordel-select-mode-map)
(evil-set-initial-state 'wordel-select-mode 'insert))This is a minor mode to aid in finding common writing problems.
(use-package writegood-mode
:commands (writegood-mode)
:hook (org-mode))YASnippet is a template system for Emacs. It allows you to type an abbreviation and automatically expand it into function templates.
(use-package yasnippet
:commands (yas-global-mode)
:custom
(yas-snippet-dirs '("~/.emacs.d/snippets")))A dark theme for Emacs, inspired from Niflheim and One Dark
(use-package zerodark-theme :defer t)(use-package yodel
:ensure (yodel :host github :repo "progfolio/yodel" :depth nil :protocol ssh)
:defer t)(use-package spiel
:ensure (spiel :host github :repo "progfolio/spiel" :depth nil :protocol ssh)
:defer t
:hook (spiel-mode . (lambda () (olivetti-mode 1)))
:config
(with-eval-after-load "evil"
(evil-make-intercept-map spiel-mode-map)
(when (fboundp 'evil-set-initial-state)
(evil-set-initial-state 'spiel-mode 'insert))))(use-package greg
:defer t
:ensure (greg :host github :repo "progfolio/greg"
:depth nil :protocol ssh
:files (:defaults "assets" "objects")))(use-package redact
:defer t
:ensure (:host github :repo "progfolio/redact" :depth nil :protocol ssh))(use-package subp
:defer t
:ensure (:host github :repo "progfolio/subp"))(use-package helpa
:defer t
:ensure (:host github :main nil :build (:not elpaca--generate-autoloads-async) :repo "progfolio/HELPA" :depth nil :protocol ssh))(use-package tunic
:ensure (:repo "~/elisp/tunic/")
:defer t
:config
(evil-make-intercept-map tunic-mode-map)
(evil-make-intercept-map tunic-decoder-mode-map))(use-package mel
:ensure (:host github :repo "progfolio/mel" :protocol ssh))