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.
23 This is temporary until some stuff gets fixed upstream
24 #+begin_src emacs-lisp
25 (setq straight-repository-branch "develop")
26 (setq straight-disable-native-compile t)
28 ** Bootstrap straight.el
29 straight.el is really nice for managing package, and it integrates nicely with use-package. It uses the bootstrapping system defined here for installation.
30 #+begin_src emacs-lisp
31 (defvar bootstrap-version)
33 (expand-file-name "straight/repos/straight.el/bootstrap.el" user-emacs-directory))
34 (bootstrap-version 5))
35 (unless (file-exists-p bootstrap-file)
37 (url-retrieve-synchronously
38 "https://raw.githubusercontent.com/raxod502/straight.el/develop/install.el"
39 'silent 'inhibit-cookies)
40 (goto-char (point-max))
41 (eval-print-last-sexp)))
42 (load bootstrap-file nil 'nomessage))
44 ** Replace package.el with straight
45 #+begin_src emacs-lisp
46 (straight-use-package 'use-package)
47 (setq straight-use-package-by-default t)
51 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.
52 #+begin_src emacs-lisp
53 (setq modus-themes-slanted-constructs t
54 modus-themes-bold-constructs t
55 modus-themes-mode-line '3d
56 modus-themes-scale-headings t
57 modus-themes-diffs 'desaturated)
58 (load-theme 'modus-vivendi t)
62 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]].
63 #+begin_src emacs-lisp
64 (add-to-list 'default-frame-alist '(font . "JetBrainsMonoNF-12"))
67 #+begin_src emacs-lisp
69 :straight (ligature :type git :host github :repo "mickeynp/ligature.el")
71 (ligature-set-ligatures
72 '(prog-mode text-mode)
73 '("-|" "-~" "---" "-<<" "-<" "--" "->" "->>" "-->" "/=" "/=="
74 "/>" "//" "/*" "*>" "*/" "<-" "<<-" "<=>" "<=" "<|" "<||"
75 "<|||" "<|>" "<:" "<>" "<-<" "<<<" "<==" "<<=" "<=<" "<==>"
76 "<-|" "<<" "<~>" "<=|" "<~~" "<~" "<$>" "<$" "<+>" "<+" "</>"
77 "</" "<*" "<*>" "<->" "<!--" ":>" ":<" ":::" "::" ":?" ":?>"
78 ":=" "::=" "=>>" "==>" "=/=" "=!=" "=>" "===" "=:=" "==" "!=="
79 "!!" "!=" ">]" ">:" ">>-" ">>=" ">=>" ">>>" ">-" ">=" "&&&"
80 "&&" "|||>" "||>" "|>" "|]" "|}" "|=>" "|->" "|=" "||-" "|-"
81 "||=" "||" ".." ".?" ".=" ".-" "..<" "..." "+++" "+>" "++"
82 "[||]" "[<" "[|" "{|" "?." "?=" "?:" "##" "###" "####" "#["
83 "#{" "#=" "#!" "#:" "#_(" "#_" "#?" "#(" ";;" "_|_" "__" "~~"
84 "~~>" "~>" "~-" "~@" "$>" "^=" "]#"))
85 (global-ligature-mode t))
88 Display relative line numbers except in certain modes.
89 #+begin_src emacs-lisp
90 (global-display-line-numbers-mode)
91 (setq display-line-numbers-type 'relative)
92 (dolist (no-line-num '(term-mode-hook
97 (add-hook no-line-num (lambda () (display-line-numbers-mode 0))))
99 ** Highlight matching parenthesis
100 #+begin_src emacs-lisp
102 :config (show-paren-mode)
103 :custom (show-paren-style 'parenthesis))
106 *** Show current function
107 #+begin_src emacs-lisp
108 (which-function-mode)
110 *** Make position in file more descriptive
111 Show current column and file size.
112 #+begin_src emacs-lisp
114 (size-indication-mode)
117 #+begin_src emacs-lisp
119 :config (minions-mode))
122 Show a ruler at a certain number of chars depending on mode.
123 #+begin_src emacs-lisp
124 (setq display-fill-column-indicator-column 80)
125 (global-display-fill-column-indicator-mode)
128 When starting a key chord, show possible future steps after 0.3 seconds.
129 #+begin_src emacs-lisp
130 (use-package which-key
131 :config (which-key-mode)
132 :custom (which-key-idle-delay 0.3))
134 ** Highlight todo items in comments
135 #+begin_src emacs-lisp
137 :straight (hl-todo :type git :host github :repo "tarsius/hl-todo")
138 :config (global-hl-todo-mode 1))
141 #+begin_src emacs-lisp
145 Soft wrap words and do operations by visual lines except in programming modes.
146 #+begin_src emacs-lisp
148 (add-hook 'prog-mode-hook 'visual-line-mode 0)
150 ** Display number of matches in search
151 #+begin_src emacs-lisp
153 :config (global-anzu-mode))
156 Invert modeline color instead of audible bell or the standard visual bell.
157 #+begin_src emacs-lisp
158 (setq visible-bell nil
160 (lambda () (invert-face 'mode-line)
161 (run-with-timer 0.1 nil #'invert-face 'mode-line)))
165 #+begin_src emacs-lisp
167 :custom (select-enable-clipboard nil)
170 (fset 'evil-visual-update-x-selection 'ignore) ;; Keep clipboard and register seperate
171 ;; Use visual line motions even outside of visual-line-mode buffers
172 (evil-global-set-key 'motion "j" 'evil-next-visual-line)
173 (evil-global-set-key 'motion "k" 'evil-previous-visual-line)
174 (global-set-key (kbd "<escape>") 'keyboard-escape-quit))
177 Evil bindings for tons of packages.
178 #+begin_src emacs-lisp
179 (use-package evil-collection
181 :init (evil-collection-init)
182 :custom (evil-collection-setup-minibuffer t))
186 #+begin_src emacs-lisp
187 (use-package evil-surround
188 :config (global-evil-surround-mode))
191 Makes commenting super easy
192 #+begin_src emacs-lisp
193 (use-package evil-nerd-commenter
194 :bind (:map evil-normal-state-map
195 ("gc" . evilnc-comment-or-uncomment-lines))
196 :custom (evilnc-invert-comment-line-by-line nil))
200 #+begin_src emacs-lisp
201 (evil-set-undo-system 'undo-redo)
203 ** Number incrementing
204 Add back C-a/C-x bindings.
205 #+begin_src emacs-lisp
206 (use-package evil-numbers
207 :straight (evil-numbers :type git :host github :repo "juliapath/evil-numbers")
208 :bind (:map evil-normal-state-map
209 ("C-M-a" . evil-numbers/inc-at-pt)
210 ("C-M-x" . evil-numbers/dec-at-pt)))
213 #+begin_src emacs-lisp
214 (use-package evil-org
216 :hook (org-mode . evil-org-mode)
218 (evil-org-set-key-theme '(textobjects insert navigation shift todo)))
220 (use-package evil-org-agenda
221 :straight (:type built-in)
223 :config (evil-org-agenda-set-keys))
227 #+begin_src emacs-lisp
229 :straight (:type built-in)
230 :commands (org-capture org-agenda)
233 (org-agenda-start-with-log-mode t)
234 (org-agenda-files (quote ("~/Org/tasks.org" "~/Org/break.org")))
236 (org-log-into-drawer t)
237 (org-src-tab-acts-natively t)
238 (org-src-fontify-natively t)
239 (org-startup-indented t)
240 (org-hide-emphasis-markers t)
241 (org-fontify-whole-block-delimiter-line nil)
242 :bind ("C-c a" . org-agenda))
245 Define templates for lots of common structure elements. Mostly just used within this file.
246 #+begin_src emacs-lisp
247 (use-package org-tempo
249 :straight (:type built-in)
251 ;; TODO: There's gotta be a more efficient way to write this
252 (add-to-list 'org-structure-template-alist '("el" . "src emacs-lisp"))
253 (add-to-list 'org-structure-template-alist '("sp" . "src conf :tangle ~/.spectrwm.conf"))
254 (add-to-list 'org-structure-template-alist '("ash" . "src shell :tangle ~/.config/ash/ashrc"))
255 (add-to-list 'org-structure-template-alist '("ipy" . "src python :tangle ~/.ipython/"))
256 (add-to-list 'org-structure-template-alist '("pi" . "src conf :tangle ~/.config/picom/picom.conf"))
257 (add-to-list 'org-structure-template-alist '("git" . "src conf :tangle ~/.gitconfig"))
258 (add-to-list 'org-structure-template-alist '("du" . "src conf :tangle ~/.config/dunst/dunstrc"))
259 (add-to-list 'org-structure-template-alist '("za" . "src conf :tangle ~/.config/zathura/zathurarc"))
260 (add-to-list 'org-structure-template-alist '("ff1" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css"))
261 (add-to-list 'org-structure-template-alist '("ff2" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css"))
262 (add-to-list 'org-structure-template-alist '("xr" . "src conf :tangle ~/.Xresources"))
263 (add-to-list 'org-structure-template-alist '("tm" . "src conf :tangle ~/.tmux.conf"))
264 (add-to-list 'org-structure-template-alist '("gp" . "src conf :tangle ~/.gnupg/gpg.conf"))
265 (add-to-list 'org-structure-template-alist '("ag" . "src conf :tangle ~/.gnupg/gpg-agent.conf")))
269 A well balanced completion framework.
270 #+begin_src emacs-lisp
272 :bind (("C-s" . swiper)
273 :map ivy-minibuffer-map
274 ("TAB" . ivy-alt-done)
275 :map ivy-switch-buffer-map
276 ("M-d" . ivy-switch-buffer-kill))
280 #+begin_src emacs-lisp
281 (use-package ivy-rich
283 :config (ivy-rich-mode))
287 #+begin_src emacs-lisp
289 :bind (("C-M-j" . 'counsel-switch-buffer)
290 :map minibuffer-local-map
291 ("C-r" . 'counsel-minibuffer-history))
292 :custom (counsel-linux-app-format-function #'counsel-linux-app-format-function-name-only)
293 :config (counsel-mode))
295 ** Remember frequent commands
296 #+begin_src emacs-lisp
297 (use-package ivy-prescient
299 :custom (ivy-prescient-enable-filtering nil)
301 (prescient-persist-mode)
302 (ivy-prescient-mode))
305 Better search utility.
306 #+begin_src emacs-lisp
311 Use elfeed for reading RSS. I have another file with all the feeds in it that I'd rather keep private.
312 #+begin_src emacs-lisp
314 :bind (("C-c e" . elfeed))
316 (load "~/.emacs.d/feeds.el")
317 (add-hook 'elfeed-new-entry-hook
318 (elfeed-make-tagger :feed-url "youtube\\.com"
320 :bind (:map elfeed-search-mode-map ("C-c C-o" . 'elfeed-show-visit)))
322 (use-package elfeed-goodies
324 :config (elfeed-goodies/setup))
327 Use mu4e for reading emails.
329 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.
331 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.
332 #+begin_src emacs-lisp
333 (use-package smtpmail
334 :straight (:type built-in))
336 :load-path "/usr/share/emacs/site-lisp/mu4e"
337 :straight (:build nil)
338 :bind (("C-c m" . mu4e))
340 (setq user-full-name "Armaan Bhojwani"
341 smtpmail-local-domain "armaanb.net"
342 smtpmail-stream-type 'ssl
343 smtpmail-smtp-service '465
344 mu4e-change-filenames-when-moving t
345 mu4e-get-mail-command "offlineimap -q"
346 message-citation-line-format "On %a %d %b %Y at %R, %f wrote:\n"
347 message-citation-line-function 'message-insert-formatted-citation-line
348 mu4e-completing-read-function 'ivy-completing-read
349 mu4e-confirm-quit nil
351 mail-user-agent 'mu4e-user-agent
352 mail-context-policy 'pick-first
354 `( ,(make-mu4e-context
356 :enter-func (lambda () (mu4e-message "Entering school context"))
357 :leave-func (lambda () (mu4e-message "Leaving school context"))
358 :match-func (lambda (msg)
360 (string-match-p "^/school" (mu4e-message-field msg :maildir))))
361 :vars '((user-mail-address . "abhojwani22@nobles.edu")
362 (mu4e-sent-folder . "/school/Sent")
363 (mu4e-drafts-folder . "/school/Drafts")
364 (mu4e-trash-folder . "/school/Trash")
365 (mu4e-refile-folder . "/school/Archive")
366 (message-cite-reply-position . above)
367 (user-mail-address . "abhojwani22@nobles.edu")
368 (smtpmail-smtp-user . "abhojwani22@nobles.edu")
369 (smtpmail-smtp-server . "smtp.gmail.com")))
372 :enter-func (lambda () (mu4e-message "Entering personal context"))
373 :leave-func (lambda () (mu4e-message "Leaving personal context"))
374 :match-func (lambda (msg)
376 (string-match-p "^/personal" (mu4e-message-field msg :maildir))))
377 :vars '((mu4e-sent-folder . "/personal/Sent")
378 (mu4e-drafts-folder . "/personal/Drafts")
379 (mu4e-trash-folder . "/personal/Trash")
380 (mu4e-refile-folder . "/personal/Archive")
381 (user-mail-address . "me@armaanb.net")
382 (message-cite-reply-position . below)
383 (smtpmail-smtp-user . "me@armaanb.net")
384 (smtpmail-smtp-server . "smtp.mailbox.org")))))
385 (add-to-list 'mu4e-bookmarks
386 '(:name "Unified inbox"
387 :query "maildir:\"/personal/INBOX\" or maildir:\"/school/INBOX\""
389 :hook ((mu4e-compose-mode . flyspell-mode)
390 (mu4e-compose-mode . auto-fill-mode)
391 (mu4e-view-mode-hook . turn-on-visual-line-mode)
392 (message-send-hook . (lambda () (unless (yes-or-no-p "Ya sure 'bout that?")
393 (signal 'quit nil))))))
395 Discourage Gnus from displaying HTML emails
396 #+begin_src emacs-lisp
397 (with-eval-after-load "mm-decode"
398 (add-to-list 'mm-discouraged-alternatives "text/html")
399 (add-to-list 'mm-discouraged-alternatives "text/richtext"))
402 Set EWW as default browser except for videos which should open in MPV.
403 #+begin_src emacs-lisp
404 (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 ("." . eww-browse-url)
418 Some EWW enhancements.
419 *** Give buffer a useful name
420 #+begin_src emacs-lisp
421 ;; From https://protesilaos.com/dotemacs/
422 (defun prot-eww--rename-buffer ()
423 "Rename EWW buffer using page title or URL.
424 To be used by `eww-after-render-hook'."
425 (let ((name (if (eq "" (plist-get eww-data :title))
426 (plist-get eww-data :url)
427 (plist-get eww-data :title))))
428 (rename-buffer (format "*%s # eww*" name) t)))
431 :straight (:type built-in)
432 :bind (("C-c w" . eww))
433 :hook (eww-after-render-hook prot-eww--rename-buffer))
436 #+begin_src emacs-lisp
437 (global-set-key (kbd "C-c w") 'eww)
440 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.
441 #+begin_src emacs-lisp
442 (defun fetch-password (&rest params)
443 (require 'auth-source)
444 (let ((match (car (apply 'auth-source-search params))))
446 (let ((secret (plist-get match :secret)))
447 (if (functionp secret)
450 (error "Password not found for %S" params))))
455 (enable-circe-color-nicks)
459 (setq circe-networks '(("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"
490 :custom (circe-default-part-message "goodbye!")
491 :bind (:map circe-mode-map ("C-c C-r" . circe-reconnect-all)))
494 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.
495 #+begin_src emacs-lisp
496 (defun sync-calendar ()
497 "Sync calendars with vdirsyncer"
499 (shell-command "vdirsyncer -vcritical sync"))
502 :bind (:map cfw:calendar-mode-map ("C-S-u" . sync-calendar)))
503 (use-package calfw-ical)
504 (use-package calfw-org)
506 (defun acheam-calendar ()
509 (cfw:open-calendar-buffer
510 :contents-sources (list
511 (cfw:org-create-source "Green")
512 (cfw:ical-create-source
514 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
516 (cfw:ical-create-source
518 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
520 (cfw:ical-create-source
522 "~/.local/share/vdirsyncer/school/abhojwani22@nobles.edu.ics"
526 (global-set-key (kbd "C-c c") 'acheam-calendar)
530 #+begin_src emacs-lisp
532 :hook (python-mode . blacken-mode)
533 :custom (blacken-line-length 79))
536 ** Strip trailing whitespace
537 #+begin_src emacs-lisp
538 (use-package ws-butler
539 :config (ws-butler-global-mode))
542 Automatic linting. I need to look into configuring this more.
543 #+begin_src emacs-lisp
544 (use-package flycheck
545 :config (global-flycheck-mode))
547 ** Project management
548 I never use this, but apparently its very powerful. Another item on my todo list.
549 #+begin_src emacs-lisp
550 (use-package projectile
551 :config (projectile-mode)
552 :custom ((projectile-completion-system 'ivy))
554 ("C-c p" . projectile-command-map)
556 (when (file-directory-p "~/Code")
557 (setq projectile-project-search-path '("~/Code")))
558 (setq projectile-switch-project-action #'projectile-dired))
560 (use-package counsel-projectile
562 :config (counsel-projectile-mode))
565 The best file manager!
566 #+begin_src emacs-lisp
568 :straight (:type built-in)
569 :commands (dired dired-jump)
570 :custom ((dired-listing-switches "-agho --group-directories-first"))
571 :config (evil-collection-define-key 'normal 'dired-mode-map
572 "h" 'dired-single-up-directory
573 "l" 'dired-single-buffer))
575 (use-package dired-single
576 :commands (dired dired-jump))
578 (use-package dired-open
579 :commands (dired dired-jump)
580 :custom (dired-open-extensions '(("png" . "feh")
583 (use-package dired-hide-dotfiles
584 :hook (dired-mode . dired-hide-dotfiles-mode)
586 (evil-collection-define-key 'normal 'dired-mode-map
587 "H" 'dired-hide-dotfiles-mode))
591 **** TODO Write a command that commits hunk, skipping staging step.
592 A very good Git interface.
593 #+begin_src emacs-lisp
597 #+begin_src emacs-lisp
599 (use-package git-email
600 :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
601 :config (git-email-piem-mode))
603 * General text editing
605 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.
606 #+begin_src emacs-lisp
607 (use-package aggressive-indent
608 :config (global-aggressive-indent-mode))
611 Spell check in text mode, and in prog-mode comments.
612 #+begin_src emacs-lisp
613 (dolist (hook '(text-mode-hook))
614 (add-hook hook (lambda () (flyspell-mode))))
615 (dolist (hook '(change-log-mode-hook log-edit-mode-hook))
616 (add-hook hook (lambda () (flyspell-mode -1))))
617 (add-hook 'prog-mode (lambda () (flyspell-prog mode)))
618 (setq ispell-silently-savep t)
621 #+begin_src emacs-lisp
622 (setq-default tab-width 2)
625 Opens file where you left it.
626 #+begin_src emacs-lisp
630 Distraction free writing a la junegunn/goyo.
631 #+begin_src emacs-lisp
632 (use-package olivetti
633 :bind ("C-c o" . olivetti-mode))
636 Abbreviate things! I just use this for things like my email address and copyright notice.
637 #+begin_src emacs-lisp
638 (setq abbrev-file-name "~/.emacs.d/abbrevs.el")
639 (setq save-abbrevs 'silent)
640 (setq-default abbrev-mode t)
643 #+begin_src emacs-lisp
644 (setq tramp-default-method "ssh")
646 ** Follow version controlled symlinks
647 #+begin_src emacs-lisp
648 (setq vc-follow-symlinks t)
651 #+begin_src emacs-lisp
652 (defun doas-edit (&optional arg)
653 "Edit currently visited file as root.
655 With a prefix ARG prompt for a file to visit.
656 Will also prompt for a file to visit if current
657 buffer is not visiting a file.
659 Modified from Emacs Redux."
661 (if (or arg (not buffer-file-name))
662 (find-file (concat "/doas:root@localhost:"
663 (ido-read-file-name "Find file(as root): ")))
664 (find-alternate-file (concat "/doas:root@localhost:" buffer-file-name))))
666 (global-set-key (kbd "C-x C-r") #'doas-edit)
670 #+begin_src emacs-lisp
671 (use-package ace-window
672 :bind ("M-o" . ace-window))
674 ** Kill current buffer
675 Makes "C-x k" binding faster.
676 #+begin_src emacs-lisp
677 (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
681 #+begin_src emacs-lisp
682 (use-package scad-mode)
684 ** Control backup and lock files
685 Stop backup files from spewing everywhere.
686 #+begin_src emacs-lisp
687 (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
688 create-lockfiles nil)
690 ** Make yes/no easier
691 #+begin_src emacs-lisp
692 (defalias 'yes-or-no-p 'y-or-n-p)
694 ** Move customize file
695 No more clogging up init.el.
696 #+begin_src emacs-lisp
697 (setq custom-file "~/.emacs.d/custom.el")
701 #+begin_src emacs-lisp
703 :commands (helpful-callable helpful-variable helpful-command helpful-key)
705 (counsel-describe-function-function #'helpful-callable)
706 (counsel-describe-variable-function #'helpful-variable)
708 ([remap describe-function] . counsel-describe-function)
709 ([remap describe-command] . helpful-command)
710 ([remap describe-variable] . counsel-describe-variable)
711 ([remap describe-key] . helpful-key))
714 #+begin_src emacs-lisp
715 (use-package epa-file
716 :straight (:type built-in)
718 (epa-file-select-keys nil)
719 (epa-file-encrypt-to '("me@armaanb.net"))
720 (password-cache-expiry (* 60 15)))
722 (use-package pinentry
723 :config (pinentry-start))
726 #+begin_src emacs-lisp
728 :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
729 :custom (0x0-default-service 'envs))
731 ** Automatically clean buffers
732 Automatically close unused buffers (except those of Circe) at midnight.
733 #+begin_src emacs-lisp
734 (add-to-list 'clean-buffer-list-kill-never-regexps (lambda (buffer-name)
735 (with-current-buffer buffer-name
736 (derived-mode-p 'lui-mode))))
741 Spectrwm is a really awesome window manager! Would highly recommend.
743 #+begin_src conf :tangle ~/.spectrwm.conf
747 autorun = ws[1]:/home/armaa/Code/scripts/autostart
750 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.
751 #+begin_src conf :tangle ~/.spectrwm.conf
753 bar_font = xos4 JetBrains Mono:pixelsize=14:antialias=true # any installed font
756 I'm not a huge fan of how spectrwm handles keybindings, probably my biggest gripe with it.
758 #+begin_src conf :tangle ~/.spectrwm.conf
759 program[term] = st -e tmux
760 program[screenshot_all] = flameshot gui
761 program[notif] = /home/armaa/Code/scripts/setter status
762 program[pass] = /home/armaa/Code/scripts/passmenu
765 bind[pass] = MOD+Shift+p
768 #+begin_src conf :tangle ~/.spectrwm.conf
769 program[paup] = /home/armaa/Code/scripts/setter audio +5
770 program[padown] = /home/armaa/Code/scripts/setter audio -5
771 program[pamute] = /home/armaa/Code/scripts/setter audio
772 program[brigup] = /home/armaa/Code/scripts/setter brightness +10%
773 program[brigdown] = /home/armaa/Code/scripts/setter brightness 10%-
774 program[next] = playerctl next
775 program[prev] = playerctl previous
776 program[pause] = playerctl play-pause
778 bind[padown] = XF86AudioLowerVolume
779 bind[paup] = XF86AudioRaiseVolume
780 bind[pamute] = XF86AudioMute
781 bind[brigdown] = XF86MonBrightnessDown
782 bind[brigup] = XF86MonBrightnessUp
783 bind[pause] = XF86AudioPlay
784 bind[next] = XF86AudioNext
785 bind[prev] = XF86AudioPrev
788 #+begin_src conf :tangle ~/.spectrwm.conf
789 program[h] = xdotool keyup h key --clearmodifiers Left
790 program[j] = xdotool keyup j key --clearmodifiers Down
791 program[k] = xdotool keyup k key --clearmodifiers Up
792 program[l] = xdotool keyup l key --clearmodifiers Right
794 bind[h] = MOD + Control + h
795 bind[j] = MOD + Control + j
796 bind[k] = MOD + Control + k
797 bind[l] = MOD + Control + l
800 #+begin_src conf :tangle ~/.spectrwm.conf
801 program[email] = emacsclient -c --eval "(mu4e)"
802 program[irc] = emacsclient -c --eval '(switch-to-buffer "irc.armaanb.net:6698")'
803 program[rss] = emacsclient -c --eval '(elfeed)'
804 program[calendar] = emacsclient -c --eval '(acheam-calendar)'
805 program[emacs] = emacsclient -c
806 program[firefox] = firefox
807 program[calc] = st -e bc -l
809 bind[email] = MOD+Control+1
810 bind[irc] = MOD+Control+2
811 bind[rss] = MOD+Control+3
812 bind[calendar] = MOD+Control+4
813 bind[calc] = MOD+Control+5
814 bind[firefox] = MOD+Control+0
815 bind[emacs] = MOD+Control+Return
818 Float some specific programs by default.
819 #+begin_src conf :tangle ~/.spectrwm.conf
820 quirk[Castle Menu] = FLOAT
825 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.
826 #+begin_src conf :tangle ~/.config/ash/ashrc
830 **** Update all packages
831 #+begin_src shell :tangle ~/.config/ash/ashrc
832 color=$(tput setaf 5)
836 doas echo "${color}== upgrading with yay ==${reset}"
839 echo "${color}== checking for pacnew files ==${reset}"
842 echo "${color}== upgrading flatpaks ==${reset}"
845 echo "${color}== updating nvim plugins ==${reset}"
846 nvim +PlugUpdate +PlugUpgrade +qall
847 echo "Updated nvim plugins"
849 echo "${color}You are entirely up to date!${reset}"
852 **** Clean all packages
853 #+begin_src shell :tangle ~/.config/ash/ashrc
855 doas echo "${color}== cleaning pacman orphans ==${reset}"
856 (pacman -Qtdq | doas pacman -Rns - 2> /dev/null) || echo "No orphans"
858 echo "${color}== cleaning flatpaks ==${reset}"
859 flatpak remove --unused
861 echo "${color}== cleaning nvim plugins ==${reset}"
862 nvim +PlugClean +qall
863 echo "Cleaned nvim plugins"
865 echo "${color}All orphans cleaned!${reset}"
868 **** Interact with 0x0
869 #+begin_src shell :tangle ~/.config/ash/ashrc
870 zxz="https://envs.sh"
871 ufile() { curl -F"file=@$1" "$zxz" ; }
872 upb() { curl -F"file=@-;" "$zxz" ; }
873 uurl() { curl -F"url=$1" "$zxz" ; }
874 ushort() { curl -F"shorten=$1" "$zxz" ; }
875 uclip() { xclip -out | curl -F"file=@-;" "$zxz" ; }
878 #+begin_src shell :tangle ~/.config/ash/ashrc
880 user=$(echo "$1" | cut -f 1 -d '@')
881 host=$(echo "$1" | cut -f 2 -d '@')
882 echo $user | nc "$host" 79
885 **** Upload to ftp.armaanb.net
886 #+begin_src shell :tangle ~/.config/ash/ashrc
888 rsync "$1" "root@armaanb.net:/var/ftp/pub/${2}"
889 echo "https://ftp.armaanb.net/pub/"$(basename "$1") | tee /dev/tty | xclip -sel c
893 #+begin_src shell :tangle ~/.config/ash/ashrc
894 export EDITOR="emacsclient -c"
895 export VISUAL="$EDITOR"
896 export TERM=xterm-256color # for compatability
898 export GPG_TTY="$(tty)"
899 export MANPAGER='nvim +Man!'
902 export GTK_USE_PORTAL=1
904 export PATH="/home/armaa/.local/bin:$PATH" # prioritize .local/bin
905 export PATH="/home/armaa/Code/scripts:$PATH" # prioritize my scripts
906 export PATH="/home/armaa/Code/scripts/bin:$PATH" # prioritize my bins
907 export PATH="$PATH:/home/armaa/.cargo/bin"
908 export PATH="$PATH:/home/armaa/.local/share/gem/ruby/2.7.0/bin"
909 export PATH="$PATH:/usr/sbin"
910 export PATH="$PATH:/opt/FreeTube/freetube"
912 export LC_ALL="en_US.UTF-8"
913 export LC_CTYPE="en_US.UTF-8"
914 export LANGUAGE="en_US.UTF-8"
916 export KISS_PATH="/home/armaa/Virtual/kiss/home/armaa/kiss-repo"
917 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/core"
918 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/extra"
919 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/xorg"
920 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/testing"
921 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-community/community"
925 #+begin_src shell :tangle ~/.config/ash/ashrc
926 alias bhoji-drop='ssh -p 23 root@armaanb.net'
927 alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
928 alias union='ssh 192.168.1.18'
929 alias mine='ssh -p 23 root@pickupserver.cc'
930 alias tcf='ssh root@204.48.23.68'
931 alias ngmun='ssh root@157.245.89.25'
932 alias prox='ssh root@192.168.1.224'
933 alias ncq='ssh root@143.198.123.17'
934 alias envs='ssh acheam@envs.net'
937 #+begin_src shell :tangle ~/.config/ash/ashrc
938 alias ls='ls -lh --group-directories-first'
940 alias df='df -h / /boot'
947 alias grep='grep -in --color=auto'
948 alias mkdir='mkdir -pv'
949 alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar'
950 emacs() { $EDITOR "$@" & }
953 **** System management
954 #+begin_src shell :tangle ~/.config/ash/ashrc
955 alias crontab='crontab-argh'
957 alias pasu='git -C ~/.password-store push'
958 alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
962 #+begin_src shell :tangle ~/.config/ash/ashrc
963 alias ping='ping -c 10'
964 alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
965 alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
966 alias plan='T=$(mktemp) && \
967 rsync root@armaanb.net:/etc/finger/plan.txt "$T" && \
969 head -n -2 $T > $TT && \
971 echo "\nLast updated: $(date -R)" >> "$TT" && \
972 fold -sw 72 "$TT" > "$T"| \
973 rsync "$T" root@armaanb.net:/etc/finger/plan.txt'
975 **** Virtual machines, chroots
976 #+begin_src shell :tangle ~/.config/ash/ashrc
977 alias ckiss="doas chrooter ~/Virtual/kiss"
978 alias cdebian="doas chrooter ~/Virtual/debian bash"
979 alias cwindows='devour qemu-system-x86_64 \
984 -device VGA,vgamem_mb=64 \
988 -net user,smb=/home/armaa/Public \
989 -drive format=qcow2,file=/home/armaa/Virtual/windows.qcow2'
992 #+begin_src shell :tangle ~/.config/ash/ashrc
993 alias pip="python -m pip"
994 alias black="black -l 79"
997 #+begin_src shell :tangle ~/.config/ash/ashrc
998 alias words='gen-shell -c "words"'
999 alias words-e='gen-shell -c "words ~E"'
1002 #+begin_src shell :tangle ~/.config/ash/ashrc
1003 alias zathura='devour zathura'
1004 alias cad='devour openscad'
1005 alias feh='devour feh'
1008 #+begin_src shell :tangle ~/.config/ash/ashrc
1010 alias api='yay -Syu'
1011 alias apii='doas pacman -S'
1012 alias app='yay -Rns'
1013 alias azf='pacman -Q | fzf'
1014 alias favorites='pacman -Qe | cut -d " " -f 1 > ~/Documents/favorites'
1017 #+begin_src shell :tangle ~/.config/ash/ashrc
1018 alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
1019 iflag=fullblock status=progress'
1020 alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
1021 iflag=fullblock status=progress'
1022 alias ytmusic="youtube-dl -x --add-metadata --audio-format aac \
1023 --restrict-filenames -o '%(title)s.%(ext)s'"
1024 alias cal="cal -3 --color=auto"
1028 #+begin_src python :tangle ~/.ipython/profile_default/ipython_config.py
1029 c.TerminalInteractiveShell.editing_mode = 'vi'
1030 c.InteractiveShell.colors = 'linux'
1031 c.TerminalInteractiveShell.confirm_exit = False
1034 Make MPV play a little bit smoother.
1035 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
1036 ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
1040 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!.
1041 #+begin_src conf :tangle ~/.inputrc
1042 set editing-mode emacs
1046 #+begin_src conf :tangle ~/.gitconfig
1048 name = Armaan Bhojwani
1049 email = me@armaanb.net
1050 signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
1053 #+begin_src conf :tangle ~/.gitconfig
1055 defaultBranch = main
1058 #+begin_src conf :tangle ~/.gitconfig
1063 #+begin_src conf :tangle ~/.gitconfig
1065 smtpserver = smtp.mailbox.org
1066 smtpuser = me@armaanb.net
1067 smtpencryption = ssl
1068 smtpserverport = 465
1072 #+begin_src conf :tangle ~/.gitconfig
1077 #+begin_src conf :tangle ~/.gitconfig
1080 sclone = clone --depth 1
1085 quickfix = commit . --amend --no-edit
1087 subup = submodule update --remote
1088 loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1089 pushnc = push -o skip-ci
1092 #+begin_src conf :tangle ~/.gitconfig
1098 Lightweight notification daemon. Eventually I'd like to replace this with something dbus-less.
1100 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1102 font = "JetBrains Mono Medium Nerd Font 11"
1104 format = "<b>%s</b>\n%b"
1106 indicate_hidden = yes
1109 show_age_threshold = 60
1112 geometry = "400x5-10+10"
1114 idle_threshold = 120
1116 sticky_history = yes
1118 separator_height = 1
1120 horizontal_padding = 8
1122 separator_color = "#ffffff"
1123 startup_notification = false
1126 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1133 close_all = mod4+shift+c
1134 history = mod4+ctrl+c
1137 background = "#222222"
1138 foreground = "#ffffff"
1139 highlight = "#ffffff"
1143 background = "#222222"
1144 foreground = "#ffffff"
1145 highlight = "#ffffff"
1149 background = "#222222"
1150 foreground = "#a60000"
1151 highlight = "#ffffff"
1155 The best document reader!
1157 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1159 map <A-b> toggle_statusbar
1160 set selection-clipboard clipboard
1163 set window-title-basename "true"
1164 set selection-clipboard "clipboard"
1167 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1168 set default-bg "#000000"
1169 set default-fg "#ffffff"
1170 set render-loading true
1171 set render-loading-bg "#000000"
1172 set render-loading-fg "#ffffff"
1174 set recolor-lightcolor "#000000" # bg
1175 set recolor-darkcolor "#ffffff" # fg
1179 Just some basic Firefox CSS. Will probably have to rewrite for the Proton redesign.
1180 *** Swap tab and URL bars
1181 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1183 -moz-box-ordinal-group: 1 !important;
1187 -moz-box-ordinal-group: 2 !important;
1191 -moz-box-ordinal-group: 3 !important;
1194 *** Hide URL bar when not focused.
1195 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1196 #navigator-toolbox:not(:focus-within):not(:hover) {
1200 #navigator-toolbox {
1201 transition: 0.1s margin-top ease-out;
1204 *** Black screen by default
1206 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1209 #browser vbox#appcontent tabbrowser,
1211 #tabbrowser-tabpanels,
1213 browser[type="content-primary"],
1214 browser[type="content"] > html,
1216 background: black !important;
1217 color: #fff !important;
1222 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css
1223 @-moz-document url("about:home"), url("about:blank"), url("about:newtab") {
1225 background: black !important;
1230 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.
1231 #+begin_src conf :tangle ~/.Xresources
1233 ,*.foreground: #ffffff
1234 ,*.background: #000000
1235 ,*.cursorColor: #ffffff
1270 I use tmux in order to keep my st build light. Still learning how it works.
1271 #+begin_src conf :tangle ~/.tmux.conf
1274 set-window-option -g mode-keys vi
1275 bind-key -T copy-mode-vi 'v' send -X begin-selection
1276 bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1280 #+begin_src conf :tangle ~/.gnupg/gpg.conf
1281 default-key 3C9ED82FFE788E4A
1285 #+begin_src conf :tangle ~/.gnupg/gpg-agent.conf
1286 pinentry-program /sbin/pinentry-gnome3
1288 default-cache-ttl 600
1289 allow-emacs-pinentry