1 #+TITLE: System Configuration
2 #+DESCRIPTION: Personal system configuration in org-mode format.
3 #+AUTHOR: Armaan Bhojwani
4 #+EMAIL: me@armaanb.net
7 Welcome to my system configuration! This file contains my Emacs configuration, but also my config files for many of the other programs on my system!
9 I am currently using Emacs 27.2 on Linux, so some settings and packages may not be available for older versions of Emacs. This is a purely personal configuration, so while I can guarantee that it works on my setup, it might not work for you.
11 I chose to create a powerful, yet not overly heavy Emacs configuration. Things like a fancy modeline, icons, or LSP mode do not increase my productivity, and create visual clutter, and thus have been excluded.
13 Another important choice has been to integrate Emacs into a large part of my computing environment (see [[*Emacs OS]]). I use email, IRC, RSS, et cetera, all through Emacs which simplifies my workflow and creates an amazingly integrated environment.
15 Lastly, I use Evil mode. Modal keybindings are simpler and more ergonomic than standard Emacs style, and Vim keybindings are what I'm comfortable with and are pervasive throughout computing.
17 Released under the [[https://opensource.org/licenses/MIT][MIT license]] by Armaan Bhojwani, 2021. Note that many snippets are taken from online, and other sources, who are credited for their work near their contributions.
19 ** Bootstrap straight.el
20 straight.el is really nice for managing package, and it integrates nicely with use-package. It uses the bootstrapping system defined here for installation.
21 #+begin_src emacs-lisp
22 (defvar native-comp-deferred-compilation-deny-list ())
23 (defvar bootstrap-version)
25 (expand-file-name "straight/repos/straight.el/bootstrap.el" user-emacs-directory))
26 (bootstrap-version 5))
27 (unless (file-exists-p bootstrap-file)
29 (url-retrieve-synchronously
30 "https://raw.githubusercontent.com/raxod502/straight.el/develop/install.el"
31 'silent 'inhibit-cookies)
32 (goto-char (point-max))
33 (eval-print-last-sexp)))
34 (load bootstrap-file nil 'nomessage))
36 ** Replace package.el with straight
37 #+begin_src emacs-lisp
38 (straight-use-package 'use-package)
39 (setq straight-use-package-by-default t)
43 Use the Modus Operandi theme by Protesilaos Stavrou. Its the best theme for Emacs by far, because how clear and readable it is. It is highly customizable, but I just set a few options here.
44 #+begin_src emacs-lisp
45 (use-package modus-themes
47 (modus-themes-slanted-constructs t)
48 (modus-themes-bold-constructs t)
49 (modus-themes-mode-line '3d)
50 (modus-themes-scale-headings t)
51 (modus-themes-diffs 'desaturated)
52 :config (load-theme 'modus-vivendi t))
56 JetBrains Mono is a great programming font with ligatures. The "NF" means that it has been patched with the [[https://www.nerdfonts.com/][Nerd Fonts]].
57 #+begin_src emacs-lisp
58 (add-to-list 'default-frame-alist '(font . "JetBrainsMonoNF-12"))
61 #+begin_src emacs-lisp
63 :straight (ligature :type git :host github :repo "mickeynp/ligature.el")
65 (ligature-set-ligatures
66 '(prog-mode text-mode)
67 '("-|" "-~" "---" "-<<" "-<" "--" "->" "->>" "-->" "/=" "/=="
68 "/>" "//" "/*" "*>" "*/" "<-" "<<-" "<=>" "<=" "<|" "<||"
69 "<|||" "<|>" "<:" "<>" "<-<" "<<<" "<==" "<<=" "<=<" "<==>"
70 "<-|" "<<" "<~>" "<=|" "<~~" "<~" "<$>" "<$" "<+>" "<+" "</>"
71 "</" "<*" "<*>" "<->" "<!--" ":>" ":<" ":::" "::" ":?" ":?>"
72 ":=" "::=" "=>>" "==>" "=/=" "=!=" "=>" "===" "=:=" "==" "!=="
73 "!!" "!=" ">]" ">:" ">>-" ">>=" ">=>" ">>>" ">-" ">=" "&&&"
74 "&&" "|||>" "||>" "|>" "|]" "|}" "|=>" "|->" "|=" "||-" "|-"
75 "||=" "||" ".." ".?" ".=" ".-" "..<" "..." "+++" "+>" "++"
76 "[||]" "[<" "[|" "{|" "?." "?=" "?:" "##" "###" "####" "#["
77 "#{" "#=" "#!" "#:" "#_(" "#_" "#?" "#(" ";;" "_|_" "__" "~~"
78 "~~>" "~>" "~-" "~@" "$>" "^=" "]#"))
79 ;; (global-ligature-mode t))
83 Display relative line numbers except in certain modes.
84 #+begin_src emacs-lisp
85 (global-display-line-numbers-mode)
86 (setq display-line-numbers-type 'relative)
87 (dolist (no-line-num '(term-mode-hook
93 (add-hook no-line-num (lambda () (display-line-numbers-mode 0))))
95 ** Highlight matching parenthesis
96 #+begin_src emacs-lisp
98 :config (show-paren-mode)
99 :custom (show-paren-style 'parenthesis))
102 *** Show current function
103 #+begin_src emacs-lisp
104 (which-function-mode)
106 *** Make position in file more descriptive
107 Show current column and file size.
108 #+begin_src emacs-lisp
110 (size-indication-mode)
113 #+begin_src emacs-lisp
115 :config (minions-mode))
118 Highlight whitespace and other bad text practices.
119 #+begin_src emacs-lisp
120 (use-package whitespace
121 :custom (whitespace-style '(face lines-tail)))
122 (dolist (hook '(prog-mode-hook))
123 (add-hook hook (lambda () (whitespace-mode 1))))
125 ** Highlight todo items in comments
126 +begin_src emacs-lisp
128 :straight (hl-todo :type git :host github :repo "tarsius/hl-todo")
129 :config (global-hl-todo-mode 1))
132 #+begin_src emacs-lisp
136 Soft wrap words and do operations by visual lines in some modes.
137 #+begin_src emacs-lisp
138 (dolist (hook '(text-mode-hook
141 mu4e-view-mode-hook))
142 (add-hook hook (lambda () (visual-line-mode 1))))
145 #+begin_src emacs-lisp
146 (dolist (hook '(scdoc-mode-hook
147 mu4e-compose-mode-hook))
148 (add-hook hook (lambda () (auto-fill-mode 1))))
150 ** Display number of matches in search
151 #+begin_src emacs-lisp
153 :config (global-anzu-mode)
155 ([remap query-replace] . anzu-query-replace)
156 ([remap query-replace-regexp] . anzu-query-replace-regexp))
158 *** TODO This config doesn't work right
160 Invert modeline color instead of audible bell or the standard visual bell.
161 #+begin_src emacs-lisp
162 (setq visible-bell nil
164 (lambda () (invert-face 'mode-line)
165 (run-with-timer 0.1 nil #'invert-face 'mode-line)))
169 #+begin_src emacs-lisp
171 :custom (select-enable-clipboard nil)
174 (fset 'evil-visual-update-x-selection 'ignore) ;; Keep clipboard and register seperate
175 ;; Use visual line motions even outside of visual-line-mode buffers
176 (evil-global-set-key 'motion "j" 'evil-next-visual-line)
177 (evil-global-set-key 'motion "k" 'evil-previous-visual-line)
178 (global-set-key (kbd "<escape>") 'keyboard-escape-quit))
181 Evil bindings for tons of packages.
182 #+begin_src emacs-lisp
183 (use-package evil-collection
185 :init (evil-collection-init)
186 :custom (evil-collection-setup-minibuffer t))
190 #+begin_src emacs-lisp
191 (use-package evil-surround
192 :config (global-evil-surround-mode))
195 Makes commenting super easy
196 #+begin_src emacs-lisp
197 (use-package evil-nerd-commenter
198 :bind (:map evil-normal-state-map
199 ("gc" . evilnc-comment-or-uncomment-lines))
200 :custom (evilnc-invert-comment-line-by-line nil))
204 #+begin_src emacs-lisp
206 :config (evil-set-undo-system 'undo-fu))
208 (use-package undo-fu-session
209 :config (global-undo-fu-session-mode))
211 ** Number incrementing
212 Add back C-a/C-x bindings.
213 #+begin_src emacs-lisp
214 (use-package evil-numbers
215 :straight (evil-numbers :type git :host github :repo "juliapath/evil-numbers")
216 :bind (:map evil-normal-state-map
217 ("C-M-a" . evil-numbers/inc-at-pt)
218 ("C-M-x" . evil-numbers/dec-at-pt)))
221 #+begin_src emacs-lisp
222 (use-package evil-org
224 :hook (org-mode . evil-org-mode)
226 (evil-org-set-key-theme '(textobjects insert navigation shift todo)))
228 (use-package evil-org-agenda
229 :straight (:type built-in)
231 :config (evil-org-agenda-set-keys))
235 #+begin_src emacs-lisp
237 :straight (:type built-in)
238 :commands (org-capture org-agenda)
241 (org-agenda-start-with-log-mode t)
242 (org-agenda-files (quote ("~/org/tasks.org")))
244 (org-log-into-drawer t)
245 (org-src-tab-acts-natively t)
246 (org-src-fontify-natively t)
247 (org-startup-indented t)
248 (org-hide-emphasis-markers t)
249 (org-fontify-whole-block-delimiter-line nil)
250 (org-archive-default-command 'org-archive-to-archive-sibling)
252 ("C-c a" . org-agenda)
253 (:map evil-normal-state-map ("ga" . org-archive-subtree-default)))
256 Define templates for lots of common structure elements. Mostly just used within this file.
257 #+begin_src emacs-lisp
258 (use-package org-tempo
260 :straight (:type built-in)
263 ("ag" . "src conf :tangle ~/.gnupg/gpg-agent.conf")
264 ("ash" . "src shell :tangle ~/.config/ash/ashrc")
265 ("el" . "src emacs-lisp")
266 ("git" . "src conf :tangle ~/.gitconfig")
267 ("gp" . "src conf :tangle ~/.gnupg/gpg.conf")
268 ("pi" . "src conf :tangle ~/.config/picom/picom.conf")
269 ("sp" . "src conf :tangle ~/.spectrwm.conf")
270 ("tm" . "src conf :tangle ~/.tmux.conf")
271 ("xm" . "src conf :tangle ~/.config/xmodmap")
272 ("xr" . "src conf :tangle ~/.Xresources")
273 ("za" . "src conf :tangle ~/.config/zathura/zathurarc")
275 (add-to-list 'org-structure-template-alist addition)))
279 A well balanced completion framework.
280 #+begin_src emacs-lisp
282 :bind (:map ivy-minibuffer-map
283 ("TAB" . ivy-alt-done))
284 (:map ivy-switch-buffer-map
285 ("M-d" . ivy-switch-buffer-kill))
289 #+begin_src emacs-lisp
290 (use-package ivy-rich
292 :config (ivy-rich-mode))
296 #+begin_src emacs-lisp
298 :bind ("C-M-j" . 'counsel-switch-buffer)
299 :config (counsel-mode))
301 ** Remember frequent commands
302 #+begin_src emacs-lisp
303 (use-package ivy-prescient
306 (prescient-persist-mode)
307 (ivy-prescient-mode))
311 Use elfeed for reading RSS. I have another file with all the feeds in it that I'd rather keep private.
312 #+begin_src emacs-lisp
314 :bind (("C-c e" . elfeed))
315 :config (load "~/.emacs.d/feeds.el")
316 :bind (:map elfeed-search-mode-map ("C-c C-o" . 'elfeed-show-visit)))
319 Use mu4e for reading emails.
320 Contexts are a not very well known feature of mu4e that makes it super easy to manage multiple accounts. Much better than some of the hacky methods and external packages that I've seen.
321 *** TODO Switch to mbsync
322 =offlineimap= really crappy (slow and requires python2), and I need to replace it with =mbsync=.
323 *** TODO Include mbsync/offlineimap config
324 *** TODO Split up and document this config a bit
326 #+begin_src emacs-lisp
327 (use-package smtpmail
328 :straight (:type built-in))
330 :load-path "/usr/share/emacs/site-lisp/mu4e"
331 :straight (:build nil)
332 :bind (("C-c m" . mu4e))
334 (setq user-full-name "Armaan Bhojwani"
335 smtpmail-local-domain "armaanb.net"
336 smtpmail-stream-type 'ssl
337 smtpmail-smtp-service '465
338 mu4e-change-filenames-when-moving t
339 mu4e-get-mail-command "offlineimap -q"
340 message-citation-line-format "On %a %d %b %Y at %R, %f wrote:\n"
341 message-citation-line-function 'message-insert-formatted-citation-line
342 mu4e-completing-read-function 'ivy-completing-read
343 mu4e-confirm-quit nil
345 mail-user-agent 'mu4e-user-agent
346 mu4e-context-policy 'pick-first
348 `( ,(make-mu4e-context
350 :enter-func (lambda () (mu4e-message "Entering school context"))
351 :leave-func (lambda () (mu4e-message "Leaving school context"))
352 :match-func (lambda (msg)
354 (string-match-p "^/school" (mu4e-message-field msg :maildir))))
355 :vars '((user-mail-address . "abhojwani22@nobles.edu")
356 (mu4e-sent-folder . "/school/Sent")
357 (mu4e-drafts-folder . "/school/Drafts")
358 (mu4e-trash-folder . "/school/Trash")
359 (mu4e-refile-folder . "/school/Archive")
360 (message-cite-reply-position . above)
361 (user-mail-address . "abhojwani22@nobles.edu")
362 (smtpmail-smtp-user . "abhojwani22@nobles.edu")
363 (smtpmail-smtp-server . "smtp.gmail.com")))
366 :enter-func (lambda () (mu4e-message "Entering personal context"))
367 :leave-func (lambda () (mu4e-message "Leaving personal context"))
368 :match-func (lambda (msg)
370 (string-match-p "^/personal" (mu4e-message-field msg :maildir))))
371 :vars '((mu4e-sent-folder . "/personal/Sent")
372 (mu4e-drafts-folder . "/personal/Drafts")
373 (mu4e-trash-folder . "/personal/Trash")
374 (mu4e-refile-folder . "/personal/Archive")
375 (user-mail-address . "me@armaanb.net")
376 (message-cite-reply-position . below)
377 (smtpmail-smtp-user . "me@armaanb.net")
378 (smtpmail-smtp-server . "smtp.mailbox.org")))))
379 (add-to-list 'mu4e-bookmarks
380 '(:name "Unified inbox"
381 :query "maildir:\"/personal/INBOX\" or maildir:\"/school/INBOX\""
383 :hook ((mu4e-compose-mode . flyspell-mode)
384 (message-send-hook . (lambda () (unless (yes-or-no-p "Ya sure 'bout that?")
385 (signal 'quit nil))))))
387 *** Discourage Gnus from displaying HTML emails
388 #+begin_src emacs-lisp
389 (with-eval-after-load "mm-decode"
390 (add-to-list 'mm-discouraged-alternatives "text/html")
391 (add-to-list 'mm-discouraged-alternatives "text/richtext"))
394 Set EWW as default browser except for multimedia which should open in MPV.
395 #+begin_src emacs-lisp
396 (defun browse-url-mpv (url &optional new-window)
397 "Ask MPV to load URL."
399 (start-process "mpv" "*mpv*" "mpv" url))
401 (setq browse-url-handlers
403 (("youtu\\.?be" . browse-url-mpv)
404 ("peertube.*" . browse-url-mpv)
405 ("vid.*" . browse-url-mpv)
406 ("vid.*" . browse-url-mpv)
407 ("*.mp4" . browse-url-mpv)
408 ("*.mp3" . browse-url-mpv)
409 ("*.ogg" . browse-url-mpv)
410 ("." . eww-browse-url)
414 Some EWW enhancements.
415 *** Give buffer a useful name
416 #+begin_src emacs-lisp
417 ;; From https://protesilaos.com/dotemacs/
418 (defun prot-eww--rename-buffer ()
419 "Rename EWW buffer using page title or URL.
420 To be used by `eww-after-render-hook'."
421 (let ((name (if (eq "" (plist-get eww-data :title))
422 (plist-get eww-data :url)
423 (plist-get eww-data :title))))
424 (rename-buffer (format "*%s # eww*" name) t)))
427 :straight (:type built-in)
428 :bind (("C-c w" . eww))
429 :hook (eww-after-render-hook prot-eww--rename-buffer))
432 #+begin_src emacs-lisp
433 (global-set-key (kbd "C-c w") 'eww)
436 Circe is a really nice IRC client that claims to be above RCIRC and below ERC in terms of features. ERC felt a bit messy and finicky to me, and Circe has all the features that I need. This setup gets the password for my bouncer (Pounce) instances via my =~/.authinfo.gpg= file.
437 #+begin_src emacs-lisp
438 (defun fetch-password (&rest params)
439 (require 'auth-source)
440 (let ((match (car (apply 'auth-source-search params))))
442 (let ((secret (plist-get match :secret)))
443 (if (functionp secret)
446 (error "Password not found for %S" params))))
451 (enable-circe-color-nicks)
452 (setq circe-network-defaults '(("libera"
453 :host "irc.armaanb.net"
458 :pass (lambda (null) (fetch-password
460 :machine "irc.armaanb.net"
463 :host "irc.armaanb.net"
468 :pass (lambda (null) (fetch-password
470 :machine "irc.armaanb.net"
473 :host "irc.armaanb.net"
478 :pass (lambda (null) (fetch-password
480 :machine "irc.armaanb.net"
482 :custom (circe-default-part-message "goodbye!")
483 :bind (:map circe-mode-map ("C-c C-r" . circe-reconnect-all)))
488 (if (get-buffer "irc.armaanb.net:6696")
489 (switch-to-buffer "irc.armaanb.net:6696")
490 (progn (switch-to-buffer "*scratch*")
495 (global-set-key (kbd "C-c i") 'acheam-irc)
498 Still experimenting with this setup. Not sure if I will keep it, but it works well for seeing my calendar events. I use =vdirsyncer= to sync my calendar events which I'm really not happy with.
499 #+begin_src emacs-lisp
500 (defun sync-calendar ()
501 "Sync calendars with vdirsyncer"
503 (async-shell-command "vdirsyncer sync"))
506 :bind (:map cfw:calendar-mode-map ("C-S-u" . sync-calendar)))
507 (use-package calfw-ical)
508 (use-package calfw-org)
510 (defun acheam-calendar ()
513 (cfw:open-calendar-buffer
514 :contents-sources (list
515 (cfw:org-create-source "Green")
516 (cfw:ical-create-source
518 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
520 (cfw:ical-create-source
522 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
524 (cfw:ical-create-source
526 "~/.local/share/vdirsyncer/school/abhojwani22@nobles.edu.ics"
530 (global-set-key (kbd "C-c c") 'acheam-calendar)
533 #+begin_src emacs-lisp
534 (use-package pdf-tools
535 :hook (pdf-view-mode . pdf-view-midnight-minor-mode))
539 #+begin_src emacs-lisp
541 :hook (python-mode . blacken-mode)
542 :custom (blacken-line-length 79))
545 ** Strip trailing whitespace
546 #+begin_src emacs-lisp
547 (use-package ws-butler
548 :config (ws-butler-global-mode))
551 Automatic linting. I need to look into configuring this more.
552 #+begin_src emacs-lisp
553 (use-package flycheck
554 :config (global-flycheck-mode))
556 ** Project management
557 I never use this, but apparently its very powerful. Another item on my todo list.
558 #+begin_src emacs-lisp
559 (use-package projectile
560 :config (projectile-mode)
561 :custom ((projectile-completion-system 'ivy))
562 :bind-keymap ("C-c p" . projectile-command-map)
563 :init (setq projectile-switch-project-action #'projectile-dired))
565 (use-package counsel-projectile
567 :config (counsel-projectile-mode))
570 The best file manager!
571 #+begin_src emacs-lisp
573 :straight (:type built-in)
574 :commands (dired dired-jump)
575 :custom ((dired-listing-switches "-agho --group-directories-first"))
576 :config (evil-collection-define-key 'normal 'dired-mode-map
577 "h" 'dired-single-up-directory
578 "l" 'dired-single-buffer))
580 (use-package dired-single
581 :commands (dired dired-jump))
583 (use-package dired-open
584 :commands (dired dired-jump)
585 :custom (dired-open-extensions '(("png" . "feh")
588 (use-package dired-hide-dotfiles
589 :hook (dired-mode . dired-hide-dotfiles-mode)
591 (evil-collection-define-key 'normal 'dired-mode-map
592 "H" 'dired-hide-dotfiles-mode))
596 A very good Git interface.
597 #+begin_src emacs-lisp
601 #+begin_src emacs-lisp
603 (use-package git-email
604 :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
605 :config (git-email-piem-mode))
608 Modified from https://eklitzke.org/smarter-emacs-clang-format.
610 Style is basically ddevault's style guide but with 4 spaces instead of 8 char tabs.
611 #+begin_src emacs-lisp
612 (use-package clang-format
613 :custom (clang-format-style "{
615 AlwaysBreakAfterReturnType: AllDefinitions,
619 (defun clang-format-buffer-smart ()
620 "Reformat buffer if .clang-format exists in the projectile root."
621 (when (file-exists-p (expand-file-name ".clang-format" (projectile-project-root)))
622 (when (if (eq major-mode 'c-mode))
623 (message "Formatting with clang-format...")
624 (clang-format-buffer))))
626 (add-hook 'before-save-hook 'clang-format-buffer-smart nil)
628 * General text editing
630 Spell check in text mode, and in prog-mode comments.
631 #+begin_src emacs-lisp
632 (dolist (hook '(text-mode-hook
635 (add-hook hook (lambda () (flyspell-mode))))
636 (dolist (hook '(change-log-mode-hook log-edit-mode-hook))
637 (add-hook hook (lambda () (flyspell-mode -1))))
638 (add-hook 'prog-mode (lambda () (flyspell-prog mode)))
639 (setq ispell-silently-savep t)
642 #+begin_src emacs-lisp
643 (setq-default tab-width 2)
646 Opens file where you left it.
647 #+begin_src emacs-lisp
651 Distraction free writing a la junegunn/goyo.
652 #+begin_src emacs-lisp
653 (use-package olivetti
654 :bind ("C-c o" . olivetti-mode))
657 Abbreviate things! I just use this for things like my email address and copyright notice.
658 #+begin_src emacs-lisp
659 (setq abbrev-file-name "~/.emacs.d/abbrevs.el")
660 (setq save-abbrevs 'silent)
661 (setq-default abbrev-mode t)
664 #+begin_src emacs-lisp
665 (setq tramp-default-method "ssh")
667 ** Follow version controlled symlinks
668 #+begin_src emacs-lisp
669 (setq vc-follow-symlinks t)
672 #+begin_src emacs-lisp
673 (defun doas-edit (&optional arg)
674 "Edit currently visited file as root.
676 With a prefix ARG prompt for a file to visit.
677 Will also prompt for a file to visit if current
678 buffer is not visiting a file.
680 Modified from Emacs Redux."
682 (if (or arg (not buffer-file-name))
683 (find-file (concat "/doas:root@localhost:"
684 (ido-read-file-name "Find file(as root): ")))
685 (find-alternate-file (concat "/doas:root@localhost:" buffer-file-name))))
687 (global-set-key (kbd "C-x C-r") #'doas-edit)
690 #+begin_src emacs-lisp
691 (use-package markdown-mode)
694 Get it for yourself at https://git.armaanb.net/scdoc
695 #+begin_src emacs-lisp
696 (add-to-list 'load-path "~/src/scdoc-mode")
697 (autoload 'scdoc-mode "scdoc-mode" "Major mode for editing scdoc files" t)
698 (add-to-list 'auto-mode-alist '("\\.scd\\'" . scdoc-mode))
702 #+begin_src emacs-lisp
703 (use-package ace-window
704 :bind ("M-o" . ace-window))
706 ** Kill current buffer
707 Makes "C-x k" binding faster.
708 #+begin_src emacs-lisp
709 (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
713 #+begin_src emacs-lisp
714 (use-package scad-mode)
716 ** Control backup and lock files
717 Stop backup files from spewing everywhere.
718 #+begin_src emacs-lisp
719 (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
720 create-lockfiles nil)
722 ** Make yes/no easier
723 #+begin_src emacs-lisp
724 (defalias 'yes-or-no-p 'y-or-n-p)
726 ** Move customize file
727 No more clogging up init.el.
728 #+begin_src emacs-lisp
729 (setq custom-file "~/.emacs.d/custom.el")
733 #+begin_src emacs-lisp
735 :commands (helpful-callable helpful-variable helpful-command helpful-key)
737 (counsel-describe-function-function #'helpful-callable)
738 (counsel-describe-variable-function #'helpful-variable)
740 ([remap describe-function] . counsel-describe-function)
741 ([remap describe-command] . helpful-command)
742 ([remap describe-variable] . counsel-describe-variable)
743 ([remap describe-key] . helpful-key))
746 #+begin_src emacs-lisp
747 (use-package epa-file
748 :straight (:type built-in)
750 (epa-file-select-keys nil)
751 (epa-file-encrypt-to '("me@armaanb.net"))
752 (password-cache-expiry (* 60 15)))
754 (use-package pinentry
755 :config (pinentry-start))
758 #+begin_src emacs-lisp
760 :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
761 :custom (0x0-default-service 'envs))
763 *** TODO Replace this with uploading to my own server
764 Similar to the ufile alias in my ashrc
765 ** Automatically clean buffers
766 Automatically close unused buffers (except those of Circe) at midnight.
767 #+begin_src emacs-lisp
769 (add-to-list 'clean-buffer-list-kill-never-regexps (lambda (buffer-name)
770 (with-current-buffer buffer-name
771 (derived-mode-p 'lui-mode))))
775 Spectrwm is a really awesome window manager! Would highly recommend.
777 #+begin_src conf :tangle ~/.spectrwm.conf
781 autorun = ws[1]:/home/armaa/src/bin/autostart
784 Disable the bar by default (it can still be brought back up with MOD+b). The font just needs to be set to something that you have installed, otherwise spectrwm won't launch.
785 #+begin_src conf :tangle ~/.spectrwm.conf
787 bar_font = xos4 JetBrains Mono:pixelsize=14:antialias=true # any installed font
790 I'm not a huge fan of how spectrwm handles keybindings, probably my biggest gripe with it.
792 #+begin_src conf :tangle ~/.spectrwm.conf
793 program[term] = st -e tmux
794 program[notif] = /home/armaa/src/bin/setter status
795 program[pass] = /home/armaa/src/bin/passmenu
796 program[lock] = slock
799 bind[pass] = MOD+Shift+p
802 #+begin_src conf :tangle ~/.spectrwm.conf
803 program[paup] = /home/armaa/src/bin/setter audio +5
804 program[padown] = /home/armaa/src/bin/setter audio -5
805 program[pamute] = /home/armaa/src/bin/setter audio
806 program[brigup] = /home/armaa/src/bin/setter brightness +10%
807 program[brigdown] = /home/armaa/src/bin/setter brightness 10%-
809 bind[padown] = XF86AudioLowerVolume
810 bind[paup] = XF86AudioRaiseVolume
811 bind[pamute] = XF86AudioMute
812 bind[brigdown] = XF86MonBrightnessDown
813 bind[brigup] = XF86MonBrightnessUp
816 #+begin_src conf :tangle ~/.spectrwm.conf
817 program[h] = xdotool keyup h key --clearmodifiers Left
818 program[j] = xdotool keyup j key --clearmodifiers Down
819 program[k] = xdotool keyup k key --clearmodifiers Up
820 program[l] = xdotool keyup l key --clearmodifiers Right
822 bind[h] = MOD + Control + h
823 bind[j] = MOD + Control + j
824 bind[k] = MOD + Control + k
825 bind[l] = MOD + Control + l
828 #+begin_src conf :tangle ~/.spectrwm.conf
829 program[email] = emacsclient -ce '(progn (switch-to-buffer "*scratch*") (mu4e))'
830 program[irc] = emacsclient -ce '(acheam-irc)'
831 program[rss] = emacsclient -ce '(elfeed)'
832 program[calendar] = emacsclient -ce '(acheam-calendar)'
833 program[calc] = emacsclient -ce '(progn (calc) (windmove-up) (delete-window))'
834 program[emacs] = emacsclient -c
835 program[bookmarks] = /home/armaa/src/bin/bookmarks
836 program[browser] = chorizo
838 bind[email] = MOD+Control+1
839 bind[irc] = MOD+Control+2
840 bind[rss] = MOD+Control+3
841 bind[calendar] = MOD+Control+4
842 bind[calc] = MOD+Control+5
843 bind[emacs] = MOD+Control+Return
844 bind[bookmarks] = MOD+Control+o
845 bind[browser] = MOD+Control+p
848 Float some specific programs by default.
849 #+begin_src conf :tangle ~/.spectrwm.conf
850 quirk[Castle Menu] = FLOAT
852 quirk[pinentry-fltk] = FLOAT
856 Use the vi editing mode. I still haven't found a good way to show visual feedback of the current mode. Ideally the cursor would change to a beam when in insert mode, and a box when in normal mode.
857 #+begin_src conf :tangle ~/.config/ash/ashrc
862 #+begin_src shell :tangle ~/.config/ash/ashrc
864 user=$(echo "$1" | cut -f 1 -d '@')
865 host=$(echo "$1" | cut -f 2 -d '@')
866 echo $user | nc "$host" 79
869 **** Upload to ftp.armaanb.net
870 #+begin_src shell :tangle ~/.config/ash/ashrc
872 echo "https://l.armaanb.net/$(basename "$1")" | tee /dev/tty | xclip -sel c
876 rsync "$1" "armaa@armaanb.net:/srv/ftp/pub/$2" --chmod 644 --progress
886 xclip -o -sel c >> "$tmp"
887 basetmp=$(echo "$tmp" | tail -c +5)
888 _uup "$tmp" "$basetmp"
894 #+begin_src shell :tangle ~/.config/ash/ashrc
895 export EDITOR="emacsclient -c"
896 export VISUAL="$EDITOR"
897 export TERM=xterm-256color # for compatability
899 export GPG_TTY="$(tty)"
900 export MANPAGER='nvim +Man!'
902 export GTK_USE_PORTAL=1
905 export PATH="/home/armaa/.local/bin:$PATH" # prioritize .local/bin
906 export PATH="/home/armaa/src/bin:$PATH" # prioritize my bin
907 export PATH="//home/armaa/src/bin/bin:$PATH" # prioritize my bins
908 export PATH="$PATH:/usr/sbin"
910 export LC_ALL="en_US.UTF-8"
911 export LC_CTYPE="en_US.UTF-8"
912 export LANGUAGE="en_US.UTF-8"
913 export TZ="America/New_York"
916 export KISS_PATH="$KISS_PATH:$HOME/repos/personal"
917 export KISS_PATH="$KISS_PATH:$HOME/repos/bin/bin"
918 export KISS_PATH="$KISS_PATH:$HOME/repos/main/core"
919 export KISS_PATH="$KISS_PATH:$HOME/repos/main/extra"
920 export KISS_PATH="$KISS_PATH:$HOME/repos/main/xorg"
921 export KISS_PATH="$KISS_PATH:$HOME/repos/community/community"
922 export KISS_PATH="$KISS_PATH:$HOME/repos/mid/ports"
924 export CFLAGS="-O3 -pipe -march=native"
925 export CXXFLAGS="$CFLAGS"
926 export MAKEFLAGS="-j$(nproc)"
927 export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
929 export XDG_DESKTOP_DIR="/dev/null"
930 export XDG_DOCUMENTS_DIR="$HOME/documents"
931 export XDG_DOWNLOAD_DIR="$HOME/downloads"
932 export XDG_MUSIC_DIR="$HOME/music"
933 export XDG_PICTURES_DIR="$HOME/pictures"
934 export XDG_VIDEOS_DIR="$HOME/videos"
938 #+begin_src shell :tangle ~/.config/ash/ashrc
939 alias poki='ssh armaanb.net'
940 alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
941 alias union='ssh 192.168.1.18'
942 alias mine='ssh -p 23 root@pickupserver.cc'
943 alias tcf='ssh root@204.48.23.68'
944 alias ngmun='ssh root@157.245.89.25'
945 alias prox='ssh root@192.168.1.224'
946 alias ncq='ssh root@143.198.123.17'
947 alias envs='ssh acheam@envs.net'
950 #+begin_src shell :tangle ~/.config/ash/ashrc
951 alias ls='LC_COLLATE=C ls -lh --group-directories-first'
953 alias df='df -h / /boot'
960 alias grep='grep -in'
961 alias mkdir='mkdir -pv'
962 alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar && rm lxc*'
963 emacs() { $EDITOR "$@" & }
966 **** System management
967 #+begin_src shell :tangle ~/.config/ash/ashrc
968 alias crontab='crontab-argh'
970 alias pasu='git -C ~/.password-store push'
971 alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
975 #+begin_src shell :tangle ~/.config/ash/ashrc
976 alias ping='ping -c 10'
977 alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
978 alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
979 alias plan='T=$(mktemp) && \
980 rsync armaanb.net:/home/armaa/plan.txt "$T" && \
982 head -n -2 $T > $TT && \
985 echo "Last updated: $(date -R)" >> "$TT" && \
986 fold -sw 72 "$TT" > "$T"| \
987 rsync "$T" armaanb.net:/home/armaa/plan.txt && \
990 **** Virtual machines, chroots
991 #+begin_src shell :tangle ~/.config/ash/ashrc
992 alias ckiss="doas chrooter ~/Virtual/kiss"
993 alias cdebian="doas chrooter ~/Virtual/debian bash"
994 alias cwindows='devour qemu-system-x86_64 \
999 -device VGA,vgamem_mb=64 \
1001 -device hda-duplex \
1003 -net user,smb=/home/armaa/Public \
1004 -drive format=qcow2,file=/home/armaa/Virtual/windows.qcow2'
1007 #+begin_src shell :tangle ~/.config/ash/ashrc
1008 alias words='gen-shell -c "words"'
1009 alias words-e='gen-shell -c "words ~E"'
1012 #+begin_src shell :tangle ~/.config/ash/ashrc
1013 alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
1015 alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
1017 alias ytmusic="youtube-dl -x --add-metadata --audio-format aac \
1018 --restrict-filenames -o '%(title)s.%(ext)s'"
1022 Make MPV play a little bit smoother.
1023 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
1024 ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
1028 This file is used for any GNU Readline programs. I use Emacs editing mode mostly because of one annoyance which is that to clear the screen using ^L, you have to be in normal mode which is a pain. If there is a way to rebind this, I'd love to know!.
1029 #+begin_src conf :tangle ~/.inputrc
1030 set editing-mode emacs
1034 #+begin_src conf :tangle ~/.gitconfig
1036 name = Armaan Bhojwani
1037 email = me@armaanb.net
1038 signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
1041 #+begin_src conf :tangle ~/.gitconfig
1043 defaultBranch = main
1046 #+begin_src conf :tangle ~/.gitconfig
1051 #+begin_src conf :tangle ~/.gitconfig
1053 smtpserver = smtp.mailbox.org
1054 smtpuser = me@armaanb.net
1055 smtpencryption = ssl
1056 smtpserverport = 465
1060 #+begin_src conf :tangle ~/.gitconfig
1065 #+begin_src conf :tangle ~/.gitconfig
1068 sclone = clone --depth 1
1073 quickfix = commit . --amend --no-edit
1075 subup = submodule update --remote
1076 loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1077 pushnc = push -o skip-ci
1080 #+begin_src conf :tangle ~/.gitconfig
1086 #+begin_src conf :tangle ~/.gitconfig
1091 The best document reader!
1093 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1095 map <A-b> toggle_statusbar
1096 set selection-clipboard clipboard
1099 set window-title-basename "true"
1100 set selection-clipboard "clipboard"
1103 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1104 set default-bg "#000000"
1105 set default-fg "#ffffff"
1106 set render-loading true
1107 set render-loading-bg "#000000"
1108 set render-loading-fg "#ffffff"
1110 set recolor-lightcolor "#000000" # bg
1111 set recolor-darkcolor "#ffffff" # fg
1115 Modus operandi theme. No program I use checks for anything beyond foreground and background, but hey, it can't hurt to have all the colors in there.
1116 #+begin_src conf :tangle ~/.Xresources
1118 ,*.foreground: #ffffff
1119 ,*.background: #000000
1120 ,*.cursorColor: #ffffff
1155 I use tmux in order to keep my st build light. Still learning how it works.
1156 #+begin_src conf :tangle ~/.tmux.conf
1159 set-option -g history-limit 50000
1160 set-window-option -g mode-keys vi
1161 bind-key -T copy-mode-vi 'v' send -X begin-selection
1162 bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1166 #+begin_src conf :tangle ~/.gnupg/gpg.conf
1167 default-key 3C9ED82FFE788E4A
1171 #+begin_src conf :tangle ~/.gnupg/gpg-agent.conf
1172 pinentry-program /sbin/pinentry
1174 default-cache-ttl 600
1175 allow-emacs-pinentry
1178 #+begin_src conf (if (eq system-name "frost.armaanb.net") ":tangle ~/.config/xmodmap")
1182 ! Turn right alt into super
1186 ! Swap caps and control
1187 remove Lock = Caps_Lock
1188 remove Control = Control_L
1189 remove Lock = Control_L
1190 remove Control = Caps_Lock
1191 keysym Control_L = Caps_Lock
1192 keysym Caps_Lock = Control_L
1193 add Lock = Caps_Lock
1194 add Control = Control_L