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
144 (add-hook 'prog-mode-hook 'visual-line-mode 0)
146 ** Display number of matches in search
147 #+begin_src emacs-lisp
149 :config (global-anzu-mode))
152 Invert modeline color instead of audible bell or the standard visual bell.
153 #+begin_src emacs-lisp
154 (setq visible-bell nil
156 (lambda () (invert-face 'mode-line)
157 (run-with-timer 0.1 nil #'invert-face 'mode-line)))
161 #+begin_src emacs-lisp
163 :custom (select-enable-clipboard nil)
166 (fset 'evil-visual-update-x-selection 'ignore) ;; Keep clipboard and register seperate
167 ;; Use visual line motions even outside of visual-line-mode buffers
168 (evil-global-set-key 'motion "j" 'evil-next-visual-line)
169 (evil-global-set-key 'motion "k" 'evil-previous-visual-line)
170 (global-set-key (kbd "<escape>") 'keyboard-escape-quit))
173 Evil bindings for tons of packages.
174 #+begin_src emacs-lisp
175 (use-package evil-collection
177 :init (evil-collection-init)
178 :custom (evil-collection-setup-minibuffer t))
182 #+begin_src emacs-lisp
183 (use-package evil-surround
184 :config (global-evil-surround-mode))
187 Makes commenting super easy
188 #+begin_src emacs-lisp
189 (use-package evil-nerd-commenter
190 :bind (:map evil-normal-state-map
191 ("gc" . evilnc-comment-or-uncomment-lines))
192 :custom (evilnc-invert-comment-line-by-line nil))
196 #+begin_src emacs-lisp
197 (evil-set-undo-system 'undo-redo)
199 ** Number incrementing
200 Add back C-a/C-x bindings.
201 #+begin_src emacs-lisp
202 (use-package evil-numbers
203 :straight (evil-numbers :type git :host github :repo "juliapath/evil-numbers")
204 :bind (:map evil-normal-state-map
205 ("C-M-a" . evil-numbers/inc-at-pt)
206 ("C-M-x" . evil-numbers/dec-at-pt)))
209 #+begin_src emacs-lisp
210 (use-package evil-org
212 :hook (org-mode . evil-org-mode)
214 (evil-org-set-key-theme '(textobjects insert navigation shift todo)))
216 (use-package evil-org-agenda
217 :straight (:type built-in)
219 :config (evil-org-agenda-set-keys))
223 #+begin_src emacs-lisp
225 :straight (:type built-in)
226 :commands (org-capture org-agenda)
229 (org-agenda-start-with-log-mode t)
230 (org-agenda-files (quote ("~/Org/tasks.org" "~/Org/break.org")))
232 (org-log-into-drawer t)
233 (org-src-tab-acts-natively t)
234 (org-src-fontify-natively t)
235 (org-startup-indented t)
236 (org-hide-emphasis-markers t)
237 (org-fontify-whole-block-delimiter-line nil)
238 :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 '("ipy" . "src python :tangle ~/.ipython/"))
252 (add-to-list 'org-structure-template-alist '("pi" . "src conf :tangle ~/.config/picom/picom.conf"))
253 (add-to-list 'org-structure-template-alist '("git" . "src conf :tangle ~/.gitconfig"))
254 (add-to-list 'org-structure-template-alist '("du" . "src conf :tangle ~/.config/dunst/dunstrc"))
255 (add-to-list 'org-structure-template-alist '("za" . "src conf :tangle ~/.config/zathura/zathurarc"))
256 (add-to-list 'org-structure-template-alist '("ff1" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css"))
257 (add-to-list 'org-structure-template-alist '("ff2" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css"))
258 (add-to-list 'org-structure-template-alist '("xr" . "src conf :tangle ~/.Xresources"))
259 (add-to-list 'org-structure-template-alist '("tm" . "src conf :tangle ~/.tmux.conf"))
260 (add-to-list 'org-structure-template-alist '("gp" . "src conf :tangle ~/.gnupg/gpg.conf"))
261 (add-to-list 'org-structure-template-alist '("ag" . "src conf :tangle ~/.gnupg/gpg-agent.conf")))
265 A well balanced completion framework.
266 #+begin_src emacs-lisp
268 :bind (("C-s" . swiper)
269 :map ivy-minibuffer-map
270 ("TAB" . ivy-alt-done)
271 :map ivy-switch-buffer-map
272 ("M-d" . ivy-switch-buffer-kill))
276 #+begin_src emacs-lisp
277 (use-package ivy-rich
279 :config (ivy-rich-mode))
283 #+begin_src emacs-lisp
285 :bind (("C-M-j" . 'counsel-switch-buffer)
286 :map minibuffer-local-map
287 ("C-r" . 'counsel-minibuffer-history))
288 :custom (counsel-linux-app-format-function #'counsel-linux-app-format-function-name-only)
289 :config (counsel-mode))
291 ** Remember frequent commands
292 #+begin_src emacs-lisp
293 (use-package ivy-prescient
295 :custom (ivy-prescient-enable-filtering nil)
297 (prescient-persist-mode)
298 (ivy-prescient-mode))
301 Better search utility.
302 #+begin_src emacs-lisp
307 Use elfeed for reading RSS. I have another file with all the feeds in it that I'd rather keep private.
308 #+begin_src emacs-lisp
310 :bind (("C-c e" . elfeed))
312 (load "~/.emacs.d/feeds.el")
313 (add-hook 'elfeed-new-entry-hook
314 (elfeed-make-tagger :feed-url "youtube\\.com"
316 :bind (:map elfeed-search-mode-map ("C-c C-o" . 'elfeed-show-visit)))
318 (use-package elfeed-goodies
320 :config (elfeed-goodies/setup))
323 Use mu4e for reading emails.
325 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.
327 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.
328 #+begin_src emacs-lisp
329 (use-package smtpmail
330 :straight (:type built-in))
332 :load-path "/usr/share/emacs/site-lisp/mu4e"
333 :straight (:build nil)
334 :bind (("C-c m" . mu4e))
336 (setq user-full-name "Armaan Bhojwani"
337 smtpmail-local-domain "armaanb.net"
338 smtpmail-stream-type 'ssl
339 smtpmail-smtp-service '465
340 mu4e-change-filenames-when-moving t
341 mu4e-get-mail-command "offlineimap -q"
342 message-citation-line-format "On %a %d %b %Y at %R, %f wrote:\n"
343 message-citation-line-function 'message-insert-formatted-citation-line
344 mu4e-completing-read-function 'ivy-completing-read
345 mu4e-confirm-quit nil
347 mail-user-agent 'mu4e-user-agent
348 mail-context-policy 'pick-first
350 `( ,(make-mu4e-context
352 :enter-func (lambda () (mu4e-message "Entering school context"))
353 :leave-func (lambda () (mu4e-message "Leaving school context"))
354 :match-func (lambda (msg)
356 (string-match-p "^/school" (mu4e-message-field msg :maildir))))
357 :vars '((user-mail-address . "abhojwani22@nobles.edu")
358 (mu4e-sent-folder . "/school/Sent")
359 (mu4e-drafts-folder . "/school/Drafts")
360 (mu4e-trash-folder . "/school/Trash")
361 (mu4e-refile-folder . "/school/Archive")
362 (message-cite-reply-position . above)
363 (user-mail-address . "abhojwani22@nobles.edu")
364 (smtpmail-smtp-user . "abhojwani22@nobles.edu")
365 (smtpmail-smtp-server . "smtp.gmail.com")))
368 :enter-func (lambda () (mu4e-message "Entering personal context"))
369 :leave-func (lambda () (mu4e-message "Leaving personal context"))
370 :match-func (lambda (msg)
372 (string-match-p "^/personal" (mu4e-message-field msg :maildir))))
373 :vars '((mu4e-sent-folder . "/personal/Sent")
374 (mu4e-drafts-folder . "/personal/Drafts")
375 (mu4e-trash-folder . "/personal/Trash")
376 (mu4e-refile-folder . "/personal/Archive")
377 (user-mail-address . "me@armaanb.net")
378 (message-cite-reply-position . below)
379 (smtpmail-smtp-user . "me@armaanb.net")
380 (smtpmail-smtp-server . "smtp.mailbox.org")))))
381 (add-to-list 'mu4e-bookmarks
382 '(:name "Unified inbox"
383 :query "maildir:\"/personal/INBOX\" or maildir:\"/school/INBOX\""
385 :hook ((mu4e-compose-mode . flyspell-mode)
386 (mu4e-compose-mode . auto-fill-mode)
387 (mu4e-view-mode-hook . turn-on-visual-line-mode)
388 (message-send-hook . (lambda () (unless (yes-or-no-p "Ya sure 'bout that?")
389 (signal 'quit nil))))))
391 Discourage Gnus from displaying HTML emails
392 #+begin_src emacs-lisp
393 (with-eval-after-load "mm-decode"
394 (add-to-list 'mm-discouraged-alternatives "text/html")
395 (add-to-list 'mm-discouraged-alternatives "text/richtext"))
398 Set EWW as default browser except for multimedia which should open in MPV.
399 #+begin_src emacs-lisp
400 (defun browse-url-mpv (url &optional new-window)
403 (start-process "mpv" "*mpv*" "mpv" url))
405 (setq browse-url-handlers
407 (("youtu\\.?be" . browse-url-mpv)
408 ("peertube.*" . browse-url-mpv)
409 ("vid.*" . browse-url-mpv)
410 ("vid.*" . browse-url-mpv)
411 ("*.mp4" . browse-url-mpv)
412 ("*.mp3" . browse-url-mpv)
413 ("*.ogg" . 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)
456 (setq circe-network-defaults '(("libera"
457 :host "irc.armaanb.net"
462 :pass (lambda (null) (fetch-password
464 :machine "irc.armaanb.net"
467 :host "irc.armaanb.net"
472 :pass (lambda (null) (fetch-password
474 :machine "irc.armaanb.net"
477 :host "irc.armaanb.net"
482 :pass (lambda (null) (fetch-password
484 :machine "irc.armaanb.net"
489 :custom (circe-default-part-message "goodbye!")
490 :bind (:map circe-mode-map ("C-c C-r" . circe-reconnect-all)))
493 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.
494 #+begin_src emacs-lisp
495 (defun sync-calendar ()
496 "Sync calendars with vdirsyncer"
498 (shell-command "vdirsyncer -vcritical sync"))
501 :bind (:map cfw:calendar-mode-map ("C-S-u" . sync-calendar)))
502 (use-package calfw-ical)
503 (use-package calfw-org)
505 (defun acheam-calendar ()
508 (cfw:open-calendar-buffer
509 :contents-sources (list
510 (cfw:org-create-source "Green")
511 (cfw:ical-create-source
513 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
515 (cfw:ical-create-source
517 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
519 (cfw:ical-create-source
521 "~/.local/share/vdirsyncer/school/abhojwani22@nobles.edu.ics"
525 (global-set-key (kbd "C-c c") 'acheam-calendar)
529 #+begin_src emacs-lisp
531 :hook (python-mode . blacken-mode)
532 :custom (blacken-line-length 79))
535 ** Strip trailing whitespace
536 #+begin_src emacs-lisp
537 (use-package ws-butler
538 :config (ws-butler-global-mode))
541 Automatic linting. I need to look into configuring this more.
542 #+begin_src emacs-lisp
543 (use-package flycheck
544 :config (global-flycheck-mode))
546 ** Project management
547 I never use this, but apparently its very powerful. Another item on my todo list.
548 #+begin_src emacs-lisp
549 (use-package projectile
550 :config (projectile-mode)
551 :custom ((projectile-completion-system 'ivy))
553 ("C-c p" . projectile-command-map)
555 (when (file-directory-p "~/Code")
556 (setq projectile-project-search-path '("~/Code")))
557 (setq projectile-switch-project-action #'projectile-dired))
559 (use-package counsel-projectile
561 :config (counsel-projectile-mode))
564 The best file manager!
565 #+begin_src emacs-lisp
567 :straight (:type built-in)
568 :commands (dired dired-jump)
569 :custom ((dired-listing-switches "-agho --group-directories-first"))
570 :config (evil-collection-define-key 'normal 'dired-mode-map
571 "h" 'dired-single-up-directory
572 "l" 'dired-single-buffer))
574 (use-package dired-single
575 :commands (dired dired-jump))
577 (use-package dired-open
578 :commands (dired dired-jump)
579 :custom (dired-open-extensions '(("png" . "feh")
582 (use-package dired-hide-dotfiles
583 :hook (dired-mode . dired-hide-dotfiles-mode)
585 (evil-collection-define-key 'normal 'dired-mode-map
586 "H" 'dired-hide-dotfiles-mode))
590 **** TODO Write a command that commits hunk, skipping staging step.
591 A very good Git interface.
592 #+begin_src emacs-lisp
596 #+begin_src emacs-lisp
598 (use-package git-email
599 :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
600 :config (git-email-piem-mode))
602 * General text editing
604 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.
605 #+begin_src emacs-lisp
606 (use-package aggressive-indent
607 :config (global-aggressive-indent-mode))
610 Spell check in text mode, and in prog-mode comments.
611 #+begin_src emacs-lisp
612 (dolist (hook '(text-mode-hook))
613 (add-hook hook (lambda () (flyspell-mode))))
614 (dolist (hook '(change-log-mode-hook log-edit-mode-hook))
615 (add-hook hook (lambda () (flyspell-mode -1))))
616 (add-hook 'prog-mode (lambda () (flyspell-prog mode)))
617 (setq ispell-silently-savep t)
620 #+begin_src emacs-lisp
621 (setq-default tab-width 2)
624 Opens file where you left it.
625 #+begin_src emacs-lisp
629 Distraction free writing a la junegunn/goyo.
630 #+begin_src emacs-lisp
631 (use-package olivetti
632 :bind ("C-c o" . olivetti-mode))
635 Abbreviate things! I just use this for things like my email address and copyright notice.
636 #+begin_src emacs-lisp
637 (setq abbrev-file-name "~/.emacs.d/abbrevs.el")
638 (setq save-abbrevs 'silent)
639 (setq-default abbrev-mode t)
642 #+begin_src emacs-lisp
643 (setq tramp-default-method "ssh")
645 ** Follow version controlled symlinks
646 #+begin_src emacs-lisp
647 (setq vc-follow-symlinks t)
650 #+begin_src emacs-lisp
651 (defun doas-edit (&optional arg)
652 "Edit currently visited file as root.
654 With a prefix ARG prompt for a file to visit.
655 Will also prompt for a file to visit if current
656 buffer is not visiting a file.
658 Modified from Emacs Redux."
660 (if (or arg (not buffer-file-name))
661 (find-file (concat "/doas:root@localhost:"
662 (ido-read-file-name "Find file(as root): ")))
663 (find-alternate-file (concat "/doas:root@localhost:" buffer-file-name))))
665 (global-set-key (kbd "C-x C-r") #'doas-edit)
668 #+begin_src emacs-lisp
669 (use-package markdown-mode)
673 #+begin_src emacs-lisp
674 (use-package ace-window
675 :bind ("M-o" . ace-window))
677 ** Kill current buffer
678 Makes "C-x k" binding faster.
679 #+begin_src emacs-lisp
680 (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
684 #+begin_src emacs-lisp
685 (use-package scad-mode)
687 ** Control backup and lock files
688 Stop backup files from spewing everywhere.
689 #+begin_src emacs-lisp
690 (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
691 create-lockfiles nil)
693 ** Make yes/no easier
694 #+begin_src emacs-lisp
695 (defalias 'yes-or-no-p 'y-or-n-p)
697 ** Move customize file
698 No more clogging up init.el.
699 #+begin_src emacs-lisp
700 (setq custom-file "~/.emacs.d/custom.el")
704 #+begin_src emacs-lisp
706 :commands (helpful-callable helpful-variable helpful-command helpful-key)
708 (counsel-describe-function-function #'helpful-callable)
709 (counsel-describe-variable-function #'helpful-variable)
711 ([remap describe-function] . counsel-describe-function)
712 ([remap describe-command] . helpful-command)
713 ([remap describe-variable] . counsel-describe-variable)
714 ([remap describe-key] . helpful-key))
717 #+begin_src emacs-lisp
718 (use-package epa-file
719 :straight (:type built-in)
721 (epa-file-select-keys nil)
722 (epa-file-encrypt-to '("me@armaanb.net"))
723 (password-cache-expiry (* 60 15)))
725 (use-package pinentry
726 :config (pinentry-start))
729 #+begin_src emacs-lisp
731 :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
732 :custom (0x0-default-service 'envs))
734 ** Automatically clean buffers
735 Automatically close unused buffers (except those of Circe) at midnight.
736 #+begin_src emacs-lisp
738 (add-to-list 'clean-buffer-list-kill-never-regexps (lambda (buffer-name)
739 (with-current-buffer buffer-name
740 (derived-mode-p 'lui-mode))))
744 Spectrwm is a really awesome window manager! Would highly recommend.
746 #+begin_src conf :tangle ~/.spectrwm.conf
750 autorun = ws[1]:/home/armaa/Code/scripts/autostart
753 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.
754 #+begin_src conf :tangle ~/.spectrwm.conf
756 bar_font = xos4 JetBrains Mono:pixelsize=14:antialias=true # any installed font
759 I'm not a huge fan of how spectrwm handles keybindings, probably my biggest gripe with it.
761 #+begin_src conf :tangle ~/.spectrwm.conf
762 program[term] = st -e tmux
763 program[screenshot_all] = flameshot gui
764 program[notif] = /home/armaa/Code/scripts/setter status
765 program[pass] = /home/armaa/Code/scripts/passmenu
768 bind[pass] = MOD+Shift+p
771 #+begin_src conf :tangle ~/.spectrwm.conf
772 program[paup] = /home/armaa/Code/scripts/setter audio +5
773 program[padown] = /home/armaa/Code/scripts/setter audio -5
774 program[pamute] = /home/armaa/Code/scripts/setter audio
775 program[brigup] = /home/armaa/Code/scripts/setter brightness +10%
776 program[brigdown] = /home/armaa/Code/scripts/setter brightness 10%-
777 program[next] = playerctl next
778 program[prev] = playerctl previous
779 program[pause] = playerctl play-pause
781 bind[padown] = XF86AudioLowerVolume
782 bind[paup] = XF86AudioRaiseVolume
783 bind[pamute] = XF86AudioMute
784 bind[brigdown] = XF86MonBrightnessDown
785 bind[brigup] = XF86MonBrightnessUp
786 bind[pause] = XF86AudioPlay
787 bind[next] = XF86AudioNext
788 bind[prev] = XF86AudioPrev
791 #+begin_src conf :tangle ~/.spectrwm.conf
792 program[h] = xdotool keyup h key --clearmodifiers Left
793 program[j] = xdotool keyup j key --clearmodifiers Down
794 program[k] = xdotool keyup k key --clearmodifiers Up
795 program[l] = xdotool keyup l key --clearmodifiers Right
797 bind[h] = MOD + Control + h
798 bind[j] = MOD + Control + j
799 bind[k] = MOD + Control + k
800 bind[l] = MOD + Control + l
803 #+begin_src conf :tangle ~/.spectrwm.conf
804 program[email] = emacsclient -ce "(mu4e)"
805 program[irc] = emacsclient -ce '(switch-to-buffer "irc.armaanb.net:6698")'
806 program[rss] = emacsclient -ce '(elfeed)'
807 program[calendar] = emacsclient -ce '(acheam-calendar)'
808 program[calc] = emacsclient -ce '(progn (calc) (windmove-up) (delete-window))'
809 program[firefox] = firefox
810 program[emacs] = emacsclient -c
812 bind[email] = MOD+Control+1
813 bind[irc] = MOD+Control+2
814 bind[rss] = MOD+Control+3
815 bind[calendar] = MOD+Control+4
816 bind[calc] = MOD+Control+5
817 bind[firefox] = MOD+Control+0
818 bind[emacs] = MOD+Control+Return
821 Float some specific programs by default.
822 #+begin_src conf :tangle ~/.spectrwm.conf
823 quirk[Castle Menu] = FLOAT
828 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.
829 #+begin_src conf :tangle ~/.config/ash/ashrc
833 **** Update all packages
834 #+begin_src shell :tangle ~/.config/ash/ashrc
835 color=$(tput setaf 5)
839 doas echo "${color}== upgrading with yay ==${reset}"
842 echo "${color}== checking for pacnew files ==${reset}"
845 echo "${color}== upgrading flatpaks ==${reset}"
848 echo "${color}== updating nvim plugins ==${reset}"
849 nvim +PlugUpdate +PlugUpgrade +qall
850 echo "Updated nvim plugins"
852 echo "${color}You are entirely up to date!${reset}"
855 **** Clean all packages
856 #+begin_src shell :tangle ~/.config/ash/ashrc
858 doas echo "${color}== cleaning pacman orphans ==${reset}"
859 (pacman -Qtdq | doas pacman -Rns - 2> /dev/null) || echo "No orphans"
861 echo "${color}== cleaning flatpaks ==${reset}"
862 flatpak remove --unused
864 echo "${color}== cleaning nvim plugins ==${reset}"
865 nvim +PlugClean +qall
866 echo "Cleaned nvim plugins"
868 echo "${color}All orphans cleaned!${reset}"
871 **** Interact with 0x0
872 #+begin_src shell :tangle ~/.config/ash/ashrc
873 zxz="https://envs.sh"
874 ufile() { curl -F"file=@$1" "$zxz" ; }
875 upb() { curl -F"file=@-;" "$zxz" ; }
876 uurl() { curl -F"url=$1" "$zxz" ; }
877 ushort() { curl -F"shorten=$1" "$zxz" ; }
878 uclip() { xclip -out | curl -F"file=@-;" "$zxz" ; }
881 #+begin_src shell :tangle ~/.config/ash/ashrc
883 user=$(echo "$1" | cut -f 1 -d '@')
884 host=$(echo "$1" | cut -f 2 -d '@')
885 echo $user | nc "$host" 79
888 **** Upload to ftp.armaanb.net
889 #+begin_src shell :tangle ~/.config/ash/ashrc
891 rsync "$1" "root@armaanb.net:/var/ftp/pub/${2}"
892 echo "https://ftp.armaanb.net/pub/"$(basename "$1") | tee /dev/tty | xclip -sel c
896 #+begin_src shell :tangle ~/.config/ash/ashrc
897 export EDITOR="emacsclient -c"
898 export VISUAL="$EDITOR"
899 export TERM=xterm-256color # for compatability
901 export GPG_TTY="$(tty)"
902 export MANPAGER='nvim +Man!'
905 export GTK_USE_PORTAL=1
907 export PATH="/home/armaa/.local/bin:$PATH" # prioritize .local/bin
908 export PATH="/home/armaa/Code/scripts:$PATH" # prioritize my scripts
909 export PATH="/home/armaa/Code/scripts/bin:$PATH" # prioritize my bins
910 export PATH="$PATH:/home/armaa/.cargo/bin"
911 export PATH="$PATH:/home/armaa/.local/share/gem/ruby/2.7.0/bin"
912 export PATH="$PATH:/usr/sbin"
913 export PATH="$PATH:/opt/FreeTube/freetube"
915 export LC_ALL="en_US.UTF-8"
916 export LC_CTYPE="en_US.UTF-8"
917 export LANGUAGE="en_US.UTF-8"
919 export KISS_PATH="/home/armaa/Virtual/kiss/home/armaa/kiss-repo"
920 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/core"
921 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/extra"
922 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/xorg"
923 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/testing"
924 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-community/community"
925 export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
929 #+begin_src shell :tangle ~/.config/ash/ashrc
930 alias bhoji-drop='ssh -p 23 root@armaanb.net'
931 alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
932 alias union='ssh 192.168.1.18'
933 alias mine='ssh -p 23 root@pickupserver.cc'
934 alias tcf='ssh root@204.48.23.68'
935 alias ngmun='ssh root@157.245.89.25'
936 alias prox='ssh root@192.168.1.224'
937 alias ncq='ssh root@143.198.123.17'
938 alias envs='ssh acheam@envs.net'
941 #+begin_src shell :tangle ~/.config/ash/ashrc
942 alias ls='ls -lh --group-directories-first'
944 alias df='df -h / /boot'
951 alias grep='grep -in --color=auto'
952 alias mkdir='mkdir -pv'
953 alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar'
954 emacs() { $EDITOR "$@" & }
957 **** System management
958 #+begin_src shell :tangle ~/.config/ash/ashrc
959 alias crontab='crontab-argh'
961 alias pasu='git -C ~/.password-store push'
962 alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
966 #+begin_src shell :tangle ~/.config/ash/ashrc
967 alias ping='ping -c 10'
968 alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
969 alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
970 alias plan='T=$(mktemp) && \
971 rsync root@armaanb.net:/etc/finger/plan.txt "$T" && \
973 head -n -2 $T > $TT && \
975 echo "\nLast updated: $(date -R)" >> "$TT" && \
976 fold -sw 72 "$TT" > "$T"| \
977 rsync "$T" root@armaanb.net:/etc/finger/plan.txt'
979 **** Virtual machines, chroots
980 #+begin_src shell :tangle ~/.config/ash/ashrc
981 alias ckiss="doas chrooter ~/Virtual/kiss"
982 alias cdebian="doas chrooter ~/Virtual/debian bash"
983 alias cwindows='devour qemu-system-x86_64 \
988 -device VGA,vgamem_mb=64 \
992 -net user,smb=/home/armaa/Public \
993 -drive format=qcow2,file=/home/armaa/Virtual/windows.qcow2'
996 #+begin_src shell :tangle ~/.config/ash/ashrc
997 alias pip="python -m pip"
998 alias black="black -l 79"
1001 #+begin_src shell :tangle ~/.config/ash/ashrc
1002 alias words='gen-shell -c "words"'
1003 alias words-e='gen-shell -c "words ~E"'
1006 #+begin_src shell :tangle ~/.config/ash/ashrc
1007 alias zathura='devour zathura'
1008 alias cad='devour openscad'
1009 alias feh='devour feh'
1012 #+begin_src shell :tangle ~/.config/ash/ashrc
1014 alias api='yay -Syu'
1015 alias apii='doas pacman -S'
1016 alias app='yay -Rns'
1017 alias azf='pacman -Q | fzf'
1018 alias favorites='pacman -Qe | cut -d " " -f 1 > ~/Documents/favorites'
1021 #+begin_src shell :tangle ~/.config/ash/ashrc
1022 alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
1023 iflag=fullblock status=progress'
1024 alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
1025 iflag=fullblock status=progress'
1026 alias ytmusic="youtube-dl -x --add-metadata --audio-format aac \
1027 --restrict-filenames -o '%(title)s.%(ext)s'"
1028 alias cal="cal -3 --color=auto"
1032 #+begin_src python :tangle ~/.ipython/profile_default/ipython_config.py
1033 c.TerminalInteractiveShell.editing_mode = 'vi'
1034 c.InteractiveShell.colors = 'linux'
1035 c.TerminalInteractiveShell.confirm_exit = False
1038 Make MPV play a little bit smoother.
1039 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
1040 ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
1044 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!.
1045 #+begin_src conf :tangle ~/.inputrc
1046 set editing-mode emacs
1050 #+begin_src conf :tangle ~/.gitconfig
1052 name = Armaan Bhojwani
1053 email = me@armaanb.net
1054 signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
1057 #+begin_src conf :tangle ~/.gitconfig
1059 defaultBranch = main
1062 #+begin_src conf :tangle ~/.gitconfig
1067 #+begin_src conf :tangle ~/.gitconfig
1069 smtpserver = smtp.mailbox.org
1070 smtpuser = me@armaanb.net
1071 smtpencryption = ssl
1072 smtpserverport = 465
1076 #+begin_src conf :tangle ~/.gitconfig
1081 #+begin_src conf :tangle ~/.gitconfig
1084 sclone = clone --depth 1
1089 quickfix = commit . --amend --no-edit
1091 subup = submodule update --remote
1092 loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1093 pushnc = push -o skip-ci
1096 #+begin_src conf :tangle ~/.gitconfig
1102 Lightweight notification daemon. Eventually I'd like to replace this with something dbus-less.
1104 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1106 font = "JetBrains Mono Medium Nerd Font 11"
1108 format = "<b>%s</b>\n%b"
1110 indicate_hidden = yes
1113 show_age_threshold = 60
1116 geometry = "400x5-10+10"
1118 idle_threshold = 120
1120 sticky_history = yes
1122 separator_height = 1
1124 horizontal_padding = 8
1126 separator_color = "#ffffff"
1127 startup_notification = false
1130 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1137 close_all = mod4+shift+c
1138 history = mod4+ctrl+c
1141 background = "#222222"
1142 foreground = "#ffffff"
1143 highlight = "#ffffff"
1147 background = "#222222"
1148 foreground = "#ffffff"
1149 highlight = "#ffffff"
1153 background = "#222222"
1154 foreground = "#a60000"
1155 highlight = "#ffffff"
1159 The best document reader!
1161 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1163 map <A-b> toggle_statusbar
1164 set selection-clipboard clipboard
1167 set window-title-basename "true"
1168 set selection-clipboard "clipboard"
1171 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1172 set default-bg "#000000"
1173 set default-fg "#ffffff"
1174 set render-loading true
1175 set render-loading-bg "#000000"
1176 set render-loading-fg "#ffffff"
1178 set recolor-lightcolor "#000000" # bg
1179 set recolor-darkcolor "#ffffff" # fg
1183 Just some basic Firefox CSS. Will probably have to rewrite for the Proton redesign.
1184 *** Swap tab and URL bars
1185 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1187 -moz-box-ordinal-group: 1 !important;
1191 -moz-box-ordinal-group: 2 !important;
1195 -moz-box-ordinal-group: 3 !important;
1198 *** Hide URL bar when not focused.
1199 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1200 #navigator-toolbox:not(:focus-within):not(:hover) {
1204 #navigator-toolbox {
1205 transition: 0.1s margin-top ease-out;
1208 *** Black screen by default
1210 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1213 #browser vbox#appcontent tabbrowser,
1215 #tabbrowser-tabpanels,
1217 browser[type="content-primary"],
1218 browser[type="content"] > html,
1220 background: black !important;
1221 color: #fff !important;
1226 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css
1227 @-moz-document url("about:home"), url("about:blank"), url("about:newtab") {
1229 background: black !important;
1234 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.
1235 #+begin_src conf :tangle ~/.Xresources
1237 ,*.foreground: #ffffff
1238 ,*.background: #000000
1239 ,*.cursorColor: #ffffff
1274 I use tmux in order to keep my st build light. Still learning how it works.
1275 #+begin_src conf :tangle ~/.tmux.conf
1278 set-option -g history-limit 50000
1279 set-window-option -g mode-keys vi
1280 bind-key -T copy-mode-vi 'v' send -X begin-selection
1281 bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1285 #+begin_src conf :tangle ~/.gnupg/gpg.conf
1286 default-key 3C9ED82FFE788E4A
1290 #+begin_src conf :tangle ~/.gnupg/gpg-agent.conf
1291 pinentry-program /sbin/pinentry-gnome3
1293 default-cache-ttl 600
1294 allow-emacs-pinentry