1 #+TITLE: System Configuration
2 #+DESCRIPTION: Personal system configuration in org-mode format.
3 #+AUTHOR: Armaan Bhojwani
4 #+EMAIL: me@armaanb.net
7 Welcome to my system configuration! This file contains my Emacs configuration, but also my config files for many of the other programs on my system!
9 I am currently using Emacs 28 with native compilation, so some settings and packages may not be available for older versions of Emacs. This is a purely personal configuration, so while I can guarantee that it works on my setup, it might not work for you.
11 I chose to create a powerful, yet not overly heavy Emacs configuration. Things like a fancy modeline, icons, or LSP mode do not increase my productivity, and create visual clutter, and thus have been excluded.
13 Another important choice has been to integrate Emacs into a large part of my computing environment (see [[*Emacs OS]]). I use email, IRC, RSS, et cetera, all through Emacs which simplifies my workflow and creates an amazingly integrated environment.
15 Lastly, I use Evil mode. Modal keybindings are simpler and more ergonomic than standard Emacs style, and Vim keybindings are what I'm comfortable with and are pervasive throughout computing.
17 *** TODO Turn keybinding and hook declarations into use-package declarations where possible
18 *** TODO Include offlineimap config
20 Released under the [[https://opensource.org/licenses/MIT][MIT license]] by Armaan Bhojwani, 2021. Note that many snippets are taken from online, and other sources, who are credited for their work near their contributions.
22 ** Bootstrap straight.el
23 straight.el is really nice for managing package, and it integrates nicely with use-package. It uses the bootstrapping system defined here for installation.
24 #+begin_src emacs-lisp
25 (defvar native-comp-deferred-compilation-deny-list ())
26 (defvar bootstrap-version)
28 (expand-file-name "straight/repos/straight.el/bootstrap.el" user-emacs-directory))
29 (bootstrap-version 5))
30 (unless (file-exists-p bootstrap-file)
32 (url-retrieve-synchronously
33 "https://raw.githubusercontent.com/raxod502/straight.el/develop/install.el"
34 'silent 'inhibit-cookies)
35 (goto-char (point-max))
36 (eval-print-last-sexp)))
37 (load bootstrap-file nil 'nomessage))
39 ** Replace package.el with straight
40 #+begin_src emacs-lisp
41 (straight-use-package 'use-package)
42 (setq straight-use-package-by-default t)
46 Use the Modus Operandi theme by Protesilaos Stavrou. Its the best theme for Emacs by far, because how clear and readable it is. It is highly customizable, but I just set a few options here.
47 #+begin_src emacs-lisp
48 (setq modus-themes-slanted-constructs t
49 modus-themes-bold-constructs t
50 modus-themes-mode-line '3d
51 modus-themes-scale-headings t
52 modus-themes-diffs 'desaturated)
53 (load-theme 'modus-vivendi t)
57 JetBrains Mono is a great programming font with ligatures. The "NF" means that it has been patched with the [[https://www.nerdfonts.com/][Nerd Fonts]].
58 #+begin_src emacs-lisp
59 (add-to-list 'default-frame-alist '(font . "JetBrainsMonoNF-12"))
62 #+begin_src emacs-lisp
64 :straight (ligature :type git :host github :repo "mickeynp/ligature.el")
66 (ligature-set-ligatures
67 '(prog-mode text-mode)
68 '("-|" "-~" "---" "-<<" "-<" "--" "->" "->>" "-->" "/=" "/=="
69 "/>" "//" "/*" "*>" "*/" "<-" "<<-" "<=>" "<=" "<|" "<||"
70 "<|||" "<|>" "<:" "<>" "<-<" "<<<" "<==" "<<=" "<=<" "<==>"
71 "<-|" "<<" "<~>" "<=|" "<~~" "<~" "<$>" "<$" "<+>" "<+" "</>"
72 "</" "<*" "<*>" "<->" "<!--" ":>" ":<" ":::" "::" ":?" ":?>"
73 ":=" "::=" "=>>" "==>" "=/=" "=!=" "=>" "===" "=:=" "==" "!=="
74 "!!" "!=" ">]" ">:" ">>-" ">>=" ">=>" ">>>" ">-" ">=" "&&&"
75 "&&" "|||>" "||>" "|>" "|]" "|}" "|=>" "|->" "|=" "||-" "|-"
76 "||=" "||" ".." ".?" ".=" ".-" "..<" "..." "+++" "+>" "++"
77 "[||]" "[<" "[|" "{|" "?." "?=" "?:" "##" "###" "####" "#["
78 "#{" "#=" "#!" "#:" "#_(" "#_" "#?" "#(" ";;" "_|_" "__" "~~"
79 "~~>" "~>" "~-" "~@" "$>" "^=" "]#"))
80 (global-ligature-mode t))
83 Display relative line numbers except in certain modes.
84 #+begin_src emacs-lisp
85 (global-display-line-numbers-mode)
86 (setq display-line-numbers-type 'relative)
87 (dolist (no-line-num '(term-mode-hook
93 (add-hook no-line-num (lambda () (display-line-numbers-mode 0))))
95 ** Highlight matching parenthesis
96 #+begin_src emacs-lisp
98 :config (show-paren-mode)
99 :custom (show-paren-style 'parenthesis))
102 *** Show current function
103 #+begin_src emacs-lisp
104 (which-function-mode)
106 *** Make position in file more descriptive
107 Show current column and file size.
108 #+begin_src emacs-lisp
110 (size-indication-mode)
113 #+begin_src emacs-lisp
115 :config (minions-mode))
118 Show a ruler at a certain number of chars depending on mode.
119 #+begin_src emacs-lisp
120 (setq display-fill-column-indicator-column 80)
121 (global-display-fill-column-indicator-mode)
124 When starting a key chord, show possible future steps after 0.3 seconds.
125 #+begin_src emacs-lisp
126 (use-package which-key
127 :config (which-key-mode)
128 :custom (which-key-idle-delay 0.3))
130 ** Highlight todo items in comments
131 #+begin_src emacs-lisp
133 :straight (hl-todo :type git :host github :repo "tarsius/hl-todo")
134 :config (global-hl-todo-mode 1))
137 #+begin_src emacs-lisp
141 Soft wrap words and do operations by visual lines except in programming modes.
142 #+begin_src emacs-lisp
143 (global-visual-line-mode 1)
144 (dolist (hook '(prog-mode-hook
146 mu4e-headers-mode-hook))
147 (add-hook hook (lambda () (visual-line-mode -1))))
149 ** Display number of matches in search
150 #+begin_src emacs-lisp
152 :config (global-anzu-mode))
155 Invert modeline color instead of audible bell or the standard visual bell.
156 #+begin_src emacs-lisp
157 (setq visible-bell nil
159 (lambda () (invert-face 'mode-line)
160 (run-with-timer 0.1 nil #'invert-face 'mode-line)))
164 #+begin_src emacs-lisp
166 :custom (select-enable-clipboard nil)
169 (fset 'evil-visual-update-x-selection 'ignore) ;; Keep clipboard and register seperate
170 ;; Use visual line motions even outside of visual-line-mode buffers
171 (evil-global-set-key 'motion "j" 'evil-next-visual-line)
172 (evil-global-set-key 'motion "k" 'evil-previous-visual-line)
173 (global-set-key (kbd "<escape>") 'keyboard-escape-quit))
176 Evil bindings for tons of packages.
177 #+begin_src emacs-lisp
178 (use-package evil-collection
180 :init (evil-collection-init)
181 :custom (evil-collection-setup-minibuffer t))
185 #+begin_src emacs-lisp
186 (use-package evil-surround
187 :config (global-evil-surround-mode))
190 Makes commenting super easy
191 #+begin_src emacs-lisp
192 (use-package evil-nerd-commenter
193 :bind (:map evil-normal-state-map
194 ("gc" . evilnc-comment-or-uncomment-lines))
195 :custom (evilnc-invert-comment-line-by-line nil))
199 #+begin_src emacs-lisp
200 (evil-set-undo-system 'undo-redo)
202 ** Number incrementing
203 Add back C-a/C-x bindings.
204 #+begin_src emacs-lisp
205 (use-package evil-numbers
206 :straight (evil-numbers :type git :host github :repo "juliapath/evil-numbers")
207 :bind (:map evil-normal-state-map
208 ("C-M-a" . evil-numbers/inc-at-pt)
209 ("C-M-x" . evil-numbers/dec-at-pt)))
212 #+begin_src emacs-lisp
213 (use-package evil-org
215 :hook (org-mode . evil-org-mode)
217 (evil-org-set-key-theme '(textobjects insert navigation shift todo)))
219 (use-package evil-org-agenda
220 :straight (:type built-in)
222 :config (evil-org-agenda-set-keys))
226 #+begin_src emacs-lisp
228 :straight (:type built-in)
229 :commands (org-capture org-agenda)
232 (org-agenda-start-with-log-mode t)
233 (org-agenda-files (quote ("~/Org/tasks.org" "~/Org/break.org")))
235 (org-log-into-drawer t)
236 (org-src-tab-acts-natively t)
237 (org-src-fontify-natively t)
238 (org-startup-indented t)
239 (org-hide-emphasis-markers t)
240 (org-fontify-whole-block-delimiter-line nil)
241 :bind ("C-c a" . org-agenda))
244 Define templates for lots of common structure elements. Mostly just used within this file.
245 #+begin_src emacs-lisp
246 (use-package org-tempo
248 :straight (:type built-in)
250 ;; TODO: There's gotta be a more efficient way to write this
251 (add-to-list 'org-structure-template-alist '("el" . "src emacs-lisp"))
252 (add-to-list 'org-structure-template-alist '("sp" . "src conf :tangle ~/.spectrwm.conf"))
253 (add-to-list 'org-structure-template-alist '("ash" . "src shell :tangle ~/.config/ash/ashrc"))
254 (add-to-list 'org-structure-template-alist '("pi" . "src conf :tangle ~/.config/picom/picom.conf"))
255 (add-to-list 'org-structure-template-alist '("git" . "src conf :tangle ~/.gitconfig"))
256 (add-to-list 'org-structure-template-alist '("du" . "src conf :tangle ~/.config/dunst/dunstrc"))
257 (add-to-list 'org-structure-template-alist '("za" . "src conf :tangle ~/.config/zathura/zathurarc"))
258 (add-to-list 'org-structure-template-alist '("ff1" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userChrome.css"))
259 (add-to-list 'org-structure-template-alist '("ff2" . "src css :tangle ~/.mozilla/firefox/armaan-release/chrome/userContent.css"))
260 (add-to-list 'org-structure-template-alist '("xr" . "src conf :tangle ~/.Xresources"))
261 (add-to-list 'org-structure-template-alist '("tm" . "src conf :tangle ~/.tmux.conf"))
262 (add-to-list 'org-structure-template-alist '("gp" . "src conf :tangle ~/.gnupg/gpg.conf"))
263 (add-to-list 'org-structure-template-alist '("ag" . "src conf :tangle ~/.gnupg/gpg-agent.conf")))
267 A well balanced completion framework.
268 #+begin_src emacs-lisp
270 :bind (("C-s" . swiper)
271 :map ivy-minibuffer-map
272 ("TAB" . ivy-alt-done)
273 :map ivy-switch-buffer-map
274 ("M-d" . ivy-switch-buffer-kill))
278 #+begin_src emacs-lisp
279 (use-package ivy-rich
281 :config (ivy-rich-mode))
285 #+begin_src emacs-lisp
287 :bind (("C-M-j" . 'counsel-switch-buffer)
288 :map minibuffer-local-map
289 ("C-r" . 'counsel-minibuffer-history))
290 :custom (counsel-linux-app-format-function #'counsel-linux-app-format-function-name-only)
291 :config (counsel-mode))
293 ** Remember frequent commands
294 #+begin_src emacs-lisp
295 (use-package ivy-prescient
297 :custom (ivy-prescient-enable-filtering nil)
299 (prescient-persist-mode)
300 (ivy-prescient-mode))
303 Better search utility.
304 #+begin_src emacs-lisp
309 Use elfeed for reading RSS. I have another file with all the feeds in it that I'd rather keep private.
310 #+begin_src emacs-lisp
312 :bind (("C-c e" . elfeed))
314 (load "~/.emacs.d/feeds.el")
315 (add-hook 'elfeed-new-entry-hook
316 (elfeed-make-tagger :feed-url "youtube\\.com"
318 :bind (:map elfeed-search-mode-map ("C-c C-o" . 'elfeed-show-visit)))
320 (use-package elfeed-goodies
322 :config (elfeed-goodies/setup))
325 Use mu4e for reading emails.
327 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.
329 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.
330 #+begin_src emacs-lisp
331 (use-package smtpmail
332 :straight (:type built-in))
334 :load-path "/usr/share/emacs/site-lisp/mu4e"
335 :straight (:build nil)
336 :bind (("C-c m" . mu4e))
338 (setq user-full-name "Armaan Bhojwani"
339 smtpmail-local-domain "armaanb.net"
340 smtpmail-stream-type 'ssl
341 smtpmail-smtp-service '465
342 mu4e-change-filenames-when-moving t
343 mu4e-get-mail-command "offlineimap -q"
344 message-citation-line-format "On %a %d %b %Y at %R, %f wrote:\n"
345 message-citation-line-function 'message-insert-formatted-citation-line
346 mu4e-completing-read-function 'ivy-completing-read
347 mu4e-confirm-quit nil
349 mail-user-agent 'mu4e-user-agent
350 mail-context-policy 'pick-first
352 `( ,(make-mu4e-context
354 :enter-func (lambda () (mu4e-message "Entering school context"))
355 :leave-func (lambda () (mu4e-message "Leaving school context"))
356 :match-func (lambda (msg)
358 (string-match-p "^/school" (mu4e-message-field msg :maildir))))
359 :vars '((user-mail-address . "abhojwani22@nobles.edu")
360 (mu4e-sent-folder . "/school/Sent")
361 (mu4e-drafts-folder . "/school/Drafts")
362 (mu4e-trash-folder . "/school/Trash")
363 (mu4e-refile-folder . "/school/Archive")
364 (message-cite-reply-position . above)
365 (user-mail-address . "abhojwani22@nobles.edu")
366 (smtpmail-smtp-user . "abhojwani22@nobles.edu")
367 (smtpmail-smtp-server . "smtp.gmail.com")))
370 :enter-func (lambda () (mu4e-message "Entering personal context"))
371 :leave-func (lambda () (mu4e-message "Leaving personal context"))
372 :match-func (lambda (msg)
374 (string-match-p "^/personal" (mu4e-message-field msg :maildir))))
375 :vars '((mu4e-sent-folder . "/personal/Sent")
376 (mu4e-drafts-folder . "/personal/Drafts")
377 (mu4e-trash-folder . "/personal/Trash")
378 (mu4e-refile-folder . "/personal/Archive")
379 (user-mail-address . "me@armaanb.net")
380 (message-cite-reply-position . below)
381 (smtpmail-smtp-user . "me@armaanb.net")
382 (smtpmail-smtp-server . "smtp.mailbox.org")))))
383 (add-to-list 'mu4e-bookmarks
384 '(:name "Unified inbox"
385 :query "maildir:\"/personal/INBOX\" or maildir:\"/school/INBOX\""
387 :hook ((mu4e-compose-mode . flyspell-mode)
388 (mu4e-compose-mode . auto-fill-mode)
389 (mu4e-view-mode-hook . turn-on-visual-line-mode)
390 (message-send-hook . (lambda () (unless (yes-or-no-p "Ya sure 'bout that?")
391 (signal 'quit nil))))))
393 Discourage Gnus from displaying HTML emails
394 #+begin_src emacs-lisp
395 (with-eval-after-load "mm-decode"
396 (add-to-list 'mm-discouraged-alternatives "text/html")
397 (add-to-list 'mm-discouraged-alternatives "text/richtext"))
400 Set EWW as default browser except for multimedia which should open in MPV.
401 #+begin_src emacs-lisp
402 (defun browse-url-mpv (url &optional new-window)
405 (start-process "mpv" "*mpv*" "mpv" url))
407 (setq browse-url-handlers
409 (("youtu\\.?be" . browse-url-mpv)
410 ("peertube.*" . browse-url-mpv)
411 ("vid.*" . browse-url-mpv)
412 ("vid.*" . browse-url-mpv)
413 ("*.mp4" . browse-url-mpv)
414 ("*.mp3" . browse-url-mpv)
415 ("*.ogg" . browse-url-mpv)
416 ("." . eww-browse-url)
420 Some EWW enhancements.
421 *** Give buffer a useful name
422 #+begin_src emacs-lisp
423 ;; From https://protesilaos.com/dotemacs/
424 (defun prot-eww--rename-buffer ()
425 "Rename EWW buffer using page title or URL.
426 To be used by `eww-after-render-hook'."
427 (let ((name (if (eq "" (plist-get eww-data :title))
428 (plist-get eww-data :url)
429 (plist-get eww-data :title))))
430 (rename-buffer (format "*%s # eww*" name) t)))
433 :straight (:type built-in)
434 :bind (("C-c w" . eww))
435 :hook (eww-after-render-hook prot-eww--rename-buffer))
438 #+begin_src emacs-lisp
439 (global-set-key (kbd "C-c w") 'eww)
442 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.
443 #+begin_src emacs-lisp
444 (defun fetch-password (&rest params)
445 (require 'auth-source)
446 (let ((match (car (apply 'auth-source-search params))))
448 (let ((secret (plist-get match :secret)))
449 (if (functionp secret)
452 (error "Password not found for %S" params))))
457 (enable-circe-color-nicks)
458 (setq circe-network-defaults '(("libera"
459 :host "irc.armaanb.net"
464 :pass (lambda (null) (fetch-password
466 :machine "irc.armaanb.net"
469 :host "irc.armaanb.net"
474 :pass (lambda (null) (fetch-password
476 :machine "irc.armaanb.net"
479 :host "irc.armaanb.net"
484 :pass (lambda (null) (fetch-password
486 :machine "irc.armaanb.net"
491 :custom (circe-default-part-message "goodbye!")
492 :bind (:map circe-mode-map ("C-c C-r" . circe-reconnect-all)))
495 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.
496 #+begin_src emacs-lisp
497 (defun sync-calendar ()
498 "Sync calendars with vdirsyncer"
500 (shell-command "vdirsyncer -vcritical sync"))
503 :bind (:map cfw:calendar-mode-map ("C-S-u" . sync-calendar)))
504 (use-package calfw-ical)
505 (use-package calfw-org)
507 (defun acheam-calendar ()
510 (cfw:open-calendar-buffer
511 :contents-sources (list
512 (cfw:org-create-source "Green")
513 (cfw:ical-create-source
515 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
517 (cfw:ical-create-source
519 "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
521 (cfw:ical-create-source
523 "~/.local/share/vdirsyncer/school/abhojwani22@nobles.edu.ics"
527 (global-set-key (kbd "C-c c") 'acheam-calendar)
531 #+begin_src emacs-lisp
533 :hook (python-mode . blacken-mode)
534 :custom (blacken-line-length 79))
537 ** Strip trailing whitespace
538 #+begin_src emacs-lisp
539 (use-package ws-butler
540 :config (ws-butler-global-mode))
543 Automatic linting. I need to look into configuring this more.
544 #+begin_src emacs-lisp
545 (use-package flycheck
546 :config (global-flycheck-mode))
548 ** Project management
549 I never use this, but apparently its very powerful. Another item on my todo list.
550 #+begin_src emacs-lisp
551 (use-package projectile
552 :config (projectile-mode)
553 :custom ((projectile-completion-system 'ivy))
555 ("C-c p" . projectile-command-map)
557 (when (file-directory-p "~/Code")
558 (setq projectile-project-search-path '("~/Code")))
559 (setq projectile-switch-project-action #'projectile-dired))
561 (use-package counsel-projectile
563 :config (counsel-projectile-mode))
566 The best file manager!
567 #+begin_src emacs-lisp
569 :straight (:type built-in)
570 :commands (dired dired-jump)
571 :custom ((dired-listing-switches "-agho --group-directories-first"))
572 :config (evil-collection-define-key 'normal 'dired-mode-map
573 "h" 'dired-single-up-directory
574 "l" 'dired-single-buffer))
576 (use-package dired-single
577 :commands (dired dired-jump))
579 (use-package dired-open
580 :commands (dired dired-jump)
581 :custom (dired-open-extensions '(("png" . "feh")
584 (use-package dired-hide-dotfiles
585 :hook (dired-mode . dired-hide-dotfiles-mode)
587 (evil-collection-define-key 'normal 'dired-mode-map
588 "H" 'dired-hide-dotfiles-mode))
592 **** TODO Write a command that commits hunk, skipping staging step.
593 A very good Git interface.
594 #+begin_src emacs-lisp
598 #+begin_src emacs-lisp
600 (use-package git-email
601 :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
602 :config (git-email-piem-mode))
604 * General text editing
606 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.
607 #+begin_src emacs-lisp
608 (use-package aggressive-indent
609 :config (global-aggressive-indent-mode))
612 Spell check in text mode, and in prog-mode comments.
613 #+begin_src emacs-lisp
614 (dolist (hook '(text-mode-hook))
615 (add-hook hook (lambda () (flyspell-mode))))
616 (dolist (hook '(change-log-mode-hook log-edit-mode-hook))
617 (add-hook hook (lambda () (flyspell-mode -1))))
618 (add-hook 'prog-mode (lambda () (flyspell-prog mode)))
619 (setq ispell-silently-savep t)
622 #+begin_src emacs-lisp
623 (setq-default tab-width 2)
626 Opens file where you left it.
627 #+begin_src emacs-lisp
631 Distraction free writing a la junegunn/goyo.
632 #+begin_src emacs-lisp
633 (use-package olivetti
634 :bind ("C-c o" . olivetti-mode))
637 Abbreviate things! I just use this for things like my email address and copyright notice.
638 #+begin_src emacs-lisp
639 (setq abbrev-file-name "~/.emacs.d/abbrevs.el")
640 (setq save-abbrevs 'silent)
641 (setq-default abbrev-mode t)
644 #+begin_src emacs-lisp
645 (setq tramp-default-method "ssh")
647 ** Follow version controlled symlinks
648 #+begin_src emacs-lisp
649 (setq vc-follow-symlinks t)
652 #+begin_src emacs-lisp
653 (defun doas-edit (&optional arg)
654 "Edit currently visited file as root.
656 With a prefix ARG prompt for a file to visit.
657 Will also prompt for a file to visit if current
658 buffer is not visiting a file.
660 Modified from Emacs Redux."
662 (if (or arg (not buffer-file-name))
663 (find-file (concat "/doas:root@localhost:"
664 (ido-read-file-name "Find file(as root): ")))
665 (find-alternate-file (concat "/doas:root@localhost:" buffer-file-name))))
667 (global-set-key (kbd "C-x C-r") #'doas-edit)
670 #+begin_src emacs-lisp
671 (use-package markdown-mode)
675 #+begin_src emacs-lisp
676 (use-package ace-window
677 :bind ("M-o" . ace-window))
679 ** Kill current buffer
680 Makes "C-x k" binding faster.
681 #+begin_src emacs-lisp
682 (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
686 #+begin_src emacs-lisp
687 (use-package scad-mode)
689 ** Control backup and lock files
690 Stop backup files from spewing everywhere.
691 #+begin_src emacs-lisp
692 (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
693 create-lockfiles nil)
695 ** Make yes/no easier
696 #+begin_src emacs-lisp
697 (defalias 'yes-or-no-p 'y-or-n-p)
699 ** Move customize file
700 No more clogging up init.el.
701 #+begin_src emacs-lisp
702 (setq custom-file "~/.emacs.d/custom.el")
706 #+begin_src emacs-lisp
708 :commands (helpful-callable helpful-variable helpful-command helpful-key)
710 (counsel-describe-function-function #'helpful-callable)
711 (counsel-describe-variable-function #'helpful-variable)
713 ([remap describe-function] . counsel-describe-function)
714 ([remap describe-command] . helpful-command)
715 ([remap describe-variable] . counsel-describe-variable)
716 ([remap describe-key] . helpful-key))
719 #+begin_src emacs-lisp
720 (use-package epa-file
721 :straight (:type built-in)
723 (epa-file-select-keys nil)
724 (epa-file-encrypt-to '("me@armaanb.net"))
725 (password-cache-expiry (* 60 15)))
727 (use-package pinentry
728 :config (pinentry-start))
731 #+begin_src emacs-lisp
733 :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
734 :custom (0x0-default-service 'envs))
736 ** Automatically clean buffers
737 Automatically close unused buffers (except those of Circe) at midnight.
738 #+begin_src emacs-lisp
740 (add-to-list 'clean-buffer-list-kill-never-regexps (lambda (buffer-name)
741 (with-current-buffer buffer-name
742 (derived-mode-p 'lui-mode))))
746 Spectrwm is a really awesome window manager! Would highly recommend.
748 #+begin_src conf :tangle ~/.spectrwm.conf
752 autorun = ws[1]:/home/armaa/Code/scripts/autostart
755 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.
756 #+begin_src conf :tangle ~/.spectrwm.conf
758 bar_font = xos4 JetBrains Mono:pixelsize=14:antialias=true # any installed font
761 I'm not a huge fan of how spectrwm handles keybindings, probably my biggest gripe with it.
763 #+begin_src conf :tangle ~/.spectrwm.conf
764 program[term] = st -e tmux
765 program[screenshot_all] = flameshot gui
766 program[notif] = /home/armaa/Code/scripts/setter status
767 program[pass] = /home/armaa/Code/scripts/passmenu
770 bind[pass] = MOD+Shift+p
773 #+begin_src conf :tangle ~/.spectrwm.conf
774 program[paup] = /home/armaa/Code/scripts/setter audio +5
775 program[padown] = /home/armaa/Code/scripts/setter audio -5
776 program[pamute] = /home/armaa/Code/scripts/setter audio
777 program[brigup] = /home/armaa/Code/scripts/setter brightness +10%
778 program[brigdown] = /home/armaa/Code/scripts/setter brightness 10%-
779 program[next] = playerctl next
780 program[prev] = playerctl previous
781 program[pause] = playerctl play-pause
783 bind[padown] = XF86AudioLowerVolume
784 bind[paup] = XF86AudioRaiseVolume
785 bind[pamute] = XF86AudioMute
786 bind[brigdown] = XF86MonBrightnessDown
787 bind[brigup] = XF86MonBrightnessUp
788 bind[pause] = XF86AudioPlay
789 bind[next] = XF86AudioNext
790 bind[prev] = XF86AudioPrev
793 #+begin_src conf :tangle ~/.spectrwm.conf
794 program[h] = xdotool keyup h key --clearmodifiers Left
795 program[j] = xdotool keyup j key --clearmodifiers Down
796 program[k] = xdotool keyup k key --clearmodifiers Up
797 program[l] = xdotool keyup l key --clearmodifiers Right
799 bind[h] = MOD + Control + h
800 bind[j] = MOD + Control + j
801 bind[k] = MOD + Control + k
802 bind[l] = MOD + Control + l
805 #+begin_src conf :tangle ~/.spectrwm.conf
806 program[email] = emacsclient -ce "(mu4e)"
807 program[irc] = emacsclient -ce '(switch-to-buffer "irc.armaanb.net:6698")'
808 program[rss] = emacsclient -ce '(elfeed)'
809 program[calendar] = emacsclient -ce '(acheam-calendar)'
810 program[calc] = emacsclient -ce '(progn (calc) (windmove-up) (delete-window))'
811 program[firefox] = firefox
812 program[emacs] = emacsclient -c
814 bind[email] = MOD+Control+1
815 bind[irc] = MOD+Control+2
816 bind[rss] = MOD+Control+3
817 bind[calendar] = MOD+Control+4
818 bind[calc] = MOD+Control+5
819 bind[firefox] = MOD+Control+0
820 bind[emacs] = MOD+Control+Return
823 Float some specific programs by default.
824 #+begin_src conf :tangle ~/.spectrwm.conf
825 quirk[Castle Menu] = FLOAT
830 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.
831 #+begin_src conf :tangle ~/.config/ash/ashrc
835 **** Update all packages
836 #+begin_src shell :tangle ~/.config/ash/ashrc
837 color=$(tput setaf 5)
841 doas echo "${color}== upgrading with yay ==${reset}"
844 echo "${color}== checking for pacnew files ==${reset}"
847 echo "${color}== upgrading flatpaks ==${reset}"
850 echo "${color}== updating nvim plugins ==${reset}"
851 nvim +PlugUpdate +PlugUpgrade +qall
852 echo "Updated nvim plugins"
854 echo "${color}You are entirely up to date!${reset}"
857 **** Clean all packages
858 #+begin_src shell :tangle ~/.config/ash/ashrc
860 doas echo "${color}== cleaning pacman orphans ==${reset}"
861 (pacman -Qtdq | doas pacman -Rns - 2> /dev/null) || echo "No orphans"
863 echo "${color}== cleaning flatpaks ==${reset}"
864 flatpak remove --unused
866 echo "${color}== cleaning nvim plugins ==${reset}"
867 nvim +PlugClean +qall
868 echo "Cleaned nvim plugins"
870 echo "${color}All orphans cleaned!${reset}"
873 **** Interact with 0x0
874 #+begin_src shell :tangle ~/.config/ash/ashrc
875 zxz="https://envs.sh"
876 ufile() { curl -F"file=@$1" "$zxz" ; }
877 upb() { curl -F"file=@-;" "$zxz" ; }
878 uurl() { curl -F"url=$1" "$zxz" ; }
879 ushort() { curl -F"shorten=$1" "$zxz" ; }
880 uclip() { xclip -out | curl -F"file=@-;" "$zxz" ; }
883 #+begin_src shell :tangle ~/.config/ash/ashrc
885 user=$(echo "$1" | cut -f 1 -d '@')
886 host=$(echo "$1" | cut -f 2 -d '@')
887 echo $user | nc "$host" 79
890 **** Upload to ftp.armaanb.net
891 #+begin_src shell :tangle ~/.config/ash/ashrc
893 rsync "$1" "root@armaanb.net:/var/ftp/pub/${2}"
894 echo "https://ftp.armaanb.net/pub/"$(basename "$1") | tee /dev/tty | xclip -sel c
898 #+begin_src shell :tangle ~/.config/ash/ashrc
899 export EDITOR="emacsclient -c"
900 export VISUAL="$EDITOR"
901 export TERM=xterm-256color # for compatability
903 export GPG_TTY="$(tty)"
904 export MANPAGER='nvim +Man!'
907 export GTK_USE_PORTAL=1
909 export PATH="/home/armaa/.local/bin:$PATH" # prioritize .local/bin
910 export PATH="/home/armaa/Code/scripts:$PATH" # prioritize my scripts
911 export PATH="/home/armaa/Code/scripts/bin:$PATH" # prioritize my bins
912 export PATH="$PATH:/home/armaa/.cargo/bin"
913 export PATH="$PATH:/home/armaa/.local/share/gem/ruby/2.7.0/bin"
914 export PATH="$PATH:/usr/sbin"
915 export PATH="$PATH:/opt/FreeTube/freetube"
917 export LC_ALL="en_US.UTF-8"
918 export LC_CTYPE="en_US.UTF-8"
919 export LANGUAGE="en_US.UTF-8"
921 export KISS_PATH="/home/armaa/Virtual/kiss/home/armaa/kiss-repo"
922 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/core"
923 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/extra"
924 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/xorg"
925 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-main/testing"
926 export KISS_PATH="$KISS_PATH:/home/armaa/Clone/repo-community/community"
927 export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
931 #+begin_src shell :tangle ~/.config/ash/ashrc
932 alias bhoji-drop='ssh -p 23 root@armaanb.net'
933 alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
934 alias union='ssh 192.168.1.18'
935 alias mine='ssh -p 23 root@pickupserver.cc'
936 alias tcf='ssh root@204.48.23.68'
937 alias ngmun='ssh root@157.245.89.25'
938 alias prox='ssh root@192.168.1.224'
939 alias ncq='ssh root@143.198.123.17'
940 alias envs='ssh acheam@envs.net'
943 #+begin_src shell :tangle ~/.config/ash/ashrc
944 alias ls='ls -lh --group-directories-first'
946 alias df='df -h / /boot'
953 alias grep='grep -in --color=auto'
954 alias mkdir='mkdir -pv'
955 alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar'
956 emacs() { $EDITOR "$@" & }
959 **** System management
960 #+begin_src shell :tangle ~/.config/ash/ashrc
961 alias crontab='crontab-argh'
963 alias pasu='git -C ~/.password-store push'
964 alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
968 #+begin_src shell :tangle ~/.config/ash/ashrc
969 alias ping='ping -c 10'
970 alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
971 alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
972 alias plan='T=$(mktemp) && \
973 rsync root@armaanb.net:/etc/finger/plan.txt "$T" && \
975 head -n -2 $T > $TT && \
977 echo "\nLast updated: $(date -R)" >> "$TT" && \
978 fold -sw 72 "$TT" > "$T"| \
979 rsync "$T" root@armaanb.net:/etc/finger/plan.txt'
981 **** Virtual machines, chroots
982 #+begin_src shell :tangle ~/.config/ash/ashrc
983 alias ckiss="doas chrooter ~/Virtual/kiss"
984 alias cdebian="doas chrooter ~/Virtual/debian bash"
985 alias cwindows='devour qemu-system-x86_64 \
990 -device VGA,vgamem_mb=64 \
994 -net user,smb=/home/armaa/Public \
995 -drive format=qcow2,file=/home/armaa/Virtual/windows.qcow2'
998 #+begin_src shell :tangle ~/.config/ash/ashrc
999 alias pip="python -m pip"
1000 alias black="black -l 79"
1003 #+begin_src shell :tangle ~/.config/ash/ashrc
1004 alias words='gen-shell -c "words"'
1005 alias words-e='gen-shell -c "words ~E"'
1008 #+begin_src shell :tangle ~/.config/ash/ashrc
1009 alias zathura='devour zathura'
1010 alias cad='devour openscad'
1011 alias feh='devour feh'
1014 #+begin_src shell :tangle ~/.config/ash/ashrc
1016 alias api='yay -Syu'
1017 alias apii='doas pacman -S'
1018 alias app='yay -Rns'
1019 alias azf='pacman -Q | fzf'
1020 alias favorites='pacman -Qe | cut -d " " -f 1 > ~/Documents/favorites'
1023 #+begin_src shell :tangle ~/.config/ash/ashrc
1024 alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
1025 iflag=fullblock status=progress'
1026 alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
1027 iflag=fullblock status=progress'
1028 alias ytmusic="youtube-dl -x --add-metadata --audio-format aac \
1029 --restrict-filenames -o '%(title)s.%(ext)s'"
1030 alias cal="cal -3 --color=auto"
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-option -g history-limit 50000
1275 set-window-option -g mode-keys vi
1276 bind-key -T copy-mode-vi 'v' send -X begin-selection
1277 bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1281 #+begin_src conf :tangle ~/.gnupg/gpg.conf
1282 default-key 3C9ED82FFE788E4A
1286 #+begin_src conf :tangle ~/.gnupg/gpg-agent.conf
1287 pinentry-program /sbin/pinentry-gnome3
1289 default-cache-ttl 600
1290 allow-emacs-pinentry