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
98 (add-hook no-line-num (lambda () (display-line-numbers-mode 0))))
100 ** Highlight matching parenthesis
101 #+begin_src emacs-lisp
103 :config (show-paren-mode)
104 :custom (show-paren-style 'parenthesis))
107 *** Show current function
108 #+begin_src emacs-lisp
109 (which-function-mode)
111 *** Make position in file more descriptive
112 Show current column and file size.
113 #+begin_src emacs-lisp
115 (size-indication-mode)
118 #+begin_src emacs-lisp
120 :config (minions-mode))
123 Show a ruler at a certain number of chars depending on mode.
124 #+begin_src emacs-lisp
125 (setq display-fill-column-indicator-column 80)
126 (global-display-fill-column-indicator-mode)
129 When starting a key chord, show possible future steps after 0.3 seconds.
130 #+begin_src emacs-lisp
131 (use-package which-key
132 :config (which-key-mode)
133 :custom (which-key-idle-delay 0.3))
135 ** Highlight todo items in comments
136 #+begin_src emacs-lisp
138 :straight (hl-todo :type git :host github :repo "tarsius/hl-todo")
139 :config (global-hl-todo-mode 1))
142 #+begin_src emacs-lisp
146 Soft wrap words and do operations by visual lines except in programming modes.
147 #+begin_src emacs-lisp
149 (add-hook 'prog-mode-hook 'visual-line-mode 0)
151 ** Display number of matches in search
152 #+begin_src emacs-lisp
154 :config (global-anzu-mode))
157 Invert modeline color instead of audible bell or the standard visual bell.
158 #+begin_src emacs-lisp
159 (setq visible-bell nil
161 (lambda () (invert-face 'mode-line)
162 (run-with-timer 0.1 nil #'invert-face 'mode-line)))
166 #+begin_src emacs-lisp
168 :custom (select-enable-clipboard nil)
171 (fset 'evil-visual-update-x-selection 'ignore) ;; Keep clipboard and register seperate
172 ;; Use visual line motions even outside of visual-line-mode buffers
173 (evil-global-set-key 'motion "j" 'evil-next-visual-line)
174 (evil-global-set-key 'motion "k" 'evil-previous-visual-line)
175 (global-set-key (kbd "<escape>") 'keyboard-escape-quit))
178 Evil bindings for tons of packages.
179 #+begin_src emacs-lisp
180 (use-package evil-collection
182 :init (evil-collection-init)
183 :custom (evil-collection-setup-minibuffer t))
187 #+begin_src emacs-lisp
188 (use-package evil-surround
189 :config (global-evil-surround-mode))
192 Makes commenting super easy
193 #+begin_src emacs-lisp
194 (use-package evil-nerd-commenter
195 :bind (:map evil-normal-state-map
196 ("gc" . evilnc-comment-or-uncomment-lines))
197 :custom (evilnc-invert-comment-line-by-line nil))
201 #+begin_src emacs-lisp
202 (evil-set-undo-system 'undo-redo)
204 ** Number incrementing
205 Add back C-a/C-x bindings.
206 #+begin_src emacs-lisp
207 (use-package evil-numbers
208 :straight (evil-numbers :type git :host github :repo "juliapath/evil-numbers")
209 :bind (:map evil-normal-state-map
210 ("C-M-a" . evil-numbers/inc-at-pt)
211 ("C-M-x" . evil-numbers/dec-at-pt)))
214 #+begin_src emacs-lisp
215 (use-package evil-org
217 :hook (org-mode . evil-org-mode)
219 (evil-org-set-key-theme '(textobjects insert navigation shift todo)))
221 (use-package evil-org-agenda
222 :straight (:type built-in)
224 :config (evil-org-agenda-set-keys))
228 #+begin_src emacs-lisp
230 :straight (:type built-in)
231 :commands (org-capture org-agenda)
234 (org-agenda-start-with-log-mode t)
235 (org-agenda-files (quote ("~/Org/tasks.org" "~/Org/break.org")))
237 (org-log-into-drawer t)
238 (org-src-tab-acts-natively t)
239 (org-src-fontify-natively t)
240 (org-startup-indented t)
241 (org-hide-emphasis-markers t)
242 (org-fontify-whole-block-delimiter-line nil)
243 :bind ("C-c a" . org-agenda))
246 Define templates for lots of common structure elements. Mostly just used within this file.
247 #+begin_src emacs-lisp
248 (use-package org-tempo
250 :straight (:type built-in)
252 ;; TODO: There's gotta be a more efficient way to write this
253 (add-to-list 'org-structure-template-alist '("el" . "src emacs-lisp"))
254 (add-to-list 'org-structure-template-alist '("sp" . "src conf :tangle ~/.spectrwm.conf"))
255 (add-to-list 'org-structure-template-alist '("ash" . "src shell :tangle ~/.config/ash/ashrc"))
256 (add-to-list 'org-structure-template-alist '("ipy" . "src python :tangle ~/.ipython/"))
257 (add-to-list 'org-structure-template-alist '("pi" . "src conf :tangle ~/.config/picom/picom.conf"))
258 (add-to-list 'org-structure-template-alist '("git" . "src conf :tangle ~/.gitconfig"))
259 (add-to-list 'org-structure-template-alist '("du" . "src conf :tangle ~/.config/dunst/dunstrc"))
260 (add-to-list 'org-structure-template-alist '("za" . "src conf :tangle ~/.config/zathura/zathurarc"))
261 (add-to-list 'org-structure-template-alist '("ff1" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css"))
262 (add-to-list 'org-structure-template-alist '("ff2" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css"))
263 (add-to-list 'org-structure-template-alist '("xr" . "src conf :tangle ~/.Xresources"))
264 (add-to-list 'org-structure-template-alist '("tm" . "src conf :tangle ~/.tmux.conf"))
265 (add-to-list 'org-structure-template-alist '("gp" . "src conf :tangle ~/.gnupg/gpg.conf"))
266 (add-to-list 'org-structure-template-alist '("ag" . "src conf :tangle ~/.gnupg/gpg-agent.conf")))
270 A well balanced completion framework.
271 #+begin_src emacs-lisp
273 :bind (("C-s" . swiper)
274 :map ivy-minibuffer-map
275 ("TAB" . ivy-alt-done)
276 :map ivy-switch-buffer-map
277 ("M-d" . ivy-switch-buffer-kill))
281 #+begin_src emacs-lisp
282 (use-package ivy-rich
284 :config (ivy-rich-mode))
288 #+begin_src emacs-lisp
290 :bind (("C-M-j" . 'counsel-switch-buffer)
291 :map minibuffer-local-map
292 ("C-r" . 'counsel-minibuffer-history))
293 :custom (counsel-linux-app-format-function #'counsel-linux-app-format-function-name-only)
294 :config (counsel-mode))
296 ** Remember frequent commands
297 #+begin_src emacs-lisp
298 (use-package ivy-prescient
300 :custom (ivy-prescient-enable-filtering nil)
302 (prescient-persist-mode)
303 (ivy-prescient-mode))
306 Better search utility.
307 #+begin_src emacs-lisp
312 Use elfeed for reading RSS. I have another file with all the feeds in it that I'd rather keep private.
313 #+begin_src emacs-lisp
315 :bind (("C-c e" . elfeed))
317 (load "~/.emacs.d/feeds.el")
318 (add-hook 'elfeed-new-entry-hook
319 (elfeed-make-tagger :feed-url "youtube\\.com"
321 :bind (:map elfeed-search-mode-map ("C-c C-o" . 'elfeed-show-visit)))
323 (use-package elfeed-goodies
325 :config (elfeed-goodies/setup))
328 Use mu4e for reading emails.
330 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.
332 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.
333 #+begin_src emacs-lisp
334 (use-package smtpmail
335 :straight (:type built-in))
337 :load-path "/usr/share/emacs/site-lisp/mu4e"
338 :straight (:build nil)
339 :bind (("C-c m" . mu4e))
341 (setq user-full-name "Armaan Bhojwani"
342 smtpmail-local-domain "armaanb.net"
343 smtpmail-stream-type 'ssl
344 smtpmail-smtp-service '465
345 mu4e-change-filenames-when-moving t
346 mu4e-get-mail-command "offlineimap -q"
347 message-citation-line-format "On %a %d %b %Y at %R, %f wrote:\n"
348 message-citation-line-function 'message-insert-formatted-citation-line
349 mu4e-completing-read-function 'ivy-completing-read
350 mu4e-confirm-quit nil
352 mail-user-agent 'mu4e-user-agent
353 mail-context-policy 'pick-first
355 `( ,(make-mu4e-context
357 :enter-func (lambda () (mu4e-message "Entering school context"))
358 :leave-func (lambda () (mu4e-message "Leaving school context"))
359 :match-func (lambda (msg)
361 (string-match-p "^/school" (mu4e-message-field msg :maildir))))
362 :vars '((user-mail-address . "abhojwani22@nobles.edu")
363 (mu4e-sent-folder . "/school/Sent")
364 (mu4e-drafts-folder . "/school/Drafts")
365 (mu4e-trash-folder . "/school/Trash")
366 (mu4e-refile-folder . "/school/Archive")
367 (message-cite-reply-position . above)
368 (user-mail-address . "abhojwani22@nobles.edu")
369 (smtpmail-smtp-user . "abhojwani22@nobles.edu")
370 (smtpmail-smtp-server . "smtp.gmail.com")))
373 :enter-func (lambda () (mu4e-message "Entering personal context"))
374 :leave-func (lambda () (mu4e-message "Leaving personal context"))
375 :match-func (lambda (msg)
377 (string-match-p "^/personal" (mu4e-message-field msg :maildir))))
378 :vars '((mu4e-sent-folder . "/personal/Sent")
379 (mu4e-drafts-folder . "/personal/Drafts")
380 (mu4e-trash-folder . "/personal/Trash")
381 (mu4e-refile-folder . "/personal/Archive")
382 (user-mail-address . "me@armaanb.net")
383 (message-cite-reply-position . below)
384 (smtpmail-smtp-user . "me@armaanb.net")
385 (smtpmail-smtp-server . "smtp.mailbox.org")))))
386 (add-to-list 'mu4e-bookmarks
387 '(:name "Unified inbox"
388 :query "maildir:\"/personal/INBOX\" or maildir:\"/school/INBOX\""
390 :hook ((mu4e-compose-mode . flyspell-mode)
391 (mu4e-compose-mode . auto-fill-mode)
392 (mu4e-view-mode-hook . turn-on-visual-line-mode)
393 (message-send-hook . (lambda () (unless (yes-or-no-p "Ya sure 'bout that?")
394 (signal 'quit nil))))))
396 Discourage Gnus from displaying HTML emails
397 #+begin_src emacs-lisp
398 (with-eval-after-load "mm-decode"
399 (add-to-list 'mm-discouraged-alternatives "text/html")
400 (add-to-list 'mm-discouraged-alternatives "text/richtext"))
403 Set EWW as default browser except for multimedia which should open in MPV.
404 #+begin_src emacs-lisp
405 (defun browse-url-mpv (url &optional new-window)
408 (start-process "mpv" "*mpv*" "mpv" url))
410 (setq browse-url-handlers
412 (("youtu\\.?be" . browse-url-mpv)
413 ("peertube.*" . browse-url-mpv)
414 ("vid.*" . browse-url-mpv)
415 ("vid.*" . browse-url-mpv)
416 ("*.mp4" . browse-url-mpv)
417 ("*.mp3" . browse-url-mpv)
418 ("*.ogg" . browse-url-mpv)
419 ("." . eww-browse-url)
423 Some EWW enhancements.
424 *** Give buffer a useful name
425 #+begin_src emacs-lisp
426 ;; From https://protesilaos.com/dotemacs/
427 (defun prot-eww--rename-buffer ()
428 "Rename EWW buffer using page title or URL.
429 To be used by `eww-after-render-hook'."
430 (let ((name (if (eq "" (plist-get eww-data :title))
431 (plist-get eww-data :url)
432 (plist-get eww-data :title))))
433 (rename-buffer (format "*%s # eww*" name) t)))
436 :straight (:type built-in)
437 :bind (("C-c w" . eww))
438 :hook (eww-after-render-hook prot-eww--rename-buffer))
441 #+begin_src emacs-lisp
442 (global-set-key (kbd "C-c w") 'eww)
445 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.
446 #+begin_src emacs-lisp
447 (defun fetch-password (&rest params)
448 (require 'auth-source)
449 (let ((match (car (apply 'auth-source-search params))))
451 (let ((secret (plist-get match :secret)))
452 (if (functionp secret)
455 (error "Password not found for %S" params))))
460 (enable-circe-color-nicks)
461 (setq circe-network-defaults '(("libera"
462 :host "irc.armaanb.net"
467 :pass (lambda (null) (fetch-password
469 :machine "irc.armaanb.net"
472 :host "irc.armaanb.net"
477 :pass (lambda (null) (fetch-password
479 :machine "irc.armaanb.net"
482 :host "irc.armaanb.net"
487 :pass (lambda (null) (fetch-password
489 :machine "irc.armaanb.net"
494 :custom (circe-default-part-message "goodbye!")
495 :bind (:map circe-mode-map ("C-c C-r" . circe-reconnect-all)))
498 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.
499 #+begin_src emacs-lisp
500 (defun sync-calendar ()
501 "Sync calendars with vdirsyncer"
503 (shell-command "vdirsyncer -vcritical sync"))
506 :bind (:map cfw:calendar-mode-map ("C-S-u" . sync-calendar)))
507 (use-package calfw-ical)
508 (use-package calfw-org)
510 (defun acheam-calendar ()
513 (cfw:open-calendar-buffer
514 :contents-sources (list
515 (cfw:org-create-source "Green")
516 (cfw:ical-create-source
518 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
520 (cfw:ical-create-source
522 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
524 (cfw:ical-create-source
526 "~/.local/share/vdirsyncer/school/abhojwani22@nobles.edu.ics"
530 (global-set-key (kbd "C-c c") 'acheam-calendar)
534 #+begin_src emacs-lisp
536 :hook (python-mode . blacken-mode)
537 :custom (blacken-line-length 79))
540 ** Strip trailing whitespace
541 #+begin_src emacs-lisp
542 (use-package ws-butler
543 :config (ws-butler-global-mode))
546 Automatic linting. I need to look into configuring this more.
547 #+begin_src emacs-lisp
548 (use-package flycheck
549 :config (global-flycheck-mode))
551 ** Project management
552 I never use this, but apparently its very powerful. Another item on my todo list.
553 #+begin_src emacs-lisp
554 (use-package projectile
555 :config (projectile-mode)
556 :custom ((projectile-completion-system 'ivy))
558 ("C-c p" . projectile-command-map)
560 (when (file-directory-p "~/Code")
561 (setq projectile-project-search-path '("~/Code")))
562 (setq projectile-switch-project-action #'projectile-dired))
564 (use-package counsel-projectile
566 :config (counsel-projectile-mode))
569 The best file manager!
570 #+begin_src emacs-lisp
572 :straight (:type built-in)
573 :commands (dired dired-jump)
574 :custom ((dired-listing-switches "-agho --group-directories-first"))
575 :config (evil-collection-define-key 'normal 'dired-mode-map
576 "h" 'dired-single-up-directory
577 "l" 'dired-single-buffer))
579 (use-package dired-single
580 :commands (dired dired-jump))
582 (use-package dired-open
583 :commands (dired dired-jump)
584 :custom (dired-open-extensions '(("png" . "feh")
587 (use-package dired-hide-dotfiles
588 :hook (dired-mode . dired-hide-dotfiles-mode)
590 (evil-collection-define-key 'normal 'dired-mode-map
591 "H" 'dired-hide-dotfiles-mode))
595 **** TODO Write a command that commits hunk, skipping staging step.
596 A very good Git interface.
597 #+begin_src emacs-lisp
601 #+begin_src emacs-lisp
603 (use-package git-email
604 :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
605 :config (git-email-piem-mode))
607 * General text editing
609 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.
610 #+begin_src emacs-lisp
611 (use-package aggressive-indent
612 :config (global-aggressive-indent-mode))
615 Spell check in text mode, and in prog-mode comments.
616 #+begin_src emacs-lisp
617 (dolist (hook '(text-mode-hook))
618 (add-hook hook (lambda () (flyspell-mode))))
619 (dolist (hook '(change-log-mode-hook log-edit-mode-hook))
620 (add-hook hook (lambda () (flyspell-mode -1))))
621 (add-hook 'prog-mode (lambda () (flyspell-prog mode)))
622 (setq ispell-silently-savep t)
625 #+begin_src emacs-lisp
626 (setq-default tab-width 2)
629 Opens file where you left it.
630 #+begin_src emacs-lisp
634 Distraction free writing a la junegunn/goyo.
635 #+begin_src emacs-lisp
636 (use-package olivetti
637 :bind ("C-c o" . olivetti-mode))
640 Abbreviate things! I just use this for things like my email address and copyright notice.
641 #+begin_src emacs-lisp
642 (setq abbrev-file-name "~/.emacs.d/abbrevs.el")
643 (setq save-abbrevs 'silent)
644 (setq-default abbrev-mode t)
647 #+begin_src emacs-lisp
648 (setq tramp-default-method "ssh")
650 ** Follow version controlled symlinks
651 #+begin_src emacs-lisp
652 (setq vc-follow-symlinks t)
655 #+begin_src emacs-lisp
656 (defun doas-edit (&optional arg)
657 "Edit currently visited file as root.
659 With a prefix ARG prompt for a file to visit.
660 Will also prompt for a file to visit if current
661 buffer is not visiting a file.
663 Modified from Emacs Redux."
665 (if (or arg (not buffer-file-name))
666 (find-file (concat "/doas:root@localhost:"
667 (ido-read-file-name "Find file(as root): ")))
668 (find-alternate-file (concat "/doas:root@localhost:" buffer-file-name))))
670 (global-set-key (kbd "C-x C-r") #'doas-edit)
673 #+begin_src emacs-lisp
674 (use-package markdown-mode)
678 #+begin_src emacs-lisp
679 (use-package ace-window
680 :bind ("M-o" . ace-window))
682 ** Kill current buffer
683 Makes "C-x k" binding faster.
684 #+begin_src emacs-lisp
685 (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
689 #+begin_src emacs-lisp
690 (use-package scad-mode)
692 ** Control backup and lock files
693 Stop backup files from spewing everywhere.
694 #+begin_src emacs-lisp
695 (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
696 create-lockfiles nil)
698 ** Make yes/no easier
699 #+begin_src emacs-lisp
700 (defalias 'yes-or-no-p 'y-or-n-p)
702 ** Move customize file
703 No more clogging up init.el.
704 #+begin_src emacs-lisp
705 (setq custom-file "~/.emacs.d/custom.el")
709 #+begin_src emacs-lisp
711 :commands (helpful-callable helpful-variable helpful-command helpful-key)
713 (counsel-describe-function-function #'helpful-callable)
714 (counsel-describe-variable-function #'helpful-variable)
716 ([remap describe-function] . counsel-describe-function)
717 ([remap describe-command] . helpful-command)
718 ([remap describe-variable] . counsel-describe-variable)
719 ([remap describe-key] . helpful-key))
722 #+begin_src emacs-lisp
723 (use-package epa-file
724 :straight (:type built-in)
726 (epa-file-select-keys nil)
727 (epa-file-encrypt-to '("me@armaanb.net"))
728 (password-cache-expiry (* 60 15)))
730 (use-package pinentry
731 :config (pinentry-start))
734 #+begin_src emacs-lisp
736 :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
737 :custom (0x0-default-service 'envs))
739 ** Automatically clean buffers
740 Automatically close unused buffers (except those of Circe) at midnight.
741 #+begin_src emacs-lisp
743 (add-to-list 'clean-buffer-list-kill-never-regexps (lambda (buffer-name)
744 (with-current-buffer buffer-name
745 (derived-mode-p 'lui-mode))))
749 Spectrwm is a really awesome window manager! Would highly recommend.
751 #+begin_src conf :tangle ~/.spectrwm.conf
755 autorun = ws[1]:/home/armaa/Code/scripts/autostart
758 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.
759 #+begin_src conf :tangle ~/.spectrwm.conf
761 bar_font = xos4 JetBrains Mono:pixelsize=14:antialias=true # any installed font
764 I'm not a huge fan of how spectrwm handles keybindings, probably my biggest gripe with it.
766 #+begin_src conf :tangle ~/.spectrwm.conf
767 program[term] = st -e tmux
768 program[screenshot_all] = flameshot gui
769 program[notif] = /home/armaa/Code/scripts/setter status
770 program[pass] = /home/armaa/Code/scripts/passmenu
773 bind[pass] = MOD+Shift+p
776 #+begin_src conf :tangle ~/.spectrwm.conf
777 program[paup] = /home/armaa/Code/scripts/setter audio +5
778 program[padown] = /home/armaa/Code/scripts/setter audio -5
779 program[pamute] = /home/armaa/Code/scripts/setter audio
780 program[brigup] = /home/armaa/Code/scripts/setter brightness +10%
781 program[brigdown] = /home/armaa/Code/scripts/setter brightness 10%-
782 program[next] = playerctl next
783 program[prev] = playerctl previous
784 program[pause] = playerctl play-pause
786 bind[padown] = XF86AudioLowerVolume
787 bind[paup] = XF86AudioRaiseVolume
788 bind[pamute] = XF86AudioMute
789 bind[brigdown] = XF86MonBrightnessDown
790 bind[brigup] = XF86MonBrightnessUp
791 bind[pause] = XF86AudioPlay
792 bind[next] = XF86AudioNext
793 bind[prev] = XF86AudioPrev
796 #+begin_src conf :tangle ~/.spectrwm.conf
797 program[h] = xdotool keyup h key --clearmodifiers Left
798 program[j] = xdotool keyup j key --clearmodifiers Down
799 program[k] = xdotool keyup k key --clearmodifiers Up
800 program[l] = xdotool keyup l key --clearmodifiers Right
802 bind[h] = MOD + Control + h
803 bind[j] = MOD + Control + j
804 bind[k] = MOD + Control + k
805 bind[l] = MOD + Control + l
808 #+begin_src conf :tangle ~/.spectrwm.conf
809 program[email] = emacsclient -ce "(mu4e)"
810 program[irc] = emacsclient -ce '(switch-to-buffer "irc.armaanb.net:6698")'
811 program[rss] = emacsclient -ce '(elfeed)'
812 program[calendar] = emacsclient -ce '(acheam-calendar)'
813 program[calc] = emacsclient -ce '(progn (calc) (windmove-up) (delete-window))'
814 program[firefox] = firefox
815 program[emacs] = emacsclient -c
817 bind[email] = MOD+Control+1
818 bind[irc] = MOD+Control+2
819 bind[rss] = MOD+Control+3
820 bind[calendar] = MOD+Control+4
821 bind[calc] = MOD+Control+5
822 bind[firefox] = MOD+Control+0
823 bind[emacs] = MOD+Control+Return
826 Float some specific programs by default.
827 #+begin_src conf :tangle ~/.spectrwm.conf
828 quirk[Castle Menu] = FLOAT
833 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.
834 #+begin_src conf :tangle ~/.config/ash/ashrc
838 **** Update all packages
839 #+begin_src shell :tangle ~/.config/ash/ashrc
840 color=$(tput setaf 5)
844 doas echo "${color}== upgrading with yay ==${reset}"
847 echo "${color}== checking for pacnew files ==${reset}"
850 echo "${color}== upgrading flatpaks ==${reset}"
853 echo "${color}== updating nvim plugins ==${reset}"
854 nvim +PlugUpdate +PlugUpgrade +qall
855 echo "Updated nvim plugins"
857 echo "${color}You are entirely up to date!${reset}"
860 **** Clean all packages
861 #+begin_src shell :tangle ~/.config/ash/ashrc
863 doas echo "${color}== cleaning pacman orphans ==${reset}"
864 (pacman -Qtdq | doas pacman -Rns - 2> /dev/null) || echo "No orphans"
866 echo "${color}== cleaning flatpaks ==${reset}"
867 flatpak remove --unused
869 echo "${color}== cleaning nvim plugins ==${reset}"
870 nvim +PlugClean +qall
871 echo "Cleaned nvim plugins"
873 echo "${color}All orphans cleaned!${reset}"
876 **** Interact with 0x0
877 #+begin_src shell :tangle ~/.config/ash/ashrc
878 zxz="https://envs.sh"
879 ufile() { curl -F"file=@$1" "$zxz" ; }
880 upb() { curl -F"file=@-;" "$zxz" ; }
881 uurl() { curl -F"url=$1" "$zxz" ; }
882 ushort() { curl -F"shorten=$1" "$zxz" ; }
883 uclip() { xclip -out | curl -F"file=@-;" "$zxz" ; }
886 #+begin_src shell :tangle ~/.config/ash/ashrc
888 user=$(echo "$1" | cut -f 1 -d '@')
889 host=$(echo "$1" | cut -f 2 -d '@')
890 echo $user | nc "$host" 79
893 **** Upload to ftp.armaanb.net
894 #+begin_src shell :tangle ~/.config/ash/ashrc
896 rsync "$1" "root@armaanb.net:/var/ftp/pub/${2}"
897 echo "https://ftp.armaanb.net/pub/"$(basename "$1") | tee /dev/tty | xclip -sel c
901 #+begin_src shell :tangle ~/.config/ash/ashrc
902 export EDITOR="emacsclient -c"
903 export VISUAL="$EDITOR"
904 export TERM=xterm-256color # for compatability
906 export GPG_TTY="$(tty)"
907 export MANPAGER='nvim +Man!'
910 export GTK_USE_PORTAL=1
912 export PATH="/home/armaa/.local/bin:$PATH" # prioritize .local/bin
913 export PATH="/home/armaa/Code/scripts:$PATH" # prioritize my scripts
914 export PATH="/home/armaa/Code/scripts/bin:$PATH" # prioritize my bins
915 export PATH="$PATH:/home/armaa/.cargo/bin"
916 export PATH="$PATH:/home/armaa/.local/share/gem/ruby/2.7.0/bin"
917 export PATH="$PATH:/usr/sbin"
918 export PATH="$PATH:/opt/FreeTube/freetube"
920 export LC_ALL="en_US.UTF-8"
921 export LC_CTYPE="en_US.UTF-8"
922 export LANGUAGE="en_US.UTF-8"
924 export KISS_PATH="/home/armaa/Virtual/kiss/home/armaa/kiss-repo"
925 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/core"
926 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/extra"
927 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/xorg"
928 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/testing"
929 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-community/community"
930 export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
934 #+begin_src shell :tangle ~/.config/ash/ashrc
935 alias bhoji-drop='ssh -p 23 root@armaanb.net'
936 alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
937 alias union='ssh 192.168.1.18'
938 alias mine='ssh -p 23 root@pickupserver.cc'
939 alias tcf='ssh root@204.48.23.68'
940 alias ngmun='ssh root@157.245.89.25'
941 alias prox='ssh root@192.168.1.224'
942 alias ncq='ssh root@143.198.123.17'
943 alias envs='ssh acheam@envs.net'
946 #+begin_src shell :tangle ~/.config/ash/ashrc
947 alias ls='ls -lh --group-directories-first'
949 alias df='df -h / /boot'
956 alias grep='grep -in --color=auto'
957 alias mkdir='mkdir -pv'
958 alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar'
959 emacs() { $EDITOR "$@" & }
962 **** System management
963 #+begin_src shell :tangle ~/.config/ash/ashrc
964 alias crontab='crontab-argh'
966 alias pasu='git -C ~/.password-store push'
967 alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
971 #+begin_src shell :tangle ~/.config/ash/ashrc
972 alias ping='ping -c 10'
973 alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
974 alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
975 alias plan='T=$(mktemp) && \
976 rsync root@armaanb.net:/etc/finger/plan.txt "$T" && \
978 head -n -2 $T > $TT && \
980 echo "\nLast updated: $(date -R)" >> "$TT" && \
981 fold -sw 72 "$TT" > "$T"| \
982 rsync "$T" root@armaanb.net:/etc/finger/plan.txt'
984 **** Virtual machines, chroots
985 #+begin_src shell :tangle ~/.config/ash/ashrc
986 alias ckiss="doas chrooter ~/Virtual/kiss"
987 alias cdebian="doas chrooter ~/Virtual/debian bash"
988 alias cwindows='devour qemu-system-x86_64 \
993 -device VGA,vgamem_mb=64 \
997 -net user,smb=/home/armaa/Public \
998 -drive format=qcow2,file=/home/armaa/Virtual/windows.qcow2'
1001 #+begin_src shell :tangle ~/.config/ash/ashrc
1002 alias pip="python -m pip"
1003 alias black="black -l 79"
1006 #+begin_src shell :tangle ~/.config/ash/ashrc
1007 alias words='gen-shell -c "words"'
1008 alias words-e='gen-shell -c "words ~E"'
1011 #+begin_src shell :tangle ~/.config/ash/ashrc
1012 alias zathura='devour zathura'
1013 alias cad='devour openscad'
1014 alias feh='devour feh'
1017 #+begin_src shell :tangle ~/.config/ash/ashrc
1019 alias api='yay -Syu'
1020 alias apii='doas pacman -S'
1021 alias app='yay -Rns'
1022 alias azf='pacman -Q | fzf'
1023 alias favorites='pacman -Qe | cut -d " " -f 1 > ~/Documents/favorites'
1026 #+begin_src shell :tangle ~/.config/ash/ashrc
1027 alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
1028 iflag=fullblock status=progress'
1029 alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
1030 iflag=fullblock status=progress'
1031 alias ytmusic="youtube-dl -x --add-metadata --audio-format aac \
1032 --restrict-filenames -o '%(title)s.%(ext)s'"
1033 alias cal="cal -3 --color=auto"
1037 #+begin_src python :tangle ~/.ipython/profile_default/ipython_config.py
1038 c.TerminalInteractiveShell.editing_mode = 'vi'
1039 c.InteractiveShell.colors = 'linux'
1040 c.TerminalInteractiveShell.confirm_exit = False
1043 Make MPV play a little bit smoother.
1044 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
1045 ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
1049 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!.
1050 #+begin_src conf :tangle ~/.inputrc
1051 set editing-mode emacs
1055 #+begin_src conf :tangle ~/.gitconfig
1057 name = Armaan Bhojwani
1058 email = me@armaanb.net
1059 signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
1062 #+begin_src conf :tangle ~/.gitconfig
1064 defaultBranch = main
1067 #+begin_src conf :tangle ~/.gitconfig
1072 #+begin_src conf :tangle ~/.gitconfig
1074 smtpserver = smtp.mailbox.org
1075 smtpuser = me@armaanb.net
1076 smtpencryption = ssl
1077 smtpserverport = 465
1081 #+begin_src conf :tangle ~/.gitconfig
1086 #+begin_src conf :tangle ~/.gitconfig
1089 sclone = clone --depth 1
1094 quickfix = commit . --amend --no-edit
1096 subup = submodule update --remote
1097 loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1098 pushnc = push -o skip-ci
1101 #+begin_src conf :tangle ~/.gitconfig
1107 Lightweight notification daemon. Eventually I'd like to replace this with something dbus-less.
1109 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1111 font = "JetBrains Mono Medium Nerd Font 11"
1113 format = "<b>%s</b>\n%b"
1115 indicate_hidden = yes
1118 show_age_threshold = 60
1121 geometry = "400x5-10+10"
1123 idle_threshold = 120
1125 sticky_history = yes
1127 separator_height = 1
1129 horizontal_padding = 8
1131 separator_color = "#ffffff"
1132 startup_notification = false
1135 #+begin_src conf :tangle ~/.config/dunst/dunstrc
1142 close_all = mod4+shift+c
1143 history = mod4+ctrl+c
1146 background = "#222222"
1147 foreground = "#ffffff"
1148 highlight = "#ffffff"
1152 background = "#222222"
1153 foreground = "#ffffff"
1154 highlight = "#ffffff"
1158 background = "#222222"
1159 foreground = "#a60000"
1160 highlight = "#ffffff"
1164 The best document reader!
1166 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1168 map <A-b> toggle_statusbar
1169 set selection-clipboard clipboard
1172 set window-title-basename "true"
1173 set selection-clipboard "clipboard"
1176 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1177 set default-bg "#000000"
1178 set default-fg "#ffffff"
1179 set render-loading true
1180 set render-loading-bg "#000000"
1181 set render-loading-fg "#ffffff"
1183 set recolor-lightcolor "#000000" # bg
1184 set recolor-darkcolor "#ffffff" # fg
1188 Just some basic Firefox CSS. Will probably have to rewrite for the Proton redesign.
1189 *** Swap tab and URL bars
1190 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1192 -moz-box-ordinal-group: 1 !important;
1196 -moz-box-ordinal-group: 2 !important;
1200 -moz-box-ordinal-group: 3 !important;
1203 *** Hide URL bar when not focused.
1204 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1205 #navigator-toolbox:not(:focus-within):not(:hover) {
1209 #navigator-toolbox {
1210 transition: 0.1s margin-top ease-out;
1213 *** Black screen by default
1215 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css
1218 #browser vbox#appcontent tabbrowser,
1220 #tabbrowser-tabpanels,
1222 browser[type="content-primary"],
1223 browser[type="content"] > html,
1225 background: black !important;
1226 color: #fff !important;
1231 #+begin_src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css
1232 @-moz-document url("about:home"), url("about:blank"), url("about:newtab") {
1234 background: black !important;
1239 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.
1240 #+begin_src conf :tangle ~/.Xresources
1242 ,*.foreground: #ffffff
1243 ,*.background: #000000
1244 ,*.cursorColor: #ffffff
1279 I use tmux in order to keep my st build light. Still learning how it works.
1280 #+begin_src conf :tangle ~/.tmux.conf
1283 set-option -g history-limit 50000
1284 set-window-option -g mode-keys vi
1285 bind-key -T copy-mode-vi 'v' send -X begin-selection
1286 bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1290 #+begin_src conf :tangle ~/.gnupg/gpg.conf
1291 default-key 3C9ED82FFE788E4A
1295 #+begin_src conf :tangle ~/.gnupg/gpg-agent.conf
1296 pinentry-program /sbin/pinentry-gnome3
1298 default-cache-ttl 600
1299 allow-emacs-pinentry