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)
124 When starting a key chord, show possible future steps after 0.3 seconds.
125 #+begin_src emacs-lisp
126 (use-package which-key
127 :config (which-key-mode)
128 :custom (which-key-idle-delay 0.3))
130 ** Highlight todo items in comments
131 #+begin_src emacs-lisp
133 :straight (hl-todo :type git :host github :repo "tarsius/hl-todo")
134 :config (global-hl-todo-mode 1))
137 #+begin_src emacs-lisp
141 Soft wrap words and do operations by visual lines except in programming modes.
142 #+begin_src emacs-lisp
143 (global-visual-line-mode 1)
144 (dolist (hook '(prog-mode-hook
146 mu4e-headers-mode-hook))
147 (add-hook hook (lambda () (visual-line-mode -1))))
149 ** Display number of matches in search
150 #+begin_src emacs-lisp
152 :config (global-anzu-mode))
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 :bind ("C-c a" . org-agenda))
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 ;; TODO: There's gotta be a more efficient way to write this
251 (add-to-list 'org-structure-template-alist '("el" . "src emacs-lisp"))
252 (add-to-list 'org-structure-template-alist '("sp" . "src conf :tangle ~/.spectrwm.conf"))
253 (add-to-list 'org-structure-template-alist '("ash" . "src shell :tangle ~/.config/ash/ashrc"))
254 (add-to-list 'org-structure-template-alist '("ipy" . "src python :tangle ~/.ipython/"))
255 (add-to-list 'org-structure-template-alist '("pi" . "src conf :tangle ~/.config/picom/picom.conf"))
256 (add-to-list 'org-structure-template-alist '("git" . "src conf :tangle ~/.gitconfig"))
257 (add-to-list 'org-structure-template-alist '("du" . "src conf :tangle ~/.config/dunst/dunstrc"))
258 (add-to-list 'org-structure-template-alist '("za" . "src conf :tangle ~/.config/zathura/zathurarc"))
259 (add-to-list 'org-structure-template-alist '("ff1" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css"))
260 (add-to-list 'org-structure-template-alist '("ff2" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css"))
261 (add-to-list 'org-structure-template-alist '("xr" . "src conf :tangle ~/.Xresources"))
262 (add-to-list 'org-structure-template-alist '("tm" . "src conf :tangle ~/.tmux.conf"))
263 (add-to-list 'org-structure-template-alist '("gp" . "src conf :tangle ~/.gnupg/gpg.conf"))
264 (add-to-list 'org-structure-template-alist '("ag" . "src conf :tangle ~/.gnupg/gpg-agent.conf")))
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"
492 :custom (circe-default-part-message "goodbye!")
493 :bind (:map circe-mode-map ("C-c C-r" . circe-reconnect-all)))
496 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.
497 #+begin_src emacs-lisp
498 (defun sync-calendar ()
499 "Sync calendars with vdirsyncer"
501 (shell-command "vdirsyncer -vcritical sync"))
504 :bind (:map cfw:calendar-mode-map ("C-S-u" . sync-calendar)))
505 (use-package calfw-ical)
506 (use-package calfw-org)
508 (defun acheam-calendar ()
511 (cfw:open-calendar-buffer
512 :contents-sources (list
513 (cfw:org-create-source "Green")
514 (cfw:ical-create-source
516 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
518 (cfw:ical-create-source
520 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
522 (cfw:ical-create-source
524 "~/.local/share/vdirsyncer/school/abhojwani22@nobles.edu.ics"
528 (global-set-key (kbd "C-c c") 'acheam-calendar)
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 **** TODO Write a command that commits hunk, skipping staging step.
594 A very good Git interface.
595 #+begin_src emacs-lisp
599 #+begin_src emacs-lisp
601 (use-package git-email
602 :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
603 :config (git-email-piem-mode))
605 * General text editing
607 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.
608 #+begin_src emacs-lisp
609 (use-package aggressive-indent
610 :config (global-aggressive-indent-mode))
613 Spell check in text mode, and in prog-mode comments.
614 #+begin_src emacs-lisp
615 (dolist (hook '(text-mode-hook))
616 (add-hook hook (lambda () (flyspell-mode))))
617 (dolist (hook '(change-log-mode-hook log-edit-mode-hook))
618 (add-hook hook (lambda () (flyspell-mode -1))))
619 (add-hook 'prog-mode (lambda () (flyspell-prog mode)))
620 (setq ispell-silently-savep t)
623 #+begin_src emacs-lisp
624 (setq-default tab-width 2)
627 Opens file where you left it.
628 #+begin_src emacs-lisp
632 Distraction free writing a la junegunn/goyo.
633 #+begin_src emacs-lisp
634 (use-package olivetti
635 :bind ("C-c o" . olivetti-mode))
638 Abbreviate things! I just use this for things like my email address and copyright notice.
639 #+begin_src emacs-lisp
640 (setq abbrev-file-name "~/.emacs.d/abbrevs.el")
641 (setq save-abbrevs 'silent)
642 (setq-default abbrev-mode t)
645 #+begin_src emacs-lisp
646 (setq tramp-default-method "ssh")
648 ** Follow version controlled symlinks
649 #+begin_src emacs-lisp
650 (setq vc-follow-symlinks t)
653 #+begin_src emacs-lisp
654 (defun doas-edit (&optional arg)
655 "Edit currently visited file as root.
657 With a prefix ARG prompt for a file to visit.
658 Will also prompt for a file to visit if current
659 buffer is not visiting a file.
661 Modified from Emacs Redux."
663 (if (or arg (not buffer-file-name))
664 (find-file (concat "/doas:root@localhost:"
665 (ido-read-file-name "Find file(as root): ")))
666 (find-alternate-file (concat "/doas:root@localhost:" buffer-file-name))))
668 (global-set-key (kbd "C-x C-r") #'doas-edit)
671 #+begin_src emacs-lisp
672 (use-package markdown-mode)
676 #+begin_src emacs-lisp
677 (use-package ace-window
678 :bind ("M-o" . ace-window))
680 ** Kill current buffer
681 Makes "C-x k" binding faster.
682 #+begin_src emacs-lisp
683 (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
687 #+begin_src emacs-lisp
688 (use-package scad-mode)
690 ** Control backup and lock files
691 Stop backup files from spewing everywhere.
692 #+begin_src emacs-lisp
693 (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
694 create-lockfiles nil)
696 ** Make yes/no easier
697 #+begin_src emacs-lisp
698 (defalias 'yes-or-no-p 'y-or-n-p)
700 ** Move customize file
701 No more clogging up init.el.
702 #+begin_src emacs-lisp
703 (setq custom-file "~/.emacs.d/custom.el")
707 #+begin_src emacs-lisp
709 :commands (helpful-callable helpful-variable helpful-command helpful-key)
711 (counsel-describe-function-function #'helpful-callable)
712 (counsel-describe-variable-function #'helpful-variable)
714 ([remap describe-function] . counsel-describe-function)
715 ([remap describe-command] . helpful-command)
716 ([remap describe-variable] . counsel-describe-variable)
717 ([remap describe-key] . helpful-key))
720 #+begin_src emacs-lisp
721 (use-package epa-file
722 :straight (:type built-in)
724 (epa-file-select-keys nil)
725 (epa-file-encrypt-to '("me@armaanb.net"))
726 (password-cache-expiry (* 60 15)))
728 (use-package pinentry
729 :config (pinentry-start))
732 #+begin_src emacs-lisp
734 :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
735 :custom (0x0-default-service 'envs))
737 ** Automatically clean buffers
738 Automatically close unused buffers (except those of Circe) at midnight.
739 #+begin_src emacs-lisp
741 (add-to-list 'clean-buffer-list-kill-never-regexps (lambda (buffer-name)
742 (with-current-buffer buffer-name
743 (derived-mode-p 'lui-mode))))
747 Spectrwm is a really awesome window manager! Would highly recommend.
749 #+begin_src conf :tangle ~/.spectrwm.conf
753 autorun = ws[1]:/home/armaa/Code/scripts/autostart
756 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.
757 #+begin_src conf :tangle ~/.spectrwm.conf
759 bar_font = xos4 JetBrains Mono:pixelsize=14:antialias=true # any installed font
762 I'm not a huge fan of how spectrwm handles keybindings, probably my biggest gripe with it.
764 #+begin_src conf :tangle ~/.spectrwm.conf
765 program[term] = st -e tmux
766 program[screenshot_all] = flameshot gui
767 program[notif] = /home/armaa/Code/scripts/setter status
768 program[pass] = /home/armaa/Code/scripts/passmenu
771 bind[pass] = MOD+Shift+p
774 #+begin_src conf :tangle ~/.spectrwm.conf
775 program[paup] = /home/armaa/Code/scripts/setter audio +5
776 program[padown] = /home/armaa/Code/scripts/setter audio -5
777 program[pamute] = /home/armaa/Code/scripts/setter audio
778 program[brigup] = /home/armaa/Code/scripts/setter brightness +10%
779 program[brigdown] = /home/armaa/Code/scripts/setter brightness 10%-
780 program[next] = playerctl next
781 program[prev] = playerctl previous
782 program[pause] = playerctl play-pause
784 bind[padown] = XF86AudioLowerVolume
785 bind[paup] = XF86AudioRaiseVolume
786 bind[pamute] = XF86AudioMute
787 bind[brigdown] = XF86MonBrightnessDown
788 bind[brigup] = XF86MonBrightnessUp
789 bind[pause] = XF86AudioPlay
790 bind[next] = XF86AudioNext
791 bind[prev] = XF86AudioPrev
794 #+begin_src conf :tangle ~/.spectrwm.conf
795 program[h] = xdotool keyup h key --clearmodifiers Left
796 program[j] = xdotool keyup j key --clearmodifiers Down
797 program[k] = xdotool keyup k key --clearmodifiers Up
798 program[l] = xdotool keyup l key --clearmodifiers Right
800 bind[h] = MOD + Control + h
801 bind[j] = MOD + Control + j
802 bind[k] = MOD + Control + k
803 bind[l] = MOD + Control + l
806 #+begin_src conf :tangle ~/.spectrwm.conf
807 program[email] = emacsclient -ce "(mu4e)"
808 program[irc] = emacsclient -ce '(switch-to-buffer "irc.armaanb.net:6698")'
809 program[rss] = emacsclient -ce '(elfeed)'
810 program[calendar] = emacsclient -ce '(acheam-calendar)'
811 program[calc] = emacsclient -ce '(progn (calc) (windmove-up) (delete-window))'
812 program[firefox] = firefox
813 program[emacs] = emacsclient -c
815 bind[email] = MOD+Control+1
816 bind[irc] = MOD+Control+2
817 bind[rss] = MOD+Control+3
818 bind[calendar] = MOD+Control+4
819 bind[calc] = MOD+Control+5
820 bind[firefox] = MOD+Control+0
821 bind[emacs] = MOD+Control+Return
824 Float some specific programs by default.
825 #+begin_src conf :tangle ~/.spectrwm.conf
826 quirk[Castle Menu] = FLOAT
831 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.
832 #+begin_src conf :tangle ~/.config/ash/ashrc
836 **** Update all packages
837 #+begin_src shell :tangle ~/.config/ash/ashrc
838 color=$(tput setaf 5)
842 doas echo "${color}== upgrading with yay ==${reset}"
845 echo "${color}== checking for pacnew files ==${reset}"
848 echo "${color}== upgrading flatpaks ==${reset}"
851 echo "${color}== updating nvim plugins ==${reset}"
852 nvim +PlugUpdate +PlugUpgrade +qall
853 echo "Updated nvim plugins"
855 echo "${color}You are entirely up to date!${reset}"
858 **** Clean all packages
859 #+begin_src shell :tangle ~/.config/ash/ashrc
861 doas echo "${color}== cleaning pacman orphans ==${reset}"
862 (pacman -Qtdq | doas pacman -Rns - 2> /dev/null) || echo "No orphans"
864 echo "${color}== cleaning flatpaks ==${reset}"
865 flatpak remove --unused
867 echo "${color}== cleaning nvim plugins ==${reset}"
868 nvim +PlugClean +qall
869 echo "Cleaned nvim plugins"
871 echo "${color}All orphans cleaned!${reset}"
874 **** Interact with 0x0
875 #+begin_src shell :tangle ~/.config/ash/ashrc
876 zxz="https://envs.sh"
877 ufile() { curl -F"file=@$1" "$zxz" ; }
878 upb() { curl -F"file=@-;" "$zxz" ; }
879 uurl() { curl -F"url=$1" "$zxz" ; }
880 ushort() { curl -F"shorten=$1" "$zxz" ; }
881 uclip() { xclip -out | curl -F"file=@-;" "$zxz" ; }
884 #+begin_src shell :tangle ~/.config/ash/ashrc
886 user=$(echo "$1" | cut -f 1 -d '@')
887 host=$(echo "$1" | cut -f 2 -d '@')
888 echo $user | nc "$host" 79
891 **** Upload to ftp.armaanb.net
892 #+begin_src shell :tangle ~/.config/ash/ashrc
894 rsync "$1" "root@armaanb.net:/var/ftp/pub/${2}"
895 echo "https://ftp.armaanb.net/pub/"$(basename "$1") | tee /dev/tty | xclip -sel c
899 #+begin_src shell :tangle ~/.config/ash/ashrc
900 export EDITOR="emacsclient -c"
901 export VISUAL="$EDITOR"
902 export TERM=xterm-256color # for compatability
904 export GPG_TTY="$(tty)"
905 export MANPAGER='nvim +Man!'
908 export GTK_USE_PORTAL=1
910 export PATH="/home/armaa/.local/bin:$PATH" # prioritize .local/bin
911 export PATH="/home/armaa/Code/scripts:$PATH" # prioritize my scripts
912 export PATH="/home/armaa/Code/scripts/bin:$PATH" # prioritize my bins
913 export PATH="$PATH:/home/armaa/.cargo/bin"
914 export PATH="$PATH:/home/armaa/.local/share/gem/ruby/2.7.0/bin"
915 export PATH="$PATH:/usr/sbin"
916 export PATH="$PATH:/opt/FreeTube/freetube"
918 export LC_ALL="en_US.UTF-8"
919 export LC_CTYPE="en_US.UTF-8"
920 export LANGUAGE="en_US.UTF-8"
922 export KISS_PATH="/home/armaa/Virtual/kiss/home/armaa/kiss-repo"
923 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/core"
924 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/extra"
925 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/xorg"
926 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/testing"
927 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-community/community"
928 export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
932 #+begin_src shell :tangle ~/.config/ash/ashrc
933 alias bhoji-drop='ssh -p 23 root@armaanb.net'
934 alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
935 alias union='ssh 192.168.1.18'
936 alias mine='ssh -p 23 root@pickupserver.cc'
937 alias tcf='ssh root@204.48.23.68'
938 alias ngmun='ssh root@157.245.89.25'
939 alias prox='ssh root@192.168.1.224'
940 alias ncq='ssh root@143.198.123.17'
941 alias envs='ssh acheam@envs.net'
944 #+begin_src shell :tangle ~/.config/ash/ashrc
945 alias ls='ls -lh --group-directories-first'
947 alias df='df -h / /boot'
954 alias grep='grep -in --color=auto'
955 alias mkdir='mkdir -pv'
956 alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar'
957 emacs() { $EDITOR "$@" & }
960 **** System management
961 #+begin_src shell :tangle ~/.config/ash/ashrc
962 alias crontab='crontab-argh'
964 alias pasu='git -C ~/.password-store push'
965 alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
969 #+begin_src shell :tangle ~/.config/ash/ashrc
970 alias ping='ping -c 10'
971 alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
972 alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
973 alias plan='T=$(mktemp) && \
974 rsync root@armaanb.net:/etc/finger/plan.txt "$T" && \
976 head -n -2 $T > $TT && \
978 echo "\nLast updated: $(date -R)" >> "$TT" && \
979 fold -sw 72 "$TT" > "$T"| \
980 rsync "$T" root@armaanb.net:/etc/finger/plan.txt'
982 **** Virtual machines, chroots
983 #+begin_src shell :tangle ~/.config/ash/ashrc
984 alias ckiss="doas chrooter ~/Virtual/kiss"
985 alias cdebian="doas chrooter ~/Virtual/debian bash"
986 alias cwindows='devour qemu-system-x86_64 \
991 -device VGA,vgamem_mb=64 \
995 -net user,smb=/home/armaa/Public \
996 -drive format=qcow2,file=/home/armaa/Virtual/windows.qcow2'
999 #+begin_src shell :tangle ~/.config/ash/ashrc
1000 alias pip="python -m pip"
1001 alias black="black -l 79"
1004 #+begin_src shell :tangle ~/.config/ash/ashrc
1005 alias words='gen-shell -c "words"'
1006 alias words-e='gen-shell -c "words ~E"'
1009 #+begin_src shell :tangle ~/.config/ash/ashrc
1010 alias zathura='devour zathura'
1011 alias cad='devour openscad'
1012 alias feh='devour feh'
1015 #+begin_src shell :tangle ~/.config/ash/ashrc
1017 alias api='yay -Syu'
1018 alias apii='doas pacman -S'
1019 alias app='yay -Rns'
1020 alias azf='pacman -Q | fzf'
1021 alias favorites='pacman -Qe | cut -d " " -f 1 > ~/Documents/favorites'
1024 #+begin_src shell :tangle ~/.config/ash/ashrc
1025 alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
1026 iflag=fullblock status=progress'
1027 alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
1028 iflag=fullblock status=progress'
1029 alias ytmusic="youtube-dl -x --add-metadata --audio-format aac \
1030 --restrict-filenames -o '%(title)s.%(ext)s'"
1031 alias cal="cal -3 --color=auto"
1035 #+begin_src python :tangle ~/.ipython/profile_default/ipython_config.py
1036 c.TerminalInteractiveShell.editing_mode = 'vi'
1037 c.InteractiveShell.colors = 'linux'
1038 c.TerminalInteractiveShell.confirm_exit = False
1041 Make MPV play a little bit smoother.
1042 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
1043 ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
1047 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!.
1048 #+begin_src conf :tangle ~/.inputrc
1049 set editing-mode emacs
1053 #+begin_src conf :tangle ~/.gitconfig
1055 name = Armaan Bhojwani
1056 email = me@armaanb.net
1057 signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
1060 #+begin_src conf :tangle ~/.gitconfig
1062 defaultBranch = main
1065 #+begin_src conf :tangle ~/.gitconfig
1070 #+begin_src conf :tangle ~/.gitconfig
1072 smtpserver = smtp.mailbox.org
1073 smtpuser = me@armaanb.net
1074 smtpencryption = ssl
1075 smtpserverport = 465
1079 #+begin_src conf :tangle ~/.gitconfig
1084 #+begin_src conf :tangle ~/.gitconfig
1087 sclone = clone --depth 1
1092 quickfix = commit . --amend --no-edit
1094 subup = submodule update --remote
1095 loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1096 pushnc = push -o skip-ci
1099 #+begin_src conf :tangle ~/.gitconfig
1105 Lightweight notification daemon. Eventually I'd like to replace this with something dbus-less.
1107 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1109 font = "JetBrains Mono Medium Nerd Font 11"
1111 format = "<b>%s</b>\n%b"
1113 indicate_hidden = yes
1116 show_age_threshold = 60
1119 geometry = "400x5-10+10"
1121 idle_threshold = 120
1123 sticky_history = yes
1125 separator_height = 1
1127 horizontal_padding = 8
1129 separator_color = "#ffffff"
1130 startup_notification = false
1133 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1140 close_all = mod4+shift+c
1141 history = mod4+ctrl+c
1144 background = "#222222"
1145 foreground = "#ffffff"
1146 highlight = "#ffffff"
1150 background = "#222222"
1151 foreground = "#ffffff"
1152 highlight = "#ffffff"
1156 background = "#222222"
1157 foreground = "#a60000"
1158 highlight = "#ffffff"
1162 The best document reader!
1164 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1166 map <A-b> toggle_statusbar
1167 set selection-clipboard clipboard
1170 set window-title-basename "true"
1171 set selection-clipboard "clipboard"
1174 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1175 set default-bg "#000000"
1176 set default-fg "#ffffff"
1177 set render-loading true
1178 set render-loading-bg "#000000"
1179 set render-loading-fg "#ffffff"
1181 set recolor-lightcolor "#000000" # bg
1182 set recolor-darkcolor "#ffffff" # fg
1186 Just some basic Firefox CSS. Will probably have to rewrite for the Proton redesign.
1187 *** Swap tab and URL bars
1188 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1190 -moz-box-ordinal-group: 1 !important;
1194 -moz-box-ordinal-group: 2 !important;
1198 -moz-box-ordinal-group: 3 !important;
1201 *** Hide URL bar when not focused.
1202 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1203 #navigator-toolbox:not(:focus-within):not(:hover) {
1207 #navigator-toolbox {
1208 transition: 0.1s margin-top ease-out;
1211 *** Black screen by default
1213 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1216 #browser vbox#appcontent tabbrowser,
1218 #tabbrowser-tabpanels,
1220 browser[type="content-primary"],
1221 browser[type="content"] > html,
1223 background: black !important;
1224 color: #fff !important;
1229 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css
1230 @-moz-document url("about:home"), url("about:blank"), url("about:newtab") {
1232 background: black !important;
1237 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.
1238 #+begin_src conf :tangle ~/.Xresources
1240 ,*.foreground: #ffffff
1241 ,*.background: #000000
1242 ,*.cursorColor: #ffffff
1277 I use tmux in order to keep my st build light. Still learning how it works.
1278 #+begin_src conf :tangle ~/.tmux.conf
1281 set-option -g history-limit 50000
1282 set-window-option -g mode-keys vi
1283 bind-key -T copy-mode-vi 'v' send -X begin-selection
1284 bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1288 #+begin_src conf :tangle ~/.gnupg/gpg.conf
1289 default-key 3C9ED82FFE788E4A
1293 #+begin_src conf :tangle ~/.gnupg/gpg-agent.conf
1294 pinentry-program /sbin/pinentry-gnome3
1296 default-cache-ttl 600
1297 allow-emacs-pinentry