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)
228 (org-ellipsis " â–¾")
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 :bind ("C-c a" . org-agenda))
241 Define templates for lots of common structure elements. Mostly just used within this file.
242 #+begin_src emacs-lisp
243 (use-package org-tempo
245 :straight (:type built-in)
247 ;; TODO: There's gotta be a more efficient way to write this
248 (add-to-list 'org-structure-template-alist '("el" . "src emacs-lisp"))
249 (add-to-list 'org-structure-template-alist '("sp" . "src conf :tangle ~/.spectrwm.conf"))
250 (add-to-list 'org-structure-template-alist '("ash" . "src shell :tangle ~/.config/ash/ashrc"))
251 (add-to-list 'org-structure-template-alist '("pi" . "src conf :tangle ~/.config/picom/picom.conf"))
252 (add-to-list 'org-structure-template-alist '("git" . "src conf :tangle ~/.gitconfig"))
253 (add-to-list 'org-structure-template-alist '("du" . "src conf :tangle ~/.config/dunst/dunstrc"))
254 (add-to-list 'org-structure-template-alist '("za" . "src conf :tangle ~/.config/zathura/zathurarc"))
255 (add-to-list 'org-structure-template-alist '("ff1" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css"))
256 (add-to-list 'org-structure-template-alist '("ff2" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css"))
257 (add-to-list 'org-structure-template-alist '("xr" . "src conf :tangle ~/.Xresources"))
258 (add-to-list 'org-structure-template-alist '("tm" . "src conf :tangle ~/.tmux.conf"))
259 (add-to-list 'org-structure-template-alist '("gp" . "src conf :tangle ~/.gnupg/gpg.conf"))
260 (add-to-list 'org-structure-template-alist '("ag" . "src conf :tangle ~/.gnupg/gpg-agent.conf")))
264 A well balanced completion framework.
265 #+begin_src emacs-lisp
267 :bind (("C-s" . swiper)
268 :map ivy-minibuffer-map
269 ("TAB" . ivy-alt-done)
270 :map ivy-switch-buffer-map
271 ("M-d" . ivy-switch-buffer-kill))
275 #+begin_src emacs-lisp
276 (use-package ivy-rich
278 :config (ivy-rich-mode))
282 #+begin_src emacs-lisp
284 :bind (("C-M-j" . 'counsel-switch-buffer)
285 :map minibuffer-local-map
286 ("C-r" . 'counsel-minibuffer-history))
287 :custom (counsel-linux-app-format-function #'counsel-linux-app-format-function-name-only)
288 :config (counsel-mode))
290 ** Remember frequent commands
291 #+begin_src emacs-lisp
292 (use-package ivy-prescient
294 :custom (ivy-prescient-enable-filtering nil)
296 (prescient-persist-mode)
297 (ivy-prescient-mode))
300 Better search utility.
301 #+begin_src emacs-lisp
306 Use elfeed for reading RSS. I have another file with all the feeds in it that I'd rather keep private.
307 #+begin_src emacs-lisp
309 :bind (("C-c e" . elfeed))
311 (load "~/.emacs.d/feeds.el")
312 (add-hook 'elfeed-new-entry-hook
313 (elfeed-make-tagger :feed-url "youtube\\.com"
315 :bind (:map elfeed-search-mode-map ("C-c C-o" . 'elfeed-show-visit)))
317 (use-package elfeed-goodies
319 :config (elfeed-goodies/setup))
322 Use mu4e for reading emails.
324 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.
326 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.
327 #+begin_src emacs-lisp
328 (use-package smtpmail
329 :straight (:type built-in))
331 :load-path "/usr/share/emacs/site-lisp/mu4e"
332 :straight (:build nil)
333 :bind (("C-c m" . mu4e))
335 (setq user-full-name "Armaan Bhojwani"
336 smtpmail-local-domain "armaanb.net"
337 smtpmail-stream-type 'ssl
338 smtpmail-smtp-service '465
339 mu4e-change-filenames-when-moving t
340 mu4e-get-mail-command "offlineimap -q"
341 message-citation-line-format "On %a %d %b %Y at %R, %f wrote:\n"
342 message-citation-line-function 'message-insert-formatted-citation-line
343 mu4e-completing-read-function 'ivy-completing-read
344 mu4e-confirm-quit nil
346 mail-user-agent 'mu4e-user-agent
347 mail-context-policy 'pick-first
349 `( ,(make-mu4e-context
351 :enter-func (lambda () (mu4e-message "Entering school context"))
352 :leave-func (lambda () (mu4e-message "Leaving school context"))
353 :match-func (lambda (msg)
355 (string-match-p "^/school" (mu4e-message-field msg :maildir))))
356 :vars '((user-mail-address . "abhojwani22@nobles.edu")
357 (mu4e-sent-folder . "/school/Sent")
358 (mu4e-drafts-folder . "/school/Drafts")
359 (mu4e-trash-folder . "/school/Trash")
360 (mu4e-refile-folder . "/school/Archive")
361 (message-cite-reply-position . above)
362 (user-mail-address . "abhojwani22@nobles.edu")
363 (smtpmail-smtp-user . "abhojwani22@nobles.edu")
364 (smtpmail-smtp-server . "smtp.gmail.com")))
367 :enter-func (lambda () (mu4e-message "Entering personal context"))
368 :leave-func (lambda () (mu4e-message "Leaving personal context"))
369 :match-func (lambda (msg)
371 (string-match-p "^/personal" (mu4e-message-field msg :maildir))))
372 :vars '((mu4e-sent-folder . "/personal/Sent")
373 (mu4e-drafts-folder . "/personal/Drafts")
374 (mu4e-trash-folder . "/personal/Trash")
375 (mu4e-refile-folder . "/personal/Archive")
376 (user-mail-address . "me@armaanb.net")
377 (message-cite-reply-position . below)
378 (smtpmail-smtp-user . "me@armaanb.net")
379 (smtpmail-smtp-server . "smtp.mailbox.org")))))
380 (add-to-list 'mu4e-bookmarks
381 '(:name "Unified inbox"
382 :query "maildir:\"/personal/INBOX\" or maildir:\"/school/INBOX\""
384 :hook ((mu4e-compose-mode . flyspell-mode)
385 (mu4e-compose-mode . auto-fill-mode)
386 (mu4e-view-mode-hook . turn-on-visual-line-mode)
387 (message-send-hook . (lambda () (unless (yes-or-no-p "Ya sure 'bout that?")
388 (signal 'quit nil))))))
390 Discourage Gnus from displaying HTML emails
391 #+begin_src emacs-lisp
392 (with-eval-after-load "mm-decode"
393 (add-to-list 'mm-discouraged-alternatives "text/html")
394 (add-to-list 'mm-discouraged-alternatives "text/richtext"))
397 Set EWW as default browser except for multimedia which should open in MPV.
398 #+begin_src emacs-lisp
399 (defun browse-url-mpv (url &optional new-window)
402 (start-process "mpv" "*mpv*" "mpv" url))
404 (setq browse-url-handlers
406 (("youtu\\.?be" . browse-url-mpv)
407 ("peertube.*" . browse-url-mpv)
408 ("vid.*" . browse-url-mpv)
409 ("vid.*" . browse-url-mpv)
410 ("*.mp4" . browse-url-mpv)
411 ("*.mp3" . browse-url-mpv)
412 ("*.ogg" . browse-url-mpv)
413 ("." . eww-browse-url)
417 Some EWW enhancements.
418 *** Give buffer a useful name
419 #+begin_src emacs-lisp
420 ;; From https://protesilaos.com/dotemacs/
421 (defun prot-eww--rename-buffer ()
422 "Rename EWW buffer using page title or URL.
423 To be used by `eww-after-render-hook'."
424 (let ((name (if (eq "" (plist-get eww-data :title))
425 (plist-get eww-data :url)
426 (plist-get eww-data :title))))
427 (rename-buffer (format "*%s # eww*" name) t)))
430 :straight (:type built-in)
431 :bind (("C-c w" . eww))
432 :hook (eww-after-render-hook prot-eww--rename-buffer))
435 #+begin_src emacs-lisp
436 (global-set-key (kbd "C-c w") 'eww)
439 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.
440 #+begin_src emacs-lisp
441 (defun fetch-password (&rest params)
442 (require 'auth-source)
443 (let ((match (car (apply 'auth-source-search params))))
445 (let ((secret (plist-get match :secret)))
446 (if (functionp secret)
449 (error "Password not found for %S" params))))
454 (enable-circe-color-nicks)
455 (setq circe-network-defaults '(("libera"
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"
476 :host "irc.armaanb.net"
481 :pass (lambda (null) (fetch-password
483 :machine "irc.armaanb.net"
488 :custom (circe-default-part-message "goodbye!")
489 :bind (:map circe-mode-map ("C-c C-r" . circe-reconnect-all)))
492 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.
493 #+begin_src emacs-lisp
494 (defun sync-calendar ()
495 "Sync calendars with vdirsyncer"
497 (async-shell-command "vdirsyncer sync"))
500 :bind (:map cfw:calendar-mode-map ("C-S-u" . sync-calendar)))
501 (use-package calfw-ical)
502 (use-package calfw-org)
504 (defun acheam-calendar ()
507 (cfw:open-calendar-buffer
508 :contents-sources (list
509 (cfw:org-create-source "Green")
510 (cfw:ical-create-source
512 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
514 (cfw:ical-create-source
516 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
518 (cfw:ical-create-source
520 "~/.local/share/vdirsyncer/school/abhojwani22@nobles.edu.ics"
524 (global-set-key (kbd "C-c c") 'acheam-calendar)
527 #+begin_src emacs-lisp
528 (use-package pdf-tools
529 :hook (pdf-view-mode . pdf-view-midnight-minor-mode))
533 #+begin_src emacs-lisp
535 :hook (python-mode . blacken-mode)
536 :custom (blacken-line-length 79))
539 ** Strip trailing whitespace
540 #+begin_src emacs-lisp
541 (use-package ws-butler
542 :config (ws-butler-global-mode))
545 Automatic linting. I need to look into configuring this more.
546 #+begin_src emacs-lisp
547 (use-package flycheck
548 :config (global-flycheck-mode))
550 ** Project management
551 I never use this, but apparently its very powerful. Another item on my todo list.
552 #+begin_src emacs-lisp
553 (use-package projectile
554 :config (projectile-mode)
555 :custom ((projectile-completion-system 'ivy))
557 ("C-c p" . projectile-command-map)
559 (when (file-directory-p "~/Code")
560 (setq projectile-project-search-path '("~/Code")))
561 (setq projectile-switch-project-action #'projectile-dired))
563 (use-package counsel-projectile
565 :config (counsel-projectile-mode))
568 The best file manager!
569 #+begin_src emacs-lisp
571 :straight (:type built-in)
572 :commands (dired dired-jump)
573 :custom ((dired-listing-switches "-agho --group-directories-first"))
574 :config (evil-collection-define-key 'normal 'dired-mode-map
575 "h" 'dired-single-up-directory
576 "l" 'dired-single-buffer))
578 (use-package dired-single
579 :commands (dired dired-jump))
581 (use-package dired-open
582 :commands (dired dired-jump)
583 :custom (dired-open-extensions '(("png" . "feh")
586 (use-package dired-hide-dotfiles
587 :hook (dired-mode . dired-hide-dotfiles-mode)
589 (evil-collection-define-key 'normal 'dired-mode-map
590 "H" 'dired-hide-dotfiles-mode))
594 **** TODO Write a command that commits hunk, skipping staging step.
595 A very good Git interface.
596 #+begin_src emacs-lisp
600 #+begin_src emacs-lisp
602 (use-package git-email
603 :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
604 :config (git-email-piem-mode))
606 * General text editing
608 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.
609 #+begin_src emacs-lisp
610 (use-package aggressive-indent
611 :config (global-aggressive-indent-mode))
614 Spell check in text mode, and in prog-mode comments.
615 #+begin_src emacs-lisp
616 (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)
677 #+begin_src emacs-lisp
678 (use-package ace-window
679 :bind ("M-o" . ace-window))
681 ** Kill current buffer
682 Makes "C-x k" binding faster.
683 #+begin_src emacs-lisp
684 (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
688 #+begin_src emacs-lisp
689 (use-package scad-mode)
691 ** Control backup and lock files
692 Stop backup files from spewing everywhere.
693 #+begin_src emacs-lisp
694 (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
695 create-lockfiles nil)
697 ** Make yes/no easier
698 #+begin_src emacs-lisp
699 (defalias 'yes-or-no-p 'y-or-n-p)
701 ** Move customize file
702 No more clogging up init.el.
703 #+begin_src emacs-lisp
704 (setq custom-file "~/.emacs.d/custom.el")
708 #+begin_src emacs-lisp
710 :commands (helpful-callable helpful-variable helpful-command helpful-key)
712 (counsel-describe-function-function #'helpful-callable)
713 (counsel-describe-variable-function #'helpful-variable)
715 ([remap describe-function] . counsel-describe-function)
716 ([remap describe-command] . helpful-command)
717 ([remap describe-variable] . counsel-describe-variable)
718 ([remap describe-key] . helpful-key))
721 #+begin_src emacs-lisp
722 (use-package epa-file
723 :straight (:type built-in)
725 (epa-file-select-keys nil)
726 (epa-file-encrypt-to '("me@armaanb.net"))
727 (password-cache-expiry (* 60 15)))
729 (use-package pinentry
730 :config (pinentry-start))
733 #+begin_src emacs-lisp
735 :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
736 :custom (0x0-default-service 'envs))
738 ** Automatically clean buffers
739 Automatically close unused buffers (except those of Circe) at midnight.
740 #+begin_src emacs-lisp
742 (add-to-list 'clean-buffer-list-kill-never-regexps (lambda (buffer-name)
743 (with-current-buffer buffer-name
744 (derived-mode-p 'lui-mode))))
748 Spectrwm is a really awesome window manager! Would highly recommend.
750 #+begin_src conf :tangle ~/.spectrwm.conf
754 autorun = ws[1]:/home/armaa/Code/scripts/autostart
757 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.
758 #+begin_src conf :tangle ~/.spectrwm.conf
760 bar_font = xos4 JetBrains Mono:pixelsize=14:antialias=true # any installed font
763 I'm not a huge fan of how spectrwm handles keybindings, probably my biggest gripe with it.
765 #+begin_src conf :tangle ~/.spectrwm.conf
766 program[term] = st -e tmux
767 program[screenshot_all] = flameshot gui
768 program[notif] = /home/armaa/Code/scripts/setter status
769 program[pass] = /home/armaa/Code/scripts/passmenu
772 bind[pass] = MOD+Shift+p
775 #+begin_src conf :tangle ~/.spectrwm.conf
776 program[paup] = /home/armaa/Code/scripts/setter audio +5
777 program[padown] = /home/armaa/Code/scripts/setter audio -5
778 program[pamute] = /home/armaa/Code/scripts/setter audio
779 program[brigup] = /home/armaa/Code/scripts/setter brightness +10%
780 program[brigdown] = /home/armaa/Code/scripts/setter brightness 10%-
781 program[next] = playerctl next
782 program[prev] = playerctl previous
783 program[pause] = playerctl play-pause
785 bind[padown] = XF86AudioLowerVolume
786 bind[paup] = XF86AudioRaiseVolume
787 bind[pamute] = XF86AudioMute
788 bind[brigdown] = XF86MonBrightnessDown
789 bind[brigup] = XF86MonBrightnessUp
790 bind[pause] = XF86AudioPlay
791 bind[next] = XF86AudioNext
792 bind[prev] = XF86AudioPrev
795 #+begin_src conf :tangle ~/.spectrwm.conf
796 program[h] = xdotool keyup h key --clearmodifiers Left
797 program[j] = xdotool keyup j key --clearmodifiers Down
798 program[k] = xdotool keyup k key --clearmodifiers Up
799 program[l] = xdotool keyup l key --clearmodifiers Right
801 bind[h] = MOD + Control + h
802 bind[j] = MOD + Control + j
803 bind[k] = MOD + Control + k
804 bind[l] = MOD + Control + l
807 #+begin_src conf :tangle ~/.spectrwm.conf
808 program[email] = emacsclient -ce "(mu4e)"
809 program[irc] = emacsclient -ce '(switch-to-buffer "irc.armaanb.net:6698")'
810 program[rss] = emacsclient -ce '(elfeed)'
811 program[calendar] = emacsclient -ce '(acheam-calendar)'
812 program[calc] = emacsclient -ce '(progn (calc) (windmove-up) (delete-window))'
813 program[firefox] = firefox
814 program[emacs] = emacsclient -c
816 bind[email] = MOD+Control+1
817 bind[irc] = MOD+Control+2
818 bind[rss] = MOD+Control+3
819 bind[calendar] = MOD+Control+4
820 bind[calc] = MOD+Control+5
821 bind[firefox] = MOD+Control+0
822 bind[emacs] = MOD+Control+Return
825 Float some specific programs by default.
826 #+begin_src conf :tangle ~/.spectrwm.conf
827 quirk[Castle Menu] = FLOAT
832 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.
833 #+begin_src conf :tangle ~/.config/ash/ashrc
837 **** Interact with 0x0
838 #+begin_src shell :tangle ~/.config/ash/ashrc
839 zxz="https://envs.sh"
840 ufile() { curl -F"file=@$1" "$zxz" ; }
841 upb() { curl -F"file=@-;" "$zxz" ; }
842 uurl() { curl -F"url=$1" "$zxz" ; }
843 ushort() { curl -F"shorten=$1" "$zxz" ; }
844 uclip() { xclip -out | curl -F"file=@-;" "$zxz" ; }
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 rsync "$1" "root@armaanb.net:/var/ftp/pub/${2}"
858 echo "https://ftp.armaanb.net/pub/"$(basename "$1") | tee /dev/tty | xclip -sel c
862 #+begin_src shell :tangle ~/.config/ash/ashrc
863 export EDITOR="emacsclient -c"
864 export VISUAL="$EDITOR"
865 export TERM=xterm-256color # for compatability
867 export GPG_TTY="$(tty)"
868 export MANPAGER='nvim +Man!'
871 export GTK_USE_PORTAL=1
873 export PATH="/home/armaa/.local/bin:$PATH" # prioritize .local/bin
874 export PATH="/home/armaa/Code/scripts:$PATH" # prioritize my scripts
875 export PATH="/home/armaa/Code/scripts/bin:$PATH" # prioritize my bins
876 export PATH="$PATH:/home/armaa/.cargo/bin"
877 export PATH="$PATH:/home/armaa/.local/share/gem/ruby/2.7.0/bin"
878 export PATH="$PATH:/usr/sbin"
879 export PATH="$PATH:/opt/FreeTube/freetube"
881 export LC_ALL="en_US.UTF-8"
882 export LC_CTYPE="en_US.UTF-8"
883 export LANGUAGE="en_US.UTF-8"
885 export KISS_PATH="/home/armaa/Virtual/kiss/home/armaa/kiss-repo"
886 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/core"
887 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/extra"
888 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/xorg"
889 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/testing"
890 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-community/community"
891 export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
895 #+begin_src shell :tangle ~/.config/ash/ashrc
896 alias bhoji-drop='ssh -p 23 root@armaanb.net'
897 alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
898 alias union='ssh 192.168.1.18'
899 alias mine='ssh -p 23 root@pickupserver.cc'
900 alias tcf='ssh root@204.48.23.68'
901 alias ngmun='ssh root@157.245.89.25'
902 alias prox='ssh root@192.168.1.224'
903 alias ncq='ssh root@143.198.123.17'
904 alias envs='ssh acheam@envs.net'
907 #+begin_src shell :tangle ~/.config/ash/ashrc
908 alias ls='ls -lh --group-directories-first'
910 alias df='df -h / /boot'
917 alias grep='grep -in'
918 alias mkdir='mkdir -pv'
919 alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar'
920 emacs() { $EDITOR "$@" & }
923 **** System management
924 #+begin_src shell :tangle ~/.config/ash/ashrc
925 alias crontab='crontab-argh'
927 alias pasu='git -C ~/.password-store push'
928 alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
932 #+begin_src shell :tangle ~/.config/ash/ashrc
933 alias ping='ping -c 10'
934 alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
935 alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
936 alias plan='T=$(mktemp) && \
937 rsync root@armaanb.net:/etc/finger/plan.txt "$T" && \
939 head -n -2 $T > $TT && \
941 echo "\nLast updated: $(date -R)" >> "$TT" && \
942 fold -sw 72 "$TT" > "$T"| \
943 rsync "$T" root@armaanb.net:/etc/finger/plan.txt'
945 **** Virtual machines, chroots
946 #+begin_src shell :tangle ~/.config/ash/ashrc
947 alias ckiss="doas chrooter ~/Virtual/kiss"
948 alias cdebian="doas chrooter ~/Virtual/debian bash"
949 alias cwindows='devour qemu-system-x86_64 \
954 -device VGA,vgamem_mb=64 \
958 -net user,smb=/home/armaa/Public \
959 -drive format=qcow2,file=/home/armaa/Virtual/windows.qcow2'
962 #+begin_src shell :tangle ~/.config/ash/ashrc
963 alias words='gen-shell -c "words"'
964 alias words-e='gen-shell -c "words ~E"'
967 #+begin_src shell :tangle ~/.config/ash/ashrc
968 alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
970 alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
972 alias ytmusic="youtube-dl -x --add-metadata --audio-format aac \
973 --restrict-filenames -o '%(title)s.%(ext)s'"
977 Make MPV play a little bit smoother.
978 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
979 ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
983 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!.
984 #+begin_src conf :tangle ~/.inputrc
985 set editing-mode emacs
989 #+begin_src conf :tangle ~/.gitconfig
991 name = Armaan Bhojwani
992 email = me@armaanb.net
993 signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
996 #+begin_src conf :tangle ~/.gitconfig
1001 #+begin_src conf :tangle ~/.gitconfig
1006 #+begin_src conf :tangle ~/.gitconfig
1008 smtpserver = smtp.mailbox.org
1009 smtpuser = me@armaanb.net
1010 smtpencryption = ssl
1011 smtpserverport = 465
1015 #+begin_src conf :tangle ~/.gitconfig
1020 #+begin_src conf :tangle ~/.gitconfig
1023 sclone = clone --depth 1
1028 quickfix = commit . --amend --no-edit
1030 subup = submodule update --remote
1031 loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1032 pushnc = push -o skip-ci
1035 #+begin_src conf :tangle ~/.gitconfig
1041 Lightweight notification daemon. Eventually I'd like to replace this with something dbus-less.
1043 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1045 font = "JetBrains Mono Medium Nerd Font 11"
1047 format = "<b>%s</b>\n%b"
1049 indicate_hidden = yes
1052 show_age_threshold = 60
1055 geometry = "400x5-10+10"
1057 idle_threshold = 120
1059 sticky_history = yes
1061 separator_height = 1
1063 horizontal_padding = 8
1065 separator_color = "#ffffff"
1066 startup_notification = false
1069 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1076 close_all = mod4+shift+c
1077 history = mod4+ctrl+c
1080 background = "#222222"
1081 foreground = "#ffffff"
1082 highlight = "#ffffff"
1086 background = "#222222"
1087 foreground = "#ffffff"
1088 highlight = "#ffffff"
1092 background = "#222222"
1093 foreground = "#a60000"
1094 highlight = "#ffffff"
1098 The best document reader!
1100 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1102 map <A-b> toggle_statusbar
1103 set selection-clipboard clipboard
1106 set window-title-basename "true"
1107 set selection-clipboard "clipboard"
1110 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1111 set default-bg "#000000"
1112 set default-fg "#ffffff"
1113 set render-loading true
1114 set render-loading-bg "#000000"
1115 set render-loading-fg "#ffffff"
1117 set recolor-lightcolor "#000000" # bg
1118 set recolor-darkcolor "#ffffff" # fg
1122 Just some basic Firefox CSS. Will probably have to rewrite for the Proton redesign.
1123 *** Swap tab and URL bars
1124 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1126 -moz-box-ordinal-group: 1 !important;
1130 -moz-box-ordinal-group: 2 !important;
1134 -moz-box-ordinal-group: 3 !important;
1137 *** Hide URL bar when not focused.
1138 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1139 #navigator-toolbox:not(:focus-within):not(:hover) {
1143 #navigator-toolbox {
1144 transition: 0.1s margin-top ease-out;
1147 *** Black screen by default
1149 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1152 #browser vbox#appcontent tabbrowser,
1154 #tabbrowser-tabpanels,
1156 browser[type="content-primary"],
1157 browser[type="content"] > html,
1159 background: black !important;
1160 color: #fff !important;
1165 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css
1166 @-moz-document url("about:home"), url("about:blank"), url("about:newtab") {
1168 background: black !important;
1173 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.
1174 #+begin_src conf :tangle ~/.Xresources
1176 ,*.foreground: #ffffff
1177 ,*.background: #000000
1178 ,*.cursorColor: #ffffff
1213 I use tmux in order to keep my st build light. Still learning how it works.
1214 #+begin_src conf :tangle ~/.tmux.conf
1217 set-option -g history-limit 50000
1218 set-window-option -g mode-keys vi
1219 bind-key -T copy-mode-vi 'v' send -X begin-selection
1220 bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1224 #+begin_src conf :tangle ~/.gnupg/gpg.conf
1225 default-key 3C9ED82FFE788E4A
1229 #+begin_src conf :tangle ~/.gnupg/gpg-agent.conf
1230 pinentry-program /sbin/pinentry-gnome3
1232 default-cache-ttl 600
1233 allow-emacs-pinentry