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 28 with native compilation, 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 (setq modus-themes-slanted-constructs t
46 modus-themes-bold-constructs t
47 modus-themes-mode-line '3d
48 modus-themes-scale-headings t
49 modus-themes-diffs 'desaturated)
50 (load-theme 'modus-vivendi t)
54 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]].
55 #+begin_src emacs-lisp
56 (add-to-list 'default-frame-alist '(font . "JetBrainsMonoNF-12"))
59 #+begin_src emacs-lisp
61 :straight (ligature :type git :host github :repo "mickeynp/ligature.el")
63 (ligature-set-ligatures
64 '(prog-mode text-mode)
65 '("-|" "-~" "---" "-<<" "-<" "--" "->" "->>" "-->" "/=" "/=="
66 "/>" "//" "/*" "*>" "*/" "<-" "<<-" "<=>" "<=" "<|" "<||"
67 "<|||" "<|>" "<:" "<>" "<-<" "<<<" "<==" "<<=" "<=<" "<==>"
68 "<-|" "<<" "<~>" "<=|" "<~~" "<~" "<$>" "<$" "<+>" "<+" "</>"
69 "</" "<*" "<*>" "<->" "<!--" ":>" ":<" ":::" "::" ":?" ":?>"
70 ":=" "::=" "=>>" "==>" "=/=" "=!=" "=>" "===" "=:=" "==" "!=="
71 "!!" "!=" ">]" ">:" ">>-" ">>=" ">=>" ">>>" ">-" ">=" "&&&"
72 "&&" "|||>" "||>" "|>" "|]" "|}" "|=>" "|->" "|=" "||-" "|-"
73 "||=" "||" ".." ".?" ".=" ".-" "..<" "..." "+++" "+>" "++"
74 "[||]" "[<" "[|" "{|" "?." "?=" "?:" "##" "###" "####" "#["
75 "#{" "#=" "#!" "#:" "#_(" "#_" "#?" "#(" ";;" "_|_" "__" "~~"
76 "~~>" "~>" "~-" "~@" "$>" "^=" "]#"))
77 (global-ligature-mode t))
80 Display relative line numbers except in certain modes.
81 #+begin_src emacs-lisp
82 (global-display-line-numbers-mode)
83 (setq display-line-numbers-type 'relative)
84 (dolist (no-line-num '(term-mode-hook
90 (add-hook no-line-num (lambda () (display-line-numbers-mode 0))))
92 ** Highlight matching parenthesis
93 #+begin_src emacs-lisp
95 :config (show-paren-mode)
96 :custom (show-paren-style 'parenthesis))
99 *** Show current function
100 #+begin_src emacs-lisp
101 (which-function-mode)
103 *** Make position in file more descriptive
104 Show current column and file size.
105 #+begin_src emacs-lisp
107 (size-indication-mode)
110 #+begin_src emacs-lisp
112 :config (minions-mode))
115 Show a ruler at a certain number of chars depending on mode.
116 #+begin_src emacs-lisp
117 (setq display-fill-column-indicator-column 80)
118 (global-display-fill-column-indicator-mode)
120 ** Highlight todo items in comments
121 #+begin_src emacs-lisp
123 :straight (hl-todo :type git :host github :repo "tarsius/hl-todo")
124 :config (global-hl-todo-mode 1))
127 #+begin_src emacs-lisp
131 Soft wrap words and do operations by visual lines in some modes.
132 #+begin_src emacs-lisp
133 (dolist (hook '(text-mode-hook
136 mu4e-view-mode-hook))
137 (add-hook hook (lambda () (visual-line-mode 1))))
140 #+begin_src emacs-lisp
141 (dolist (hook '(scdoc-mode-hook
142 mu4e-compose-mode-hook))
143 (add-hook hook (lambda () (auto-fill-mode 1))))
145 ** Display number of matches in search
146 #+begin_src emacs-lisp
148 :config (global-anzu-mode)
150 ([remap query-replace] . anzu-query-replace)
151 ([remap query-replace-regexp] . anzu-query-replace-regexp))
153 *** TODO This config doesn't work right
155 Invert modeline color instead of audible bell or the standard visual bell.
156 #+begin_src emacs-lisp
157 (setq visible-bell nil
159 (lambda () (invert-face 'mode-line)
160 (run-with-timer 0.1 nil #'invert-face 'mode-line)))
164 #+begin_src emacs-lisp
166 :custom (select-enable-clipboard nil)
169 (fset 'evil-visual-update-x-selection 'ignore) ;; Keep clipboard and register seperate
170 ;; Use visual line motions even outside of visual-line-mode buffers
171 (evil-global-set-key 'motion "j" 'evil-next-visual-line)
172 (evil-global-set-key 'motion "k" 'evil-previous-visual-line)
173 (global-set-key (kbd "<escape>") 'keyboard-escape-quit))
176 Evil bindings for tons of packages.
177 #+begin_src emacs-lisp
178 (use-package evil-collection
180 :init (evil-collection-init)
181 :custom (evil-collection-setup-minibuffer t))
185 #+begin_src emacs-lisp
186 (use-package evil-surround
187 :config (global-evil-surround-mode))
190 Makes commenting super easy
191 #+begin_src emacs-lisp
192 (use-package evil-nerd-commenter
193 :bind (:map evil-normal-state-map
194 ("gc" . evilnc-comment-or-uncomment-lines))
195 :custom (evilnc-invert-comment-line-by-line nil))
199 #+begin_src emacs-lisp
200 (evil-set-undo-system 'undo-redo)
202 ** Number incrementing
203 Add back C-a/C-x bindings.
204 #+begin_src emacs-lisp
205 (use-package evil-numbers
206 :straight (evil-numbers :type git :host github :repo "juliapath/evil-numbers")
207 :bind (:map evil-normal-state-map
208 ("C-M-a" . evil-numbers/inc-at-pt)
209 ("C-M-x" . evil-numbers/dec-at-pt)))
212 #+begin_src emacs-lisp
213 (use-package evil-org
215 :hook (org-mode . evil-org-mode)
217 (evil-org-set-key-theme '(textobjects insert navigation shift todo)))
219 (use-package evil-org-agenda
220 :straight (:type built-in)
222 :config (evil-org-agenda-set-keys))
226 #+begin_src emacs-lisp
228 :straight (:type built-in)
229 :commands (org-capture org-agenda)
232 (org-agenda-start-with-log-mode t)
233 (org-agenda-files (quote ("~/Org/tasks.org" "~/Org/break.org")))
235 (org-log-into-drawer t)
236 (org-src-tab-acts-natively t)
237 (org-src-fontify-natively t)
238 (org-startup-indented t)
239 (org-hide-emphasis-markers t)
240 (org-fontify-whole-block-delimiter-line nil)
241 (org-archive-default-command 'org-archive-to-archive-sibling)
243 ("C-c a" . org-agenda)
244 (:map evil-normal-state-map ("ga" . org-archive-subtree-default)))
247 Define templates for lots of common structure elements. Mostly just used within this file.
248 #+begin_src emacs-lisp
249 (use-package org-tempo
251 :straight (:type built-in)
253 (dolist (addition '(("el" . "src emacs-lisp")
254 ("el" . "src emacs-lisp")
255 ("sp" . "src conf :tangle ~/.spectrwm.conf")
256 ("ash" . "src shell :tangle ~/.config/ash/ashrc")
257 ("pi" . "src conf :tangle ~/.config/picom/picom.conf")
258 ("git" . "src conf :tangle ~/.gitconfig")
259 ("du" . "src conf :tangle ~/.config/dunst/dunstrc")
260 ("za" . "src conf :tangle ~/.config/zathura/zathurarc")
261 ("ff1" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css")
262 ("ff2" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css")
263 ("xr" . "src conf :tangle ~/.Xresources")
264 ("tm" . "src conf :tangle ~/.tmux.conf")
265 ("gp" . "src conf :tangle ~/.gnupg/gpg.conf")
266 ("ag" . "src conf :tangle ~/.gnupg/gpg-agent.conf")
267 ("xm" . "src conf :tangle ~/.config/xmodmap")))
268 (add-to-list 'org-structure-template-alist addition)))
272 A well balanced completion framework.
273 #+begin_src emacs-lisp
275 :bind (:map ivy-minibuffer-map
276 ("TAB" . ivy-alt-done))
277 (:map ivy-switch-buffer-map
278 ("M-d" . ivy-switch-buffer-kill))
282 #+begin_src emacs-lisp
283 (use-package ivy-rich
285 :config (ivy-rich-mode))
289 #+begin_src emacs-lisp
291 :bind ("C-M-j" . 'counsel-switch-buffer)
292 :config (counsel-mode))
294 ** Remember frequent commands
295 #+begin_src emacs-lisp
296 (use-package ivy-prescient
299 (prescient-persist-mode)
300 (ivy-prescient-mode))
304 Use elfeed for reading RSS. I have another file with all the feeds in it that I'd rather keep private.
305 #+begin_src emacs-lisp
307 :bind (("C-c e" . elfeed))
308 :config (load "~/.emacs.d/feeds.el")
309 :bind (:map elfeed-search-mode-map ("C-c C-o" . 'elfeed-show-visit)))
312 Use mu4e for reading emails.
313 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.
314 *** TODO Switch to mbsync
315 =offlineimap= really crappy (slow and requires python2), and I need to replace it with =mbsync=.
316 *** TODO Include mbsync/offlineimap config
317 *** TODO Split up and document this config a bit
319 #+begin_src emacs-lisp
320 (use-package smtpmail
321 :straight (:type built-in))
323 :load-path "/usr/share/emacs/site-lisp/mu4e"
324 :straight (:build nil)
325 :bind (("C-c m" . mu4e))
327 (setq user-full-name "Armaan Bhojwani"
328 smtpmail-local-domain "armaanb.net"
329 smtpmail-stream-type 'ssl
330 smtpmail-smtp-service '465
331 mu4e-change-filenames-when-moving t
332 mu4e-get-mail-command "offlineimap -q"
333 message-citation-line-format "On %a %d %b %Y at %R, %f wrote:\n"
334 message-citation-line-function 'message-insert-formatted-citation-line
335 mu4e-completing-read-function 'ivy-completing-read
336 mu4e-confirm-quit nil
338 mail-user-agent 'mu4e-user-agent
339 mu4e-context-policy 'pick-first
341 `( ,(make-mu4e-context
343 :enter-func (lambda () (mu4e-message "Entering school context"))
344 :leave-func (lambda () (mu4e-message "Leaving school context"))
345 :match-func (lambda (msg)
347 (string-match-p "^/school" (mu4e-message-field msg :maildir))))
348 :vars '((user-mail-address . "abhojwani22@nobles.edu")
349 (mu4e-sent-folder . "/school/Sent")
350 (mu4e-drafts-folder . "/school/Drafts")
351 (mu4e-trash-folder . "/school/Trash")
352 (mu4e-refile-folder . "/school/Archive")
353 (message-cite-reply-position . above)
354 (user-mail-address . "abhojwani22@nobles.edu")
355 (smtpmail-smtp-user . "abhojwani22@nobles.edu")
356 (smtpmail-smtp-server . "smtp.gmail.com")))
359 :enter-func (lambda () (mu4e-message "Entering personal context"))
360 :leave-func (lambda () (mu4e-message "Leaving personal context"))
361 :match-func (lambda (msg)
363 (string-match-p "^/personal" (mu4e-message-field msg :maildir))))
364 :vars '((mu4e-sent-folder . "/personal/Sent")
365 (mu4e-drafts-folder . "/personal/Drafts")
366 (mu4e-trash-folder . "/personal/Trash")
367 (mu4e-refile-folder . "/personal/Archive")
368 (user-mail-address . "me@armaanb.net")
369 (message-cite-reply-position . below)
370 (smtpmail-smtp-user . "me@armaanb.net")
371 (smtpmail-smtp-server . "smtp.mailbox.org")))))
372 (add-to-list 'mu4e-bookmarks
373 '(:name "Unified inbox"
374 :query "maildir:\"/personal/INBOX\" or maildir:\"/school/INBOX\""
376 :hook ((mu4e-compose-mode . flyspell-mode)
377 (message-send-hook . (lambda () (unless (yes-or-no-p "Ya sure 'bout that?")
378 (signal 'quit nil))))))
380 *** Discourage Gnus from displaying HTML emails
381 #+begin_src emacs-lisp
382 (with-eval-after-load "mm-decode"
383 (add-to-list 'mm-discouraged-alternatives "text/html")
384 (add-to-list 'mm-discouraged-alternatives "text/richtext"))
387 Set EWW as default browser except for multimedia which should open in MPV.
388 #+begin_src emacs-lisp
389 (defun browse-url-mpv (url &optional new-window)
390 "Ask MPV to load URL."
392 (start-process "mpv" "*mpv*" "mpv" url))
394 (setq browse-url-handlers
396 (("youtu\\.?be" . browse-url-mpv)
397 ("peertube.*" . browse-url-mpv)
398 ("vid.*" . browse-url-mpv)
399 ("vid.*" . browse-url-mpv)
400 ("*.mp4" . browse-url-mpv)
401 ("*.mp3" . browse-url-mpv)
402 ("*.ogg" . browse-url-mpv)
403 ("." . eww-browse-url)
407 Some EWW enhancements.
408 *** Give buffer a useful name
409 #+begin_src emacs-lisp
410 ;; From https://protesilaos.com/dotemacs/
411 (defun prot-eww--rename-buffer ()
412 "Rename EWW buffer using page title or URL.
413 To be used by `eww-after-render-hook'."
414 (let ((name (if (eq "" (plist-get eww-data :title))
415 (plist-get eww-data :url)
416 (plist-get eww-data :title))))
417 (rename-buffer (format "*%s # eww*" name) t)))
420 :straight (:type built-in)
421 :bind (("C-c w" . eww))
422 :hook (eww-after-render-hook prot-eww--rename-buffer))
425 #+begin_src emacs-lisp
426 (global-set-key (kbd "C-c w") 'eww)
429 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.
430 #+begin_src emacs-lisp
431 (defun fetch-password (&rest params)
432 (require 'auth-source)
433 (let ((match (car (apply 'auth-source-search params))))
435 (let ((secret (plist-get match :secret)))
436 (if (functionp secret)
439 (error "Password not found for %S" params))))
444 (enable-circe-color-nicks)
445 (setq circe-network-defaults '(("libera"
446 :host "irc.armaanb.net"
451 :pass (lambda (null) (fetch-password
453 :machine "irc.armaanb.net"
456 :host "irc.armaanb.net"
461 :pass (lambda (null) (fetch-password
463 :machine "irc.armaanb.net"
466 :host "irc.armaanb.net"
471 :pass (lambda (null) (fetch-password
473 :machine "irc.armaanb.net"
475 :custom (circe-default-part-message "goodbye!")
476 :bind (:map circe-mode-map ("C-c C-r" . circe-reconnect-all)))
481 (if (get-buffer "irc.armaanb.net:6696")
482 (switch-to-buffer "irc.armaanb.net:6696")
483 (progn (switch-to-buffer "*scratch*")
488 (global-set-key (kbd "C-c i") 'acheam-irc)
491 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.
492 #+begin_src emacs-lisp
493 (defun sync-calendar ()
494 "Sync calendars with vdirsyncer"
496 (async-shell-command "vdirsyncer sync"))
499 :bind (:map cfw:calendar-mode-map ("C-S-u" . sync-calendar)))
500 (use-package calfw-ical)
501 (use-package calfw-org)
503 (defun acheam-calendar ()
506 (cfw:open-calendar-buffer
507 :contents-sources (list
508 (cfw:org-create-source "Green")
509 (cfw:ical-create-source
511 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
513 (cfw:ical-create-source
515 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
517 (cfw:ical-create-source
519 "~/.local/share/vdirsyncer/school/abhojwani22@nobles.edu.ics"
523 (global-set-key (kbd "C-c c") 'acheam-calendar)
526 #+begin_src emacs-lisp
527 (use-package pdf-tools
528 :hook (pdf-view-mode . pdf-view-midnight-minor-mode))
532 #+begin_src emacs-lisp
534 :hook (python-mode . blacken-mode)
535 :custom (blacken-line-length 79))
538 ** Strip trailing whitespace
539 #+begin_src emacs-lisp
540 (use-package ws-butler
541 :config (ws-butler-global-mode))
544 Automatic linting. I need to look into configuring this more.
545 #+begin_src emacs-lisp
546 (use-package flycheck
547 :config (global-flycheck-mode))
549 ** Project management
550 I never use this, but apparently its very powerful. Another item on my todo list.
551 #+begin_src emacs-lisp
552 (use-package projectile
553 :config (projectile-mode)
554 :custom ((projectile-completion-system 'ivy))
556 ("C-c p" . projectile-command-map)
558 (when (file-directory-p "~/Code")
559 (setq projectile-project-search-path '("~/Code")))
560 (setq projectile-switch-project-action #'projectile-dired))
562 (use-package counsel-projectile
564 :config (counsel-projectile-mode))
567 The best file manager!
568 #+begin_src emacs-lisp
570 :straight (:type built-in)
571 :commands (dired dired-jump)
572 :custom ((dired-listing-switches "-agho --group-directories-first"))
573 :config (evil-collection-define-key 'normal 'dired-mode-map
574 "h" 'dired-single-up-directory
575 "l" 'dired-single-buffer))
577 (use-package dired-single
578 :commands (dired dired-jump))
580 (use-package dired-open
581 :commands (dired dired-jump)
582 :custom (dired-open-extensions '(("png" . "feh")
585 (use-package dired-hide-dotfiles
586 :hook (dired-mode . dired-hide-dotfiles-mode)
588 (evil-collection-define-key 'normal 'dired-mode-map
589 "H" 'dired-hide-dotfiles-mode))
593 A very good Git interface.
594 #+begin_src emacs-lisp
598 #+begin_src emacs-lisp
600 (use-package git-email
601 :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
602 :config (git-email-piem-mode))
604 * General text editing
606 Automatically indent after every change. I'm not sure how much I like this. It slows down the editor and code sometimes ends up in a half-indented state meaning I have to manually reformat using "==" anyways.
607 #+begin_src emacs-lisp
608 (use-package aggressive-indent
609 :config (global-aggressive-indent-mode))
612 Spell check in text mode, and in prog-mode comments.
613 #+begin_src emacs-lisp
614 (dolist (hook '(text-mode-hook
617 (add-hook hook (lambda () (flyspell-mode))))
618 (dolist (hook '(change-log-mode-hook log-edit-mode-hook))
619 (add-hook hook (lambda () (flyspell-mode -1))))
620 (add-hook 'prog-mode (lambda () (flyspell-prog mode)))
621 (setq ispell-silently-savep t)
624 #+begin_src emacs-lisp
625 (setq-default tab-width 2)
628 Opens file where you left it.
629 #+begin_src emacs-lisp
633 Distraction free writing a la junegunn/goyo.
634 #+begin_src emacs-lisp
635 (use-package olivetti
636 :bind ("C-c o" . olivetti-mode))
639 Abbreviate things! I just use this for things like my email address and copyright notice.
640 #+begin_src emacs-lisp
641 (setq abbrev-file-name "~/.emacs.d/abbrevs.el")
642 (setq save-abbrevs 'silent)
643 (setq-default abbrev-mode t)
646 #+begin_src emacs-lisp
647 (setq tramp-default-method "ssh")
649 ** Follow version controlled symlinks
650 #+begin_src emacs-lisp
651 (setq vc-follow-symlinks t)
654 #+begin_src emacs-lisp
655 (defun doas-edit (&optional arg)
656 "Edit currently visited file as root.
658 With a prefix ARG prompt for a file to visit.
659 Will also prompt for a file to visit if current
660 buffer is not visiting a file.
662 Modified from Emacs Redux."
664 (if (or arg (not buffer-file-name))
665 (find-file (concat "/doas:root@localhost:"
666 (ido-read-file-name "Find file(as root): ")))
667 (find-alternate-file (concat "/doas:root@localhost:" buffer-file-name))))
669 (global-set-key (kbd "C-x C-r") #'doas-edit)
672 #+begin_src emacs-lisp
673 (use-package markdown-mode)
676 Get it for yourself at https://git.armaanb.net/scdoc
677 #+begin_src emacs-lisp
678 (add-to-list 'load-path "~/Code/scdoc-mode")
679 (autoload 'scdoc-mode "scdoc-mode" "Major mode for editing scdoc files" t)
680 (add-to-list 'auto-mode-alist '("\\.scd\\'" . scdoc-mode))
684 #+begin_src emacs-lisp
685 (use-package ace-window
686 :bind ("M-o" . ace-window))
688 ** Kill current buffer
689 Makes "C-x k" binding faster.
690 #+begin_src emacs-lisp
691 (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
695 #+begin_src emacs-lisp
696 (use-package scad-mode)
698 ** Control backup and lock files
699 Stop backup files from spewing everywhere.
700 #+begin_src emacs-lisp
701 (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
702 create-lockfiles nil)
704 ** Make yes/no easier
705 #+begin_src emacs-lisp
706 (defalias 'yes-or-no-p 'y-or-n-p)
708 ** Move customize file
709 No more clogging up init.el.
710 #+begin_src emacs-lisp
711 (setq custom-file "~/.emacs.d/custom.el")
715 #+begin_src emacs-lisp
717 :commands (helpful-callable helpful-variable helpful-command helpful-key)
719 (counsel-describe-function-function #'helpful-callable)
720 (counsel-describe-variable-function #'helpful-variable)
722 ([remap describe-function] . counsel-describe-function)
723 ([remap describe-command] . helpful-command)
724 ([remap describe-variable] . counsel-describe-variable)
725 ([remap describe-key] . helpful-key))
728 #+begin_src emacs-lisp
729 (use-package epa-file
730 :straight (:type built-in)
732 (epa-file-select-keys nil)
733 (epa-file-encrypt-to '("me@armaanb.net"))
734 (password-cache-expiry (* 60 15)))
736 (use-package pinentry
737 :config (pinentry-start))
740 #+begin_src emacs-lisp
742 :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
743 :custom (0x0-default-service 'envs))
745 *** TODO Replace this with uploading to my own server
746 Similar to the ufile alias in my ashrc
747 ** Automatically clean buffers
748 Automatically close unused buffers (except those of Circe) at midnight.
749 #+begin_src emacs-lisp
751 (add-to-list 'clean-buffer-list-kill-never-regexps (lambda (buffer-name)
752 (with-current-buffer buffer-name
753 (derived-mode-p 'lui-mode))))
757 Spectrwm is a really awesome window manager! Would highly recommend.
759 #+begin_src conf :tangle ~/.spectrwm.conf
763 autorun = ws[1]:/home/armaa/Code/scripts/autostart
766 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.
767 #+begin_src conf :tangle ~/.spectrwm.conf
769 bar_font = xos4 JetBrains Mono:pixelsize=14:antialias=true # any installed font
772 I'm not a huge fan of how spectrwm handles keybindings, probably my biggest gripe with it.
774 #+begin_src conf :tangle ~/.spectrwm.conf
775 program[term] = st -e tmux
776 program[screenshot_all] = flameshot gui
777 program[notif] = /home/armaa/Code/scripts/setter status
778 program[pass] = /home/armaa/Code/scripts/passmenu
781 bind[pass] = MOD+Shift+p
784 #+begin_src conf :tangle ~/.spectrwm.conf
785 program[paup] = /home/armaa/Code/scripts/setter audio +5
786 program[padown] = /home/armaa/Code/scripts/setter audio -5
787 program[pamute] = /home/armaa/Code/scripts/setter audio
788 program[brigup] = /home/armaa/Code/scripts/setter brightness +10%
789 program[brigdown] = /home/armaa/Code/scripts/setter brightness 10%-
790 program[next] = playerctl next
791 program[prev] = playerctl previous
792 program[pause] = playerctl play-pause
794 bind[padown] = XF86AudioLowerVolume
795 bind[paup] = XF86AudioRaiseVolume
796 bind[pamute] = XF86AudioMute
797 bind[brigdown] = XF86MonBrightnessDown
798 bind[brigup] = XF86MonBrightnessUp
799 bind[pause] = XF86AudioPlay
800 bind[next] = XF86AudioNext
801 bind[prev] = XF86AudioPrev
804 #+begin_src conf :tangle ~/.spectrwm.conf
805 program[h] = xdotool keyup h key --clearmodifiers Left
806 program[j] = xdotool keyup j key --clearmodifiers Down
807 program[k] = xdotool keyup k key --clearmodifiers Up
808 program[l] = xdotool keyup l key --clearmodifiers Right
810 bind[h] = MOD + Control + h
811 bind[j] = MOD + Control + j
812 bind[k] = MOD + Control + k
813 bind[l] = MOD + Control + l
816 #+begin_src conf :tangle ~/.spectrwm.conf
817 program[email] = emacsclient -ce '(progn (switch-to-buffer "*scratch*") (mu4e))'
818 program[irc] = emacsclient -ce '(acheam-irc)'
819 program[rss] = emacsclient -ce '(elfeed)'
820 program[calendar] = emacsclient -ce '(acheam-calendar)'
821 program[calc] = emacsclient -ce '(progn (calc) (windmove-up) (delete-window))'
822 program[firefox] = firefox
823 program[emacs] = emacsclient -c
825 bind[email] = MOD+Control+1
826 bind[irc] = MOD+Control+2
827 bind[rss] = MOD+Control+3
828 bind[calendar] = MOD+Control+4
829 bind[calc] = MOD+Control+5
830 bind[firefox] = MOD+Control+0
831 bind[emacs] = MOD+Control+Return
834 Float some specific programs by default.
835 #+begin_src conf :tangle ~/.spectrwm.conf
836 quirk[Castle Menu] = FLOAT
841 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.
842 #+begin_src conf :tangle ~/.config/ash/ashrc
847 #+begin_src shell :tangle ~/.config/ash/ashrc
849 user=$(echo "$1" | cut -f 1 -d '@')
850 host=$(echo "$1" | cut -f 2 -d '@')
851 echo $user | nc "$host" 79
854 **** Upload to ftp.armaanb.net
855 #+begin_src shell :tangle ~/.config/ash/ashrc
857 echo "https://l.armaanb.net/$(basename "$1")" | tee /dev/tty | xclip -sel c
861 rsync "$1" "root@armaanb.net:/var/ftp/pub/$2" --chmod 644
871 xclip -o -sel c >> "$tmp"
872 basetmp=$(echo "$tmp" | tail -c +5)
873 _uup "$tmp" "$basetmp"
879 #+begin_src shell :tangle ~/.config/ash/ashrc
880 export EDITOR="emacsclient -c"
881 export VISUAL="$EDITOR"
882 export TERM=xterm-256color # for compatability
884 export GPG_TTY="$(tty)"
885 export MANPAGER='nvim +Man!'
888 export GTK_USE_PORTAL=1
890 export PATH="/home/armaa/.local/bin:$PATH" # prioritize .local/bin
891 export PATH="/home/armaa/Code/scripts:$PATH" # prioritize my scripts
892 export PATH="/home/armaa/Code/scripts/bin:$PATH" # prioritize my bins
893 export PATH="$PATH:/home/armaa/.cargo/bin"
894 export PATH="$PATH:/home/armaa/.local/share/gem/ruby/2.7.0/bin"
895 export PATH="$PATH:/usr/sbin"
896 export PATH="$PATH:/opt/FreeTube/freetube"
898 export LC_ALL="en_US.UTF-8"
899 export LC_CTYPE="en_US.UTF-8"
900 export LANGUAGE="en_US.UTF-8"
904 export KISS_PATH="/home/armaa/Virtual/kiss/home/armaa/kiss-repo"
905 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/core"
906 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/extra"
907 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/xorg"
908 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/testing"
909 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-community/community"
910 export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
914 #+begin_src shell :tangle ~/.config/ash/ashrc
915 alias bhoji-drop='ssh -p 23 root@armaanb.net'
916 alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
917 alias union='ssh 192.168.1.18'
918 alias mine='ssh -p 23 root@pickupserver.cc'
919 alias tcf='ssh root@204.48.23.68'
920 alias ngmun='ssh root@157.245.89.25'
921 alias prox='ssh root@192.168.1.224'
922 alias ncq='ssh root@143.198.123.17'
923 alias envs='ssh acheam@envs.net'
926 #+begin_src shell :tangle ~/.config/ash/ashrc
927 alias ls='LC_COLLATE=C ls -lh --group-directories-first'
929 alias df='df -h / /boot'
936 alias grep='grep -in'
937 alias mkdir='mkdir -pv'
938 alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar'
939 emacs() { $EDITOR "$@" & }
942 **** System management
943 #+begin_src shell :tangle ~/.config/ash/ashrc
944 alias crontab='crontab-argh'
946 alias pasu='git -C ~/.password-store push'
947 alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
951 #+begin_src shell :tangle ~/.config/ash/ashrc
952 alias ping='ping -c 10'
953 alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
954 alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
955 alias plan='T=$(mktemp) && \
956 rsync root@armaanb.net:/etc/finger/plan.txt "$T" && \
958 head -n -2 $T > $TT && \
961 echo "Last updated: $(date -R)" >> "$TT" && \
962 fold -sw 72 "$TT" > "$T"| \
963 rsync "$T" root@armaanb.net:/etc/finger/plan.txt && \
966 **** Virtual machines, chroots
967 #+begin_src shell :tangle ~/.config/ash/ashrc
968 alias ckiss="doas chrooter ~/Virtual/kiss"
969 alias cdebian="doas chrooter ~/Virtual/debian bash"
970 alias cwindows='devour qemu-system-x86_64 \
975 -device VGA,vgamem_mb=64 \
979 -net user,smb=/home/armaa/Public \
980 -drive format=qcow2,file=/home/armaa/Virtual/windows.qcow2'
983 #+begin_src shell :tangle ~/.config/ash/ashrc
984 alias words='gen-shell -c "words"'
985 alias words-e='gen-shell -c "words ~E"'
988 #+begin_src shell :tangle ~/.config/ash/ashrc
989 alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
991 alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
993 alias ytmusic="youtube-dl -x --add-metadata --audio-format aac \
994 --restrict-filenames -o '%(title)s.%(ext)s'"
998 Make MPV play a little bit smoother.
999 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
1000 ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
1004 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!.
1005 #+begin_src conf :tangle ~/.inputrc
1006 set editing-mode emacs
1010 #+begin_src conf :tangle ~/.gitconfig
1012 name = Armaan Bhojwani
1013 email = me@armaanb.net
1014 signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
1017 #+begin_src conf :tangle ~/.gitconfig
1019 defaultBranch = main
1022 #+begin_src conf :tangle ~/.gitconfig
1027 #+begin_src conf :tangle ~/.gitconfig
1029 smtpserver = smtp.mailbox.org
1030 smtpuser = me@armaanb.net
1031 smtpencryption = ssl
1032 smtpserverport = 465
1036 #+begin_src conf :tangle ~/.gitconfig
1041 #+begin_src conf :tangle ~/.gitconfig
1044 sclone = clone --depth 1
1049 quickfix = commit . --amend --no-edit
1051 subup = submodule update --remote
1052 loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1053 pushnc = push -o skip-ci
1056 #+begin_src conf :tangle ~/.gitconfig
1062 Lightweight notification daemon. Eventually I'd like to replace this with something dbus-less.
1064 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1066 font = "JetBrains Mono Medium Nerd Font 11"
1068 format = "<b>%s</b>\n%b"
1070 indicate_hidden = yes
1073 show_age_threshold = 60
1076 geometry = "400x5-10+10"
1078 idle_threshold = 120
1080 sticky_history = yes
1082 separator_height = 1
1084 horizontal_padding = 8
1086 separator_color = "#ffffff"
1087 startup_notification = false
1090 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1097 close_all = mod4+shift+c
1098 history = mod4+ctrl+c
1101 background = "#222222"
1102 foreground = "#ffffff"
1103 highlight = "#ffffff"
1107 background = "#222222"
1108 foreground = "#ffffff"
1109 highlight = "#ffffff"
1113 background = "#222222"
1114 foreground = "#a60000"
1115 highlight = "#ffffff"
1119 The best document reader!
1121 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1123 map <A-b> toggle_statusbar
1124 set selection-clipboard clipboard
1127 set window-title-basename "true"
1128 set selection-clipboard "clipboard"
1131 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1132 set default-bg "#000000"
1133 set default-fg "#ffffff"
1134 set render-loading true
1135 set render-loading-bg "#000000"
1136 set render-loading-fg "#ffffff"
1138 set recolor-lightcolor "#000000" # bg
1139 set recolor-darkcolor "#ffffff" # fg
1143 Just some basic Firefox CSS. Will probably have to rewrite for the Proton redesign.
1144 *** Swap tab and URL bars
1145 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1147 -moz-box-ordinal-group: 1 !important;
1151 -moz-box-ordinal-group: 2 !important;
1155 -moz-box-ordinal-group: 3 !important;
1158 *** Hide URL bar when not focused.
1159 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1160 #navigator-toolbox:not(:focus-within):not(:hover) {
1164 #navigator-toolbox {
1165 transition: 0.1s margin-top ease-out;
1168 *** Black screen by default
1170 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1173 #browser vbox#appcontent tabbrowser,
1175 #tabbrowser-tabpanels,
1177 browser[type="content-primary"],
1178 browser[type="content"] > html,
1180 background: black !important;
1181 color: #fff !important;
1186 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css
1187 @-moz-document url("about:home"), url("about:blank"), url("about:newtab") {
1189 background: black !important;
1194 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.
1195 #+begin_src conf :tangle ~/.Xresources
1197 ,*.foreground: #ffffff
1198 ,*.background: #000000
1199 ,*.cursorColor: #ffffff
1234 I use tmux in order to keep my st build light. Still learning how it works.
1235 #+begin_src conf :tangle ~/.tmux.conf
1238 set-option -g history-limit 50000
1239 set-window-option -g mode-keys vi
1240 bind-key -T copy-mode-vi 'v' send -X begin-selection
1241 bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1245 #+begin_src conf :tangle ~/.gnupg/gpg.conf
1246 default-key 3C9ED82FFE788E4A
1250 #+begin_src conf :tangle ~/.gnupg/gpg-agent.conf
1251 pinentry-program /sbin/pinentry-gnome3
1253 default-cache-ttl 600
1254 allow-emacs-pinentry
1257 #+begin_src conf :tangle ~/.config/xmodmap
1264 ! Turn right alt into super
1270 ! Swap caps and control
1272 remove Lock = Caps_Lock
1273 remove Control = Control_L
1274 remove Lock = Control_L
1275 remove Control = Caps_Lock
1276 keysym Control_L = Caps_Lock
1277 keysym Caps_Lock = Control_L
1278 add Lock = Caps_Lock
1279 add Control = Control_L