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 *** TODO Turn keybinding and hook declarations into use-package declarations where possible
18 *** TODO Include offlineimap config
20 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.
22 ** Bootstrap straight.el
23 straight.el is really nice for managing package, and it integrates nicely with use-package. It uses the bootstrapping system defined here for installation.
24 #+begin_src emacs-lisp
25 (defvar native-comp-deferred-compilation-deny-list ())
26 (defvar bootstrap-version)
28 (expand-file-name "straight/repos/straight.el/bootstrap.el" user-emacs-directory))
29 (bootstrap-version 5))
30 (unless (file-exists-p bootstrap-file)
32 (url-retrieve-synchronously
33 "https://raw.githubusercontent.com/raxod502/straight.el/develop/install.el"
34 'silent 'inhibit-cookies)
35 (goto-char (point-max))
36 (eval-print-last-sexp)))
37 (load bootstrap-file nil 'nomessage))
39 ** Replace package.el with straight
40 #+begin_src emacs-lisp
41 (straight-use-package 'use-package)
42 (setq straight-use-package-by-default t)
46 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.
47 #+begin_src emacs-lisp
48 (setq modus-themes-slanted-constructs t
49 modus-themes-bold-constructs t
50 modus-themes-mode-line '3d
51 modus-themes-scale-headings t
52 modus-themes-diffs 'desaturated)
53 (load-theme 'modus-vivendi t)
57 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]].
58 #+begin_src emacs-lisp
59 (add-to-list 'default-frame-alist '(font . "JetBrainsMonoNF-12"))
62 #+begin_src emacs-lisp
64 :straight (ligature :type git :host github :repo "mickeynp/ligature.el")
66 (ligature-set-ligatures
67 '(prog-mode text-mode)
68 '("-|" "-~" "---" "-<<" "-<" "--" "->" "->>" "-->" "/=" "/=="
69 "/>" "//" "/*" "*>" "*/" "<-" "<<-" "<=>" "<=" "<|" "<||"
70 "<|||" "<|>" "<:" "<>" "<-<" "<<<" "<==" "<<=" "<=<" "<==>"
71 "<-|" "<<" "<~>" "<=|" "<~~" "<~" "<$>" "<$" "<+>" "<+" "</>"
72 "</" "<*" "<*>" "<->" "<!--" ":>" ":<" ":::" "::" ":?" ":?>"
73 ":=" "::=" "=>>" "==>" "=/=" "=!=" "=>" "===" "=:=" "==" "!=="
74 "!!" "!=" ">]" ">:" ">>-" ">>=" ">=>" ">>>" ">-" ">=" "&&&"
75 "&&" "|||>" "||>" "|>" "|]" "|}" "|=>" "|->" "|=" "||-" "|-"
76 "||=" "||" ".." ".?" ".=" ".-" "..<" "..." "+++" "+>" "++"
77 "[||]" "[<" "[|" "{|" "?." "?=" "?:" "##" "###" "####" "#["
78 "#{" "#=" "#!" "#:" "#_(" "#_" "#?" "#(" ";;" "_|_" "__" "~~"
79 "~~>" "~>" "~-" "~@" "$>" "^=" "]#"))
80 (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 Show a ruler at a certain number of chars depending on mode.
119 #+begin_src emacs-lisp
120 (setq display-fill-column-indicator-column 80)
121 (global-display-fill-column-indicator-mode)
123 ** Highlight todo items in comments
124 #+begin_src emacs-lisp
126 :straight (hl-todo :type git :host github :repo "tarsius/hl-todo")
127 :config (global-hl-todo-mode 1))
130 #+begin_src emacs-lisp
134 Soft wrap words and do operations by visual lines except in programming modes.
135 #+begin_src emacs-lisp
136 (global-visual-line-mode 1)
137 (dolist (hook '(prog-mode-hook
140 mu4e-headers-mode-hook))
141 (add-hook hook (lambda () (visual-line-mode -1))))
143 ** Display number of matches in search
144 #+begin_src emacs-lisp
146 :config (global-anzu-mode)
148 ([remap query-replace] . anzu-query-replace)
149 ([remap query-replace-regexp] . anzu-query-replace-regexp))
152 Invert modeline color instead of audible bell or the standard visual bell.
153 #+begin_src emacs-lisp
154 (setq visible-bell nil
156 (lambda () (invert-face 'mode-line)
157 (run-with-timer 0.1 nil #'invert-face 'mode-line)))
161 #+begin_src emacs-lisp
163 :custom (select-enable-clipboard nil)
166 (fset 'evil-visual-update-x-selection 'ignore) ;; Keep clipboard and register seperate
167 ;; Use visual line motions even outside of visual-line-mode buffers
168 (evil-global-set-key 'motion "j" 'evil-next-visual-line)
169 (evil-global-set-key 'motion "k" 'evil-previous-visual-line)
170 (global-set-key (kbd "<escape>") 'keyboard-escape-quit))
173 Evil bindings for tons of packages.
174 #+begin_src emacs-lisp
175 (use-package evil-collection
177 :init (evil-collection-init)
178 :custom (evil-collection-setup-minibuffer t))
182 #+begin_src emacs-lisp
183 (use-package evil-surround
184 :config (global-evil-surround-mode))
187 Makes commenting super easy
188 #+begin_src emacs-lisp
189 (use-package evil-nerd-commenter
190 :bind (:map evil-normal-state-map
191 ("gc" . evilnc-comment-or-uncomment-lines))
192 :custom (evilnc-invert-comment-line-by-line nil))
196 #+begin_src emacs-lisp
197 (evil-set-undo-system 'undo-redo)
199 ** Number incrementing
200 Add back C-a/C-x bindings.
201 #+begin_src emacs-lisp
202 (use-package evil-numbers
203 :straight (evil-numbers :type git :host github :repo "juliapath/evil-numbers")
204 :bind (:map evil-normal-state-map
205 ("C-M-a" . evil-numbers/inc-at-pt)
206 ("C-M-x" . evil-numbers/dec-at-pt)))
209 #+begin_src emacs-lisp
210 (use-package evil-org
212 :hook (org-mode . evil-org-mode)
214 (evil-org-set-key-theme '(textobjects insert navigation shift todo)))
216 (use-package evil-org-agenda
217 :straight (:type built-in)
219 :config (evil-org-agenda-set-keys))
223 #+begin_src emacs-lisp
225 :straight (:type built-in)
226 :commands (org-capture org-agenda)
229 (org-agenda-start-with-log-mode t)
230 (org-agenda-files (quote ("~/Org/tasks.org" "~/Org/break.org")))
232 (org-log-into-drawer t)
233 (org-src-tab-acts-natively t)
234 (org-src-fontify-natively t)
235 (org-startup-indented t)
236 (org-hide-emphasis-markers t)
237 (org-fontify-whole-block-delimiter-line nil)
238 (org-archive-default-command 'org-archive-to-archive-sibling)
240 ("C-c a" . org-agenda)
241 (:map evil-normal-state-map ("ga" . org-archive-subtree-default)))
244 Define templates for lots of common structure elements. Mostly just used within this file.
245 #+begin_src emacs-lisp
246 (use-package org-tempo
248 :straight (:type built-in)
250 (dolist (addition '(("el" . "src emacs-lisp")
251 ("el" . "src emacs-lisp")
252 ("sp" . "src conf :tangle ~/.spectrwm.conf")
253 ("ash" . "src shell :tangle ~/.config/ash/ashrc")
254 ("pi" . "src conf :tangle ~/.config/picom/picom.conf")
255 ("git" . "src conf :tangle ~/.gitconfig")
256 ("du" . "src conf :tangle ~/.config/dunst/dunstrc")
257 ("za" . "src conf :tangle ~/.config/zathura/zathurarc")
258 ("ff1" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css")
259 ("ff2" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css")
260 ("xr" . "src conf :tangle ~/.Xresources")
261 ("tm" . "src conf :tangle ~/.tmux.conf")
262 ("gp" . "src conf :tangle ~/.gnupg/gpg.conf")
263 ("ag" . "src conf :tangle ~/.gnupg/gpg-agent.conf")))
264 (add-to-list 'org-structure-template-alist addition)))
268 A well balanced completion framework.
269 #+begin_src emacs-lisp
271 :bind (("C-s" . swiper)
272 :map ivy-minibuffer-map
273 ("TAB" . ivy-alt-done)
274 :map ivy-switch-buffer-map
275 ("M-d" . ivy-switch-buffer-kill))
279 #+begin_src emacs-lisp
280 (use-package ivy-rich
282 :config (ivy-rich-mode))
286 #+begin_src emacs-lisp
288 :bind (("C-M-j" . 'counsel-switch-buffer)
289 :map minibuffer-local-map
290 ("C-r" . 'counsel-minibuffer-history))
291 :custom (counsel-linux-app-format-function #'counsel-linux-app-format-function-name-only)
292 :config (counsel-mode))
294 ** Remember frequent commands
295 #+begin_src emacs-lisp
296 (use-package ivy-prescient
298 :custom (ivy-prescient-enable-filtering nil)
300 (prescient-persist-mode)
301 (ivy-prescient-mode))
304 Better search utility.
305 #+begin_src emacs-lisp
310 Use elfeed for reading RSS. I have another file with all the feeds in it that I'd rather keep private.
311 #+begin_src emacs-lisp
313 :bind (("C-c e" . elfeed))
315 (load "~/.emacs.d/feeds.el")
316 (add-hook 'elfeed-new-entry-hook
317 (elfeed-make-tagger :feed-url "youtube\\.com"
319 :bind (:map elfeed-search-mode-map ("C-c C-o" . 'elfeed-show-visit)))
321 (use-package elfeed-goodies
323 :config (elfeed-goodies/setup))
326 Use mu4e for reading emails.
328 I use `offlineimap` to sync my maildirs. It is slower than mbsync, but is fast enough for me, especially when ran with the =-q= option.
330 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.
331 #+begin_src emacs-lisp
332 (use-package smtpmail
333 :straight (:type built-in))
335 :load-path "/usr/share/emacs/site-lisp/mu4e"
336 :straight (:build nil)
337 :bind (("C-c m" . mu4e))
339 (setq user-full-name "Armaan Bhojwani"
340 smtpmail-local-domain "armaanb.net"
341 smtpmail-stream-type 'ssl
342 smtpmail-smtp-service '465
343 mu4e-change-filenames-when-moving t
344 mu4e-get-mail-command "offlineimap -q"
345 message-citation-line-format "On %a %d %b %Y at %R, %f wrote:\n"
346 message-citation-line-function 'message-insert-formatted-citation-line
347 mu4e-completing-read-function 'ivy-completing-read
348 mu4e-confirm-quit nil
350 mail-user-agent 'mu4e-user-agent
351 mail-context-policy 'pick-first
353 `( ,(make-mu4e-context
355 :enter-func (lambda () (mu4e-message "Entering school context"))
356 :leave-func (lambda () (mu4e-message "Leaving school context"))
357 :match-func (lambda (msg)
359 (string-match-p "^/school" (mu4e-message-field msg :maildir))))
360 :vars '((user-mail-address . "abhojwani22@nobles.edu")
361 (mu4e-sent-folder . "/school/Sent")
362 (mu4e-drafts-folder . "/school/Drafts")
363 (mu4e-trash-folder . "/school/Trash")
364 (mu4e-refile-folder . "/school/Archive")
365 (message-cite-reply-position . above)
366 (user-mail-address . "abhojwani22@nobles.edu")
367 (smtpmail-smtp-user . "abhojwani22@nobles.edu")
368 (smtpmail-smtp-server . "smtp.gmail.com")))
371 :enter-func (lambda () (mu4e-message "Entering personal context"))
372 :leave-func (lambda () (mu4e-message "Leaving personal context"))
373 :match-func (lambda (msg)
375 (string-match-p "^/personal" (mu4e-message-field msg :maildir))))
376 :vars '((mu4e-sent-folder . "/personal/Sent")
377 (mu4e-drafts-folder . "/personal/Drafts")
378 (mu4e-trash-folder . "/personal/Trash")
379 (mu4e-refile-folder . "/personal/Archive")
380 (user-mail-address . "me@armaanb.net")
381 (message-cite-reply-position . below)
382 (smtpmail-smtp-user . "me@armaanb.net")
383 (smtpmail-smtp-server . "smtp.mailbox.org")))))
384 (add-to-list 'mu4e-bookmarks
385 '(:name "Unified inbox"
386 :query "maildir:\"/personal/INBOX\" or maildir:\"/school/INBOX\""
388 :hook ((mu4e-compose-mode . flyspell-mode)
389 (mu4e-compose-mode . auto-fill-mode)
390 (mu4e-view-mode-hook . turn-on-visual-line-mode)
391 (message-send-hook . (lambda () (unless (yes-or-no-p "Ya sure 'bout that?")
392 (signal 'quit nil))))))
394 Discourage Gnus from displaying HTML emails
395 #+begin_src emacs-lisp
396 (with-eval-after-load "mm-decode"
397 (add-to-list 'mm-discouraged-alternatives "text/html")
398 (add-to-list 'mm-discouraged-alternatives "text/richtext"))
401 Set EWW as default browser except for multimedia which should open in MPV.
402 #+begin_src emacs-lisp
403 (defun browse-url-mpv (url &optional new-window)
406 (start-process "mpv" "*mpv*" "mpv" url))
408 (setq browse-url-handlers
410 (("youtu\\.?be" . browse-url-mpv)
411 ("peertube.*" . browse-url-mpv)
412 ("vid.*" . browse-url-mpv)
413 ("vid.*" . browse-url-mpv)
414 ("*.mp4" . browse-url-mpv)
415 ("*.mp3" . browse-url-mpv)
416 ("*.ogg" . browse-url-mpv)
417 ("." . eww-browse-url)
421 Some EWW enhancements.
422 *** Give buffer a useful name
423 #+begin_src emacs-lisp
424 ;; From https://protesilaos.com/dotemacs/
425 (defun prot-eww--rename-buffer ()
426 "Rename EWW buffer using page title or URL.
427 To be used by `eww-after-render-hook'."
428 (let ((name (if (eq "" (plist-get eww-data :title))
429 (plist-get eww-data :url)
430 (plist-get eww-data :title))))
431 (rename-buffer (format "*%s # eww*" name) t)))
434 :straight (:type built-in)
435 :bind (("C-c w" . eww))
436 :hook (eww-after-render-hook prot-eww--rename-buffer))
439 #+begin_src emacs-lisp
440 (global-set-key (kbd "C-c w") 'eww)
443 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.
444 #+begin_src emacs-lisp
445 (defun fetch-password (&rest params)
446 (require 'auth-source)
447 (let ((match (car (apply 'auth-source-search params))))
449 (let ((secret (plist-get match :secret)))
450 (if (functionp secret)
453 (error "Password not found for %S" params))))
458 (enable-circe-color-nicks)
459 (setq circe-network-defaults '(("libera"
460 :host "irc.armaanb.net"
465 :pass (lambda (null) (fetch-password
467 :machine "irc.armaanb.net"
470 :host "irc.armaanb.net"
475 :pass (lambda (null) (fetch-password
477 :machine "irc.armaanb.net"
480 :host "irc.armaanb.net"
485 :pass (lambda (null) (fetch-password
487 :machine "irc.armaanb.net"
489 :custom (circe-default-part-message "goodbye!")
490 :bind (:map circe-mode-map ("C-c C-r" . circe-reconnect-all)))
495 (if (get-buffer "irc.armaanb.net:6696")
496 (switch-to-buffer "irc.armaanb.net:6696")
497 (progn (circe "libera")
501 (global-set-key (kbd "C-c i") 'acheam-irc)
504 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.
505 #+begin_src emacs-lisp
506 (defun sync-calendar ()
507 "Sync calendars with vdirsyncer"
509 (async-shell-command "vdirsyncer sync"))
512 :bind (:map cfw:calendar-mode-map ("C-S-u" . sync-calendar)))
513 (use-package calfw-ical)
514 (use-package calfw-org)
516 (defun acheam-calendar ()
519 (cfw:open-calendar-buffer
520 :contents-sources (list
521 (cfw:org-create-source "Green")
522 (cfw:ical-create-source
524 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
526 (cfw:ical-create-source
528 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
530 (cfw:ical-create-source
532 "~/.local/share/vdirsyncer/school/abhojwani22@nobles.edu.ics"
536 (global-set-key (kbd "C-c c") 'acheam-calendar)
539 #+begin_src emacs-lisp
540 (use-package pdf-tools
541 :hook (pdf-view-mode . pdf-view-midnight-minor-mode))
545 #+begin_src emacs-lisp
547 :hook (python-mode . blacken-mode)
548 :custom (blacken-line-length 79))
551 ** Strip trailing whitespace
552 #+begin_src emacs-lisp
553 (use-package ws-butler
554 :config (ws-butler-global-mode))
557 Automatic linting. I need to look into configuring this more.
558 #+begin_src emacs-lisp
559 (use-package flycheck
560 :config (global-flycheck-mode))
562 ** Project management
563 I never use this, but apparently its very powerful. Another item on my todo list.
564 #+begin_src emacs-lisp
565 (use-package projectile
566 :config (projectile-mode)
567 :custom ((projectile-completion-system 'ivy))
569 ("C-c p" . projectile-command-map)
571 (when (file-directory-p "~/Code")
572 (setq projectile-project-search-path '("~/Code")))
573 (setq projectile-switch-project-action #'projectile-dired))
575 (use-package counsel-projectile
577 :config (counsel-projectile-mode))
580 The best file manager!
581 #+begin_src emacs-lisp
583 :straight (:type built-in)
584 :commands (dired dired-jump)
585 :custom ((dired-listing-switches "-agho --group-directories-first"))
586 :config (evil-collection-define-key 'normal 'dired-mode-map
587 "h" 'dired-single-up-directory
588 "l" 'dired-single-buffer))
590 (use-package dired-single
591 :commands (dired dired-jump))
593 (use-package dired-open
594 :commands (dired dired-jump)
595 :custom (dired-open-extensions '(("png" . "feh")
598 (use-package dired-hide-dotfiles
599 :hook (dired-mode . dired-hide-dotfiles-mode)
601 (evil-collection-define-key 'normal 'dired-mode-map
602 "H" 'dired-hide-dotfiles-mode))
606 **** TODO Write a command that commits hunk, skipping staging step.
607 A very good Git interface.
608 #+begin_src emacs-lisp
612 #+begin_src emacs-lisp
614 (use-package git-email
615 :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
616 :config (git-email-piem-mode))
618 * General text editing
620 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.
621 #+begin_src emacs-lisp
622 (use-package aggressive-indent
623 :config (global-aggressive-indent-mode))
626 Spell check in text mode, and in prog-mode comments.
627 #+begin_src emacs-lisp
628 (dolist (hook '(text-mode-hook))
629 (add-hook hook (lambda () (flyspell-mode))))
630 (dolist (hook '(change-log-mode-hook log-edit-mode-hook))
631 (add-hook hook (lambda () (flyspell-mode -1))))
632 (add-hook 'prog-mode (lambda () (flyspell-prog mode)))
633 (setq ispell-silently-savep t)
636 #+begin_src emacs-lisp
637 (setq-default tab-width 2)
640 Opens file where you left it.
641 #+begin_src emacs-lisp
645 Distraction free writing a la junegunn/goyo.
646 #+begin_src emacs-lisp
647 (use-package olivetti
648 :bind ("C-c o" . olivetti-mode))
651 Abbreviate things! I just use this for things like my email address and copyright notice.
652 #+begin_src emacs-lisp
653 (setq abbrev-file-name "~/.emacs.d/abbrevs.el")
654 (setq save-abbrevs 'silent)
655 (setq-default abbrev-mode t)
658 #+begin_src emacs-lisp
659 (setq tramp-default-method "ssh")
661 ** Follow version controlled symlinks
662 #+begin_src emacs-lisp
663 (setq vc-follow-symlinks t)
666 #+begin_src emacs-lisp
667 (defun doas-edit (&optional arg)
668 "Edit currently visited file as root.
670 With a prefix ARG prompt for a file to visit.
671 Will also prompt for a file to visit if current
672 buffer is not visiting a file.
674 Modified from Emacs Redux."
676 (if (or arg (not buffer-file-name))
677 (find-file (concat "/doas:root@localhost:"
678 (ido-read-file-name "Find file(as root): ")))
679 (find-alternate-file (concat "/doas:root@localhost:" buffer-file-name))))
681 (global-set-key (kbd "C-x C-r") #'doas-edit)
684 #+begin_src emacs-lisp
685 (use-package markdown-mode)
689 #+begin_src emacs-lisp
690 (use-package ace-window
691 :bind ("M-o" . ace-window))
693 ** Kill current buffer
694 Makes "C-x k" binding faster.
695 #+begin_src emacs-lisp
696 (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
700 #+begin_src emacs-lisp
701 (use-package scad-mode)
703 ** Control backup and lock files
704 Stop backup files from spewing everywhere.
705 #+begin_src emacs-lisp
706 (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
707 create-lockfiles nil)
709 ** Make yes/no easier
710 #+begin_src emacs-lisp
711 (defalias 'yes-or-no-p 'y-or-n-p)
713 ** Move customize file
714 No more clogging up init.el.
715 #+begin_src emacs-lisp
716 (setq custom-file "~/.emacs.d/custom.el")
720 #+begin_src emacs-lisp
722 :commands (helpful-callable helpful-variable helpful-command helpful-key)
724 (counsel-describe-function-function #'helpful-callable)
725 (counsel-describe-variable-function #'helpful-variable)
727 ([remap describe-function] . counsel-describe-function)
728 ([remap describe-command] . helpful-command)
729 ([remap describe-variable] . counsel-describe-variable)
730 ([remap describe-key] . helpful-key))
733 #+begin_src emacs-lisp
734 (use-package epa-file
735 :straight (:type built-in)
737 (epa-file-select-keys nil)
738 (epa-file-encrypt-to '("me@armaanb.net"))
739 (password-cache-expiry (* 60 15)))
741 (use-package pinentry
742 :config (pinentry-start))
745 #+begin_src emacs-lisp
747 :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
748 :custom (0x0-default-service 'envs))
750 ** Automatically clean buffers
751 Automatically close unused buffers (except those of Circe) at midnight.
752 #+begin_src emacs-lisp
754 (add-to-list 'clean-buffer-list-kill-never-regexps (lambda (buffer-name)
755 (with-current-buffer buffer-name
756 (derived-mode-p 'lui-mode))))
760 Spectrwm is a really awesome window manager! Would highly recommend.
762 #+begin_src conf :tangle ~/.spectrwm.conf
766 autorun = ws[1]:/home/armaa/Code/scripts/autostart
769 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.
770 #+begin_src conf :tangle ~/.spectrwm.conf
772 bar_font = xos4 JetBrains Mono:pixelsize=14:antialias=true # any installed font
775 I'm not a huge fan of how spectrwm handles keybindings, probably my biggest gripe with it.
777 #+begin_src conf :tangle ~/.spectrwm.conf
778 program[term] = st -e tmux
779 program[screenshot_all] = flameshot gui
780 program[notif] = /home/armaa/Code/scripts/setter status
781 program[pass] = /home/armaa/Code/scripts/passmenu
784 bind[pass] = MOD+Shift+p
787 #+begin_src conf :tangle ~/.spectrwm.conf
788 program[paup] = /home/armaa/Code/scripts/setter audio +5
789 program[padown] = /home/armaa/Code/scripts/setter audio -5
790 program[pamute] = /home/armaa/Code/scripts/setter audio
791 program[brigup] = /home/armaa/Code/scripts/setter brightness +10%
792 program[brigdown] = /home/armaa/Code/scripts/setter brightness 10%-
793 program[next] = playerctl next
794 program[prev] = playerctl previous
795 program[pause] = playerctl play-pause
797 bind[padown] = XF86AudioLowerVolume
798 bind[paup] = XF86AudioRaiseVolume
799 bind[pamute] = XF86AudioMute
800 bind[brigdown] = XF86MonBrightnessDown
801 bind[brigup] = XF86MonBrightnessUp
802 bind[pause] = XF86AudioPlay
803 bind[next] = XF86AudioNext
804 bind[prev] = XF86AudioPrev
807 #+begin_src conf :tangle ~/.spectrwm.conf
808 program[h] = xdotool keyup h key --clearmodifiers Left
809 program[j] = xdotool keyup j key --clearmodifiers Down
810 program[k] = xdotool keyup k key --clearmodifiers Up
811 program[l] = xdotool keyup l key --clearmodifiers Right
813 bind[h] = MOD + Control + h
814 bind[j] = MOD + Control + j
815 bind[k] = MOD + Control + k
816 bind[l] = MOD + Control + l
819 #+begin_src conf :tangle ~/.spectrwm.conf
820 program[email] = emacsclient -ce "(mu4e)"
821 program[irc] = emacsclient -ce '(acheam-irc)'
822 program[rss] = emacsclient -ce '(elfeed)'
823 program[calendar] = emacsclient -ce '(acheam-calendar)'
824 program[calc] = emacsclient -ce '(progn (calc) (windmove-up) (delete-window))'
825 program[firefox] = firefox
826 program[emacs] = emacsclient -c
828 bind[email] = MOD+Control+1
829 bind[irc] = MOD+Control+2
830 bind[rss] = MOD+Control+3
831 bind[calendar] = MOD+Control+4
832 bind[calc] = MOD+Control+5
833 bind[firefox] = MOD+Control+0
834 bind[emacs] = MOD+Control+Return
837 Float some specific programs by default.
838 #+begin_src conf :tangle ~/.spectrwm.conf
839 quirk[Castle Menu] = FLOAT
844 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.
845 #+begin_src conf :tangle ~/.config/ash/ashrc
850 #+begin_src shell :tangle ~/.config/ash/ashrc
852 user=$(echo "$1" | cut -f 1 -d '@')
853 host=$(echo "$1" | cut -f 2 -d '@')
854 echo $user | nc "$host" 79
857 **** Upload to ftp.armaanb.net
858 #+begin_src shell :tangle ~/.config/ash/ashrc
860 echo "https://l.armaanb.net/$(basename "$1")" | tee /dev/tty | xclip -sel c
864 rsync "$1" "root@armaanb.net:/var/ftp/pub/$2" --chmod 644
874 xclip -o -sel c >> "$tmp"
875 basetmp=$(echo "$tmp" | tail -c +5)
876 _uup "$tmp" "$basetmp"
882 #+begin_src shell :tangle ~/.config/ash/ashrc
883 export EDITOR="emacsclient -c"
884 export VISUAL="$EDITOR"
885 export TERM=xterm-256color # for compatability
887 export GPG_TTY="$(tty)"
888 export MANPAGER='nvim +Man!'
891 export GTK_USE_PORTAL=1
893 export PATH="/home/armaa/.local/bin:$PATH" # prioritize .local/bin
894 export PATH="/home/armaa/Code/scripts:$PATH" # prioritize my scripts
895 export PATH="/home/armaa/Code/scripts/bin:$PATH" # prioritize my bins
896 export PATH="$PATH:/home/armaa/.cargo/bin"
897 export PATH="$PATH:/home/armaa/.local/share/gem/ruby/2.7.0/bin"
898 export PATH="$PATH:/usr/sbin"
899 export PATH="$PATH:/opt/FreeTube/freetube"
901 export LC_ALL="en_US.UTF-8"
902 export LC_CTYPE="en_US.UTF-8"
903 export LANGUAGE="en_US.UTF-8"
905 export KISS_PATH="/home/armaa/Virtual/kiss/home/armaa/kiss-repo"
906 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/core"
907 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/extra"
908 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/xorg"
909 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/testing"
910 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-community/community"
911 export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
915 #+begin_src shell :tangle ~/.config/ash/ashrc
916 alias bhoji-drop='ssh -p 23 root@armaanb.net'
917 alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
918 alias union='ssh 192.168.1.18'
919 alias mine='ssh -p 23 root@pickupserver.cc'
920 alias tcf='ssh root@204.48.23.68'
921 alias ngmun='ssh root@157.245.89.25'
922 alias prox='ssh root@192.168.1.224'
923 alias ncq='ssh root@143.198.123.17'
924 alias envs='ssh acheam@envs.net'
927 #+begin_src shell :tangle ~/.config/ash/ashrc
928 alias ls='ls -lh --group-directories-first'
930 alias df='df -h / /boot'
937 alias grep='grep -in'
938 alias mkdir='mkdir -pv'
939 alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar'
940 emacs() { $EDITOR "$@" & }
943 **** System management
944 #+begin_src shell :tangle ~/.config/ash/ashrc
945 alias crontab='crontab-argh'
947 alias pasu='git -C ~/.password-store push'
948 alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
952 #+begin_src shell :tangle ~/.config/ash/ashrc
953 alias ping='ping -c 10'
954 alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
955 alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
956 alias plan='T=$(mktemp) && \
957 rsync root@armaanb.net:/etc/finger/plan.txt "$T" && \
959 head -n -2 $T > $TT && \
962 echo "Last updated: $(date -R)" >> "$TT" && \
963 fold -sw 72 "$TT" > "$T"| \
964 rsync "$T" root@armaanb.net:/etc/finger/plan.txt && \
967 **** Virtual machines, chroots
968 #+begin_src shell :tangle ~/.config/ash/ashrc
969 alias ckiss="doas chrooter ~/Virtual/kiss"
970 alias cdebian="doas chrooter ~/Virtual/debian bash"
971 alias cwindows='devour qemu-system-x86_64 \
976 -device VGA,vgamem_mb=64 \
980 -net user,smb=/home/armaa/Public \
981 -drive format=qcow2,file=/home/armaa/Virtual/windows.qcow2'
984 #+begin_src shell :tangle ~/.config/ash/ashrc
985 alias words='gen-shell -c "words"'
986 alias words-e='gen-shell -c "words ~E"'
989 #+begin_src shell :tangle ~/.config/ash/ashrc
990 alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
992 alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
994 alias ytmusic="youtube-dl -x --add-metadata --audio-format aac \
995 --restrict-filenames -o '%(title)s.%(ext)s'"
999 Make MPV play a little bit smoother.
1000 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
1001 ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
1005 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!.
1006 #+begin_src conf :tangle ~/.inputrc
1007 set editing-mode emacs
1011 #+begin_src conf :tangle ~/.gitconfig
1013 name = Armaan Bhojwani
1014 email = me@armaanb.net
1015 signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
1018 #+begin_src conf :tangle ~/.gitconfig
1020 defaultBranch = main
1023 #+begin_src conf :tangle ~/.gitconfig
1028 #+begin_src conf :tangle ~/.gitconfig
1030 smtpserver = smtp.mailbox.org
1031 smtpuser = me@armaanb.net
1032 smtpencryption = ssl
1033 smtpserverport = 465
1037 #+begin_src conf :tangle ~/.gitconfig
1042 #+begin_src conf :tangle ~/.gitconfig
1045 sclone = clone --depth 1
1050 quickfix = commit . --amend --no-edit
1052 subup = submodule update --remote
1053 loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1054 pushnc = push -o skip-ci
1057 #+begin_src conf :tangle ~/.gitconfig
1063 Lightweight notification daemon. Eventually I'd like to replace this with something dbus-less.
1065 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1067 font = "JetBrains Mono Medium Nerd Font 11"
1069 format = "<b>%s</b>\n%b"
1071 indicate_hidden = yes
1074 show_age_threshold = 60
1077 geometry = "400x5-10+10"
1079 idle_threshold = 120
1081 sticky_history = yes
1083 separator_height = 1
1085 horizontal_padding = 8
1087 separator_color = "#ffffff"
1088 startup_notification = false
1091 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1098 close_all = mod4+shift+c
1099 history = mod4+ctrl+c
1102 background = "#222222"
1103 foreground = "#ffffff"
1104 highlight = "#ffffff"
1108 background = "#222222"
1109 foreground = "#ffffff"
1110 highlight = "#ffffff"
1114 background = "#222222"
1115 foreground = "#a60000"
1116 highlight = "#ffffff"
1120 The best document reader!
1122 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1124 map <A-b> toggle_statusbar
1125 set selection-clipboard clipboard
1128 set window-title-basename "true"
1129 set selection-clipboard "clipboard"
1132 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1133 set default-bg "#000000"
1134 set default-fg "#ffffff"
1135 set render-loading true
1136 set render-loading-bg "#000000"
1137 set render-loading-fg "#ffffff"
1139 set recolor-lightcolor "#000000" # bg
1140 set recolor-darkcolor "#ffffff" # fg
1144 Just some basic Firefox CSS. Will probably have to rewrite for the Proton redesign.
1145 *** Swap tab and URL bars
1146 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1148 -moz-box-ordinal-group: 1 !important;
1152 -moz-box-ordinal-group: 2 !important;
1156 -moz-box-ordinal-group: 3 !important;
1159 *** Hide URL bar when not focused.
1160 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1161 #navigator-toolbox:not(:focus-within):not(:hover) {
1165 #navigator-toolbox {
1166 transition: 0.1s margin-top ease-out;
1169 *** Black screen by default
1171 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1174 #browser vbox#appcontent tabbrowser,
1176 #tabbrowser-tabpanels,
1178 browser[type="content-primary"],
1179 browser[type="content"] > html,
1181 background: black !important;
1182 color: #fff !important;
1187 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css
1188 @-moz-document url("about:home"), url("about:blank"), url("about:newtab") {
1190 background: black !important;
1195 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.
1196 #+begin_src conf :tangle ~/.Xresources
1198 ,*.foreground: #ffffff
1199 ,*.background: #000000
1200 ,*.cursorColor: #ffffff
1235 I use tmux in order to keep my st build light. Still learning how it works.
1236 #+begin_src conf :tangle ~/.tmux.conf
1239 set-option -g history-limit 50000
1240 set-window-option -g mode-keys vi
1241 bind-key -T copy-mode-vi 'v' send -X begin-selection
1242 bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1246 #+begin_src conf :tangle ~/.gnupg/gpg.conf
1247 default-key 3C9ED82FFE788E4A
1251 #+begin_src conf :tangle ~/.gnupg/gpg-agent.conf
1252 pinentry-program /sbin/pinentry-gnome3
1254 default-cache-ttl 600
1255 allow-emacs-pinentry