]> git.armaanb.net Git - config.org.git/blob - config.org
cff07c80e85e97828398a96cfb70b800033e552f
[config.org.git] / config.org
1 #+TITLE: System Configuration
2 #+DESCRIPTION: Personal system configuration in org-mode format.
3 #+AUTHOR: Armaan Bhojwani
4 #+EMAIL: me@armaanb.net
5
6 * Welcome
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!
8 ** Compatability
9 I am currently using Emacs 27.2 on Linux, 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.
10 ** Choices
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.
12
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.
14
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.
16 ** License
17 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.
18 * Package management
19 ** Bootstrap straight.el
20 straight.el is really nice for managing package, and it integrates nicely with use-package. It uses the bootstrapping system defined here for installation.
21 #+begin_src emacs-lisp
22   (defvar native-comp-deferred-compilation-deny-list ())
23   (defvar bootstrap-version)
24   (let ((bootstrap-file
25          (expand-file-name "straight/repos/straight.el/bootstrap.el" user-emacs-directory))
26         (bootstrap-version 5))
27     (unless (file-exists-p bootstrap-file)
28       (with-current-buffer
29           (url-retrieve-synchronously
30            "https://raw.githubusercontent.com/raxod502/straight.el/develop/install.el"
31            'silent 'inhibit-cookies)
32         (goto-char (point-max))
33         (eval-print-last-sexp)))
34     (load bootstrap-file nil 'nomessage))
35 #+end_src
36 ** Replace package.el with straight
37 #+begin_src emacs-lisp
38   (straight-use-package 'use-package)
39   (setq straight-use-package-by-default t)
40 #+end_src
41 * Visual options
42 ** Theme
43 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.
44 #+begin_src emacs-lisp
45   (use-package modus-themes
46     :custom
47     (modus-themes-slanted-constructs t)
48     (modus-themes-bold-constructs t)
49     (modus-themes-mode-line '3d)
50     (modus-themes-scale-headings t)
51     (modus-themes-diffs 'desaturated)
52     :config (load-theme 'modus-vivendi t))
53 #+end_src
54 ** Typography
55 *** Font
56 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]].
57 #+begin_src emacs-lisp
58   (add-to-list 'default-frame-alist '(font . "JetBrainsMonoNF-11"))
59 #+end_src
60 *** Ligatures
61 #+begin_src emacs-lisp
62   (use-package ligature
63     :straight (ligature :type git :host github :repo "mickeynp/ligature.el")
64     :config
65     (ligature-set-ligatures
66      '(prog-mode text-mode)
67      '("-|" "-~" "---" "-<<" "-<" "--" "->" "->>" "-->" "/=" "/=="
68        "/>" "//" "/*" "*>" "*/" "<-" "<<-" "<=>" "<=" "<|" "<||"
69        "<|||" "<|>" "<:" "<>" "<-<" "<<<" "<==" "<<=" "<=<" "<==>"
70        "<-|" "<<" "<~>" "<=|" "<~~" "<~" "<$>" "<$" "<+>" "<+" "</>"
71        "</" "<*" "<*>" "<->" "<!--" ":>" ":<" ":::" "::" ":?" ":?>"
72        ":=" "::=" "=>>" "==>" "=/=" "=!=" "=>" "===" "=:=" "==" "!=="
73        "!!" "!=" ">]" ">:" ">>-" ">>=" ">=>" ">>>" ">-" ">=" "&&&"
74        "&&" "|||>" "||>" "|>" "|]" "|}" "|=>" "|->" "|=" "||-" "|-"
75        "||=" "||" ".." ".?" ".=" ".-" "..<" "..." "+++" "+>" "++"
76        "[||]" "[<" "[|" "{|" "?." "?=" "?:" "##" "###" "####" "#["
77        "#{" "#=" "#!" "#:" "#_(" "#_" "#?" "#(" ";;" "_|_" "__" "~~"
78        "~~>" "~>" "~-" "~@" "$>" "^=" "]#"))
79     ;; (global-ligature-mode t))
80     )
81 #+end_src
82 ** Line numbers
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
88                          pdf-view-mode-hook
89                          shell-mode-hook
90                          org-mode-hook
91                          circe-mode-hook
92                          eshell-mode-hook))
93     (add-hook no-line-num (lambda () (display-line-numbers-mode 0))))
94 #+end_src
95 ** Highlight matching parenthesis
96 #+begin_src emacs-lisp
97   (use-package paren
98     :config (show-paren-mode)
99     :custom (show-paren-style 'parenthesis))
100 #+end_src
101 ** Modeline
102 *** Show current function
103 #+begin_src emacs-lisp
104   (which-function-mode)
105 #+end_src
106 *** Make position in file more descriptive
107 Show current column and file size.
108 #+begin_src emacs-lisp
109   (column-number-mode)
110   (size-indication-mode)
111 #+end_src
112 *** Hide minor modes
113 #+begin_src emacs-lisp
114   (use-package minions
115     :config (minions-mode))
116 #+end_src
117 ** Whitespace mode
118 Highlight whitespace and other bad text practices.
119 #+begin_src emacs-lisp
120   (use-package whitespace
121     :custom (whitespace-style '(face lines-tail)))
122   (dolist (hook '(prog-mode-hook))
123     (add-hook hook (lambda () (whitespace-mode 1))))
124 #+end_src
125 ** Highlight todo items in comments
126 #+begin_src emacs-lisp
127   (use-package hl-todo
128     :straight (hl-todo :type git :host github :repo "tarsius/hl-todo")
129     :config (global-hl-todo-mode 1))
130 #+end_src
131 ** Blink cursor
132 #+begin_src emacs-lisp
133   (blink-cursor-mode)
134 #+end_src
135 ** Visual line mode
136 Soft wrap words and do operations by visual lines in some modes.
137 #+begin_src emacs-lisp
138   (dolist (hook '(text-mode-hook
139                   org-mode-hook
140                   markdown-mode-hook
141                   mu4e-view-mode-hook))
142     (add-hook hook (lambda () (visual-line-mode 1))))
143 #+end_src
144 ** Auto fill mode
145 #+begin_src emacs-lisp
146   (dolist (hook '(scdoc-mode-hook
147                   mu4e-compose-mode-hook))
148     (add-hook hook (lambda () (auto-fill-mode 1))))
149 #+end_src
150 ** Display number of matches in search
151 #+begin_src emacs-lisp
152   (use-package anzu
153     :after (evil)
154     :config (global-anzu-mode)
155     :bind
156     ([remap isearch-forward] . isearch-forward-regexp)
157     ([remap isearch-backward] . isearch-backward-regexp)
158     ([remap query-replace] . anzu-query-replace)
159     ([remap query-replace] . anzu-query-replace)
160     ([remap query-replace-regexp] . anzu-query-replace-regexp))
161 #+end_src
162 *** TODO This config doesn't work right
163 ** Visual bell
164 Invert modeline color instead of audible bell or the standard visual bell.
165 #+begin_src emacs-lisp
166   (setq visible-bell nil
167         ring-bell-function
168         (lambda () (invert-face 'mode-line)
169           (run-with-timer 0.1 nil #'invert-face 'mode-line)))
170 #+end_src
171 ** GUI
172 #+begin_src emacs-lisp
173   (scroll-bar-mode -1)
174   (tool-bar-mode -1)
175   (menu-bar-mode -1)
176   (setq-default frame-title-format '("%b [%m]"))
177 #+end_src
178 ** auth-source
179 #+begin_src emacs-lisp
180   (setq auth-sources '("~/.emacs.d/authinfo.gpg"))
181 #+end_src
182 * Evil mode
183 ** General
184 #+begin_src emacs-lisp
185   (use-package evil
186     :custom (select-enable-clipboard nil)
187     :init (setq evil-want-keybinding nil
188                 evil-want-minibuffer t
189                 evil-want-C-d-scroll t
190                 evil-want-C-u-scroll t)
191     :config
192     (evil-mode)
193     (fset 'evil-visual-update-x-selection 'ignore) ;; Keep clipboard and register seperate
194     ;; Use visual line motions even outside of visual-line-mode buffers
195     (evil-global-set-key 'motion "j" 'evil-next-visual-line)
196     (evil-global-set-key 'motion "k" 'evil-previous-visual-line)
197     :bind
198     ("<escape>" . keyboard-escape-quit)
199     ("C-M-u" . universal-argument))
200 #+end_src
201 ** Evil collection
202 Evil bindings for tons of packages.
203 #+begin_src emacs-lisp
204   (use-package evil-collection
205     :after evil
206     :init (evil-collection-init)
207     :custom (evil-collection-setup-minibuffer t))
208 #+end_src
209 ** Surround
210 tpope prevails!
211 #+begin_src emacs-lisp
212   (use-package evil-surround
213     :config (global-evil-surround-mode))
214 #+end_src
215 ** Nerd commenter
216 Makes commenting super easy
217 #+begin_src emacs-lisp
218   (use-package evil-nerd-commenter
219     :bind (:map evil-normal-state-map
220                 ("gc" . evilnc-comment-or-uncomment-lines))
221     :custom (evilnc-invert-comment-line-by-line nil))
222 #+end_src
223 ** Undo redo
224 Fix the oopsies!
225 #+begin_src emacs-lisp
226   (use-package undo-fu
227     :config (evil-set-undo-system 'undo-fu))
228
229   (use-package undo-fu-session
230     :config (global-undo-fu-session-mode))
231 #+end_src
232 ** Number incrementing
233 Add back C-a/C-x bindings.
234 #+begin_src emacs-lisp
235   (use-package evil-numbers
236     :straight (evil-numbers :type git :host github :repo "juliapath/evil-numbers")
237     :bind (:map evil-normal-state-map
238                 ("C-M-a" . evil-numbers/inc-at-pt)
239                 ("C-M-x" . evil-numbers/dec-at-pt)))
240 #+end_src
241 ** Evil org
242 #+begin_src emacs-lisp
243   (use-package evil-org
244     :after org
245     :hook (org-mode . evil-org-mode)
246     :config
247     (evil-org-set-key-theme '(textobjects insert navigation shift todo)))
248
249   (use-package evil-org-agenda
250     :straight (:type built-in)
251     :after evil-org
252     :config (evil-org-agenda-set-keys))
253 #+end_src
254 * Org mode
255 ** General
256 #+begin_src emacs-lisp
257   (use-package org
258     :straight (:type built-in)
259     :commands (org-capture org-agenda)
260     :custom
261     (org-ellipsis " ▾")
262     (org-agenda-start-with-log-mode t)
263     (org-agenda-files (quote ("~/org/tasks.org")))
264     (org-log-done 'time)
265     (org-log-into-drawer t)
266     (org-src-tab-acts-natively t)
267     (org-src-fontify-natively t)
268     (org-startup-indented t)
269     (org-hide-emphasis-markers t)
270     (org-fontify-whole-block-delimiter-line nil)
271     (org-archive-default-command 'org-archive-to-archive-sibling)
272     :bind
273     ("C-c a" . org-agenda)
274     (:map evil-normal-state-map ("ga" . org-archive-subtree-default)))
275 #+end_src
276 ** Tempo
277 Define templates for lots of common structure elements. Mostly just used within this file.
278 #+begin_src emacs-lisp
279   (use-package org-tempo
280     :after org
281     :straight (:type built-in)
282     :config
283     (dolist (addition '(
284                         ("ash" . "src shell :tangle ~/.config/ash/ashrc")
285                         ("el" . "src emacs-lisp")
286                         ("git" . "src conf :tangle ~/.config/git/config")
287                         ("mb" . "src conf :tangle ~/.config/mbsync/mbsyncrc")
288                         ("tm" . "src conf :tangle ~/.config/tmux/f")
289                         ("za" . "src conf :tangle ~/.config/zathura/zathurarc")
290                         ))
291       (add-to-list 'org-structure-template-alist addition)))
292 #+end_src
293 * Autocompletion
294 ** Ivy
295 A well balanced completion framework.
296 #+begin_src emacs-lisp
297   (use-package ivy
298     :bind (:map ivy-minibuffer-map
299            ("TAB" . ivy-alt-done))
300            (:map ivy-switch-buffer-map
301            ("M-d" . ivy-switch-buffer-kill))
302     :config (ivy-mode))
303 #+end_src
304 ** Ivy-rich
305 #+begin_src emacs-lisp
306   (use-package ivy-rich
307     :after (ivy counsel)
308     :config (ivy-rich-mode))
309 #+end_src
310 ** Counsel
311 Ivy everywhere.
312 #+begin_src emacs-lisp
313   (use-package counsel
314     :bind ("C-M-j" . 'counsel-switch-buffer)
315     :config (counsel-mode))
316 #+end_src
317 ** Remember frequent commands
318 #+begin_src emacs-lisp
319   (use-package ivy-prescient
320     :after counsel
321     :config
322     (prescient-persist-mode)
323     (ivy-prescient-mode))
324 #+end_src
325 * Emacs OS
326 ** RSS
327 Use elfeed for reading RSS. I have another file with all the feeds in it that I'd rather keep private.
328 #+begin_src emacs-lisp
329   (use-package elfeed
330     :bind (("C-c e" . elfeed))
331     :config (load "~/.emacs.d/feeds.el")
332     :custom (elfeed-db-directory "~/.emacs.d/elfeed")
333     :bind (:map elfeed-search-mode-map ("C-c C-o" . 'elfeed-show-visit)))
334 #+end_src
335 ** Email
336 Use mu4e and mbsync for reading emails.
337
338 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.
339 *** mbsync
340 **** General
341 #+begin_src conf :tangle ~/.config/mbsync/mbsyncrc
342   Create Near
343   Expunge Both
344   SyncState *
345 #+end_src
346 **** Personal
347 #+begin_src conf :tangle ~/.config/mbsync/mbsyncrc
348   IMAPStore personal-remote
349   Host imap.mailbox.org
350   User me@armaanb.net
351   PassCmd "pash show login.mailbox.org/me@armaanb.net | head -n 1"
352
353   MaildirStore personal-local
354   Path ~/mail/personal/
355   Inbox ~/mail/personal/Inbox
356   Subfolders Verbatim
357
358   Channel personal-channel
359   Far :personal-remote:
360   Near :personal-local:
361   Patterns "INBOX*" "Drafts" "Archive" "Sent" "Trash"
362
363   Group personal
364   Channel personal-channel
365 #+end_src
366 **** School
367 #+begin_src conf :tangle ~/.config/mbsync/mbsyncrc
368   IMAPStore school-remote
369   SSLType IMAPS
370   Host imap.gmail.com
371   User abhojwani22@nobles.edu
372   PassCmd "pash show gmail-otp/abhojwani22@nobles.edu | head -n 1"
373
374   MaildirStore school-local
375   Path ~/mail/school/
376   Inbox ~/mail/school/Inbox
377   Subfolders Verbatim
378
379   Channel school-channel
380   Far :school-remote:
381   Near :school-local:
382   Patterns * ![Gmail]*
383
384   Group school
385   Channel school-channel
386 #+end_src
387 *** mu4e
388 **** Setup
389 #+begin_src emacs-lisp
390   (use-package smtpmail
391     :straight (:type built-in))
392   (use-package mu4e
393     :load-path "/usr/share/emacs/site-lisp/mu4e"
394     :straight (:build nil)
395     :bind (("C-c m" . mu4e))
396     :config
397     (setq user-full-name "Armaan Bhojwani"
398           smtpmail-local-domain "armaanb.net"
399           smtpmail-stream-type 'ssl
400           smtpmail-smtp-service '465
401           mu4e-change-filenames-when-moving t
402           mu4e-get-mail-command "mbsync -a -c ~/.config/mbsync/mbsyncrc"
403           message-citation-line-format "On %a %d %b %Y at %R, %f wrote:\n"
404           message-citation-line-function 'message-insert-formatted-citation-line
405           mu4e-completing-read-function 'ivy-completing-read
406           mu4e-confirm-quit nil
407           mu4e-view-use-gnus t
408           mail-user-agent 'mu4e-user-agent
409           mu4e-context-policy 'pick-first
410           mu4e-contexts
411           `( ,(make-mu4e-context
412                :name "school"
413                :enter-func (lambda () (mu4e-message "Entering school context"))
414                :leave-func (lambda () (mu4e-message "Leaving school context"))
415                :match-func (lambda (msg)
416                              (when msg
417                                (string-match-p "^/school" (mu4e-message-field msg :maildir))))
418                :vars '((user-mail-address . "abhojwani22@nobles.edu")
419                        (mu4e-sent-folder . "/school/Sent")
420                        (mu4e-drafts-folder . "/school/Drafts")
421                        (mu4e-trash-folder . "/school/Trash")
422                        (mu4e-refile-folder . "/school/Archive")
423                        (message-cite-reply-position . above)
424                        (user-mail-address . "abhojwani22@nobles.edu")
425                        (smtpmail-smtp-user . "abhojwani22@nobles.edu")
426                        (smtpmail-smtp-server . "smtp.gmail.com")))
427              ,(make-mu4e-context
428                :name "personal"
429                :enter-func (lambda () (mu4e-message "Entering personal context"))
430                :leave-func (lambda () (mu4e-message "Leaving personal context"))
431                :match-func (lambda (msg)
432                              (when msg
433                                (string-match-p "^/personal" (mu4e-message-field msg :maildir))))
434                :vars '((mu4e-sent-folder . "/personal/Sent")
435                        (mu4e-drafts-folder . "/personal/Drafts")
436                        (mu4e-trash-folder . "/personal/Trash")
437                        (mu4e-refile-folder . "/personal/Archive")
438                        (user-mail-address . "me@armaanb.net")
439                        (message-cite-reply-position . below)
440                        (smtpmail-smtp-user . "me@armaanb.net")
441                        (smtpmail-smtp-server . "smtp.mailbox.org")))))
442     (add-to-list 'mu4e-bookmarks
443                  '(:name "Unified inbox"
444                          :query "maildir:\"/personal/Inbox\" or maildir:\"/school/Inbox\""
445                          :key ?b))
446     :hook ((mu4e-compose-mode . flyspell-mode)
447            (message-send-hook . (lambda () (unless (yes-or-no-p "Ya sure 'bout that?")
448                                              (signal 'quit nil))))))
449 #+end_src
450 **** Discourage Gnus from displaying HTML emails
451 #+begin_src emacs-lisp
452   (with-eval-after-load "mm-decode"
453     (add-to-list 'mm-discouraged-alternatives "text/html")
454     (add-to-list 'mm-discouraged-alternatives "text/richtext"))
455 #+end_src
456 ** Default browser
457 Set EWW as default browser except for multimedia which should open in MPV.
458 #+begin_src emacs-lisp
459   (defun browse-url-mpv (url &optional new-window)
460     "Ask MPV to load URL."
461     (interactive)
462     (start-process "mpv" "*mpv*" "mpv" url))
463
464   (setq browse-url-handlers
465         (quote
466          (("youtu\\.?be" . browse-url-mpv)
467           ("peertube.*" . browse-url-mpv)
468           ("vid.*" . browse-url-mpv)
469           ("vid.*" . browse-url-mpv)
470           ("*.mp4" . browse-url-mpv)
471           ("*.mp3" . browse-url-mpv)
472           ("*.ogg" . browse-url-mpv)
473           ("." . eww-browse-url)
474           )))
475 #+end_src
476 ** EWW
477 Some EWW enhancements.
478 *** Give buffer a useful name
479 #+begin_src emacs-lisp
480   ;; From https://protesilaos.com/dotemacs/
481   (defun prot-eww--rename-buffer ()
482     "Rename EWW buffer using page title or URL.
483         To be used by `eww-after-render-hook'."
484     (let ((name (if (eq "" (plist-get eww-data :title))
485                     (plist-get eww-data :url)
486                   (plist-get eww-data :title))))
487       (rename-buffer (format "*%s # eww*" name) t)))
488
489   (use-package eww
490     :straight (:type built-in)
491     :bind (("C-c w" . eww))
492     :hook (eww-after-render-hook prot-eww--rename-buffer))
493 #+end_src
494 *** Keybinding
495 #+begin_src emacs-lisp
496   (global-set-key (kbd "C-c w") 'eww)
497 #+end_src
498 ** IRC
499 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.
500 #+begin_src emacs-lisp
501   (defun fetch-password (&rest params)
502     (require 'auth-source)
503     (let ((match (car (apply 'auth-source-search params))))
504       (if match
505           (let ((secret (plist-get match :secret)))
506             (if (functionp secret)
507                 (funcall secret)
508               secret))
509         (error "Password not found for %S" params))))
510
511   (use-package circe
512     :config
513     (enable-lui-track)
514     (enable-circe-color-nicks)
515     (setq circe-network-defaults '(("libera"
516                                     :host "irc.armaanb.net"
517                                     :nick "emacs"
518                                     :user "emacs"
519                                     :use-tls t
520                                     :port 6698
521                                     :pass (lambda (null) (fetch-password
522                                                           :login "emacs"
523                                                           :machine "irc.armaanb.net"
524                                                           :port 6698)))
525                                    ("oftc"
526                                     :host "irc.armaanb.net"
527                                     :nick "emacs"
528                                     :user "emacs"
529                                     :use-tls t
530                                     :port 6699
531                                     :pass (lambda (null) (fetch-password
532                                                           :login "emacs"
533                                                           :machine "irc.armaanb.net"
534                                                           :port 6699)))
535                                    ("tilde"
536                                     :host "irc.armaanb.net"
537                                     :nick "emacs"
538                                     :user "emacs"
539                                     :use-tls t
540                                     :port 6696
541                                     :pass (lambda (null) (fetch-password
542                                                           :login "emacs"
543                                                           :machine "irc.armaanb.net"
544                                                           :port 6696)))))
545     :custom (circe-default-part-message "goodbye!")
546     :bind (:map circe-mode-map ("C-c C-r" . circe-reconnect-all)))
547
548   (defun acheam-irc ()
549     "Open circe"
550     (interactive)
551     (if (get-buffer "irc.armaanb.net:6696")
552         (switch-to-buffer "irc.armaanb.net:6696")
553       (progn (switch-to-buffer "*scratch*")
554              (circe "libera")
555              (circe "oftc")
556              (circe "tilde"))))
557
558   (global-set-key (kbd "C-c i") 'acheam-irc)
559 #+end_src
560 ** Calendar
561 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.
562 #+begin_src emacs-lisp
563   (defun sync-calendar ()
564     "Sync calendars with vdirsyncer"
565     (interactive)
566     (async-shell-command "vdirsyncer sync"))
567
568   (use-package calfw
569     :bind (:map cfw:calendar-mode-map ("C-S-u" . sync-calendar)))
570   (use-package calfw-ical)
571   (use-package calfw-org)
572
573   (defun acheam-calendar ()
574     "Open calendars"
575     (interactive)
576     (cfw:open-calendar-buffer
577      :contents-sources (list
578                         (cfw:org-create-source "Green")
579                         (cfw:ical-create-source
580                          "Personal"
581                          "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
582                          "Gray")
583                         (cfw:ical-create-source
584                          "Personal"
585                          "~/.local/share/vdirsyncer/mailbox/Y2FsOi8vMC8zMQ.ics"
586                          "Red")
587                         (cfw:ical-create-source
588                          "School"
589                          "~/.local/share/vdirsyncer/school/abhojwani22@nobles.edu.ics"
590                          "Cyan"))
591      :view 'week))
592
593   (global-set-key (kbd "C-c c") 'acheam-calendar)
594 #+end_src
595 ** PDF reader
596 #+begin_src emacs-lisp
597   (use-package pdf-tools
598     :hook (pdf-view-mode . pdf-view-midnight-minor-mode))
599 #+end_src
600 * Emacs IDE
601 ** Python formatting
602 #+begin_src emacs-lisp
603   (use-package blacken
604     :hook (python-mode . blacken-mode)
605     :custom (blacken-line-length 79))
606
607 #+end_src
608 ** Strip trailing whitespace
609 #+begin_src emacs-lisp
610   (use-package ws-butler
611     :config (ws-butler-global-mode))
612 #+end_src
613 ** Flycheck
614 Automatic linting. I need to look into configuring this more.
615 #+begin_src emacs-lisp
616   (use-package flycheck
617     :config (global-flycheck-mode))
618 #+end_src
619 ** Project management
620 I never use this, but apparently its very powerful. Another item on my todo list.
621 #+begin_src emacs-lisp
622   (use-package projectile
623     :config (projectile-mode)
624     :custom ((projectile-completion-system 'ivy))
625     :bind-keymap ("C-c p" . projectile-command-map)
626     :init (setq projectile-switch-project-action #'projectile-dired))
627
628   (use-package counsel-projectile
629     :after projectile
630     :config (counsel-projectile-mode))
631 #+end_src
632 ** Dired
633 The best file manager!
634 #+begin_src emacs-lisp
635   (use-package dired
636     :straight (:type built-in)
637     :commands (dired dired-jump)
638     :custom (dired-listing-switches "-agh --group-directories-first")
639     :bind
640     ([remap dired-find-file] . dired-single-buffer)
641     ([remap dired-mouse-find-file-other-window] . dired-single-buffer-mouse)
642     ([remap dired-up-directory] . dired-single-up-directory)
643     ("C-x C-j" . dired-jump))
644
645   (use-package dired-single
646     :commands (dired dired-jump))
647
648   (use-package dired-open
649     :commands (dired dired-jump)
650     :custom (dired-open-extensions '(("png" . "feh")
651                                      ("mkv" . "mpv"))))
652
653   (use-package dired-hide-dotfiles
654     :hook (dired-mode . dired-hide-dotfiles-mode)
655     :config (evil-collection-define-key 'normal 'dired-mode-map
656       "H" 'dired-hide-dotfiles-mode))
657 #+end_src
658 ** Git
659 *** Magit
660 A very good Git interface.
661 #+begin_src emacs-lisp
662   (use-package magit)
663 #+end_src
664 *** Email
665 #+begin_src emacs-lisp
666   (use-package piem)
667   ;; (use-package git-email
668   ;;   :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
669   ;;   :config (git-email-piem-mode))
670 #+end_src
671 ** C
672 Modified from https://eklitzke.org/smarter-emacs-clang-format.
673
674 Style is basically ddevault's style guide but with 4 spaces instead of 8 char tabs.
675 #+begin_src emacs-lisp
676   (use-package clang-format
677     :custom (clang-format-style "{
678         BasedOnStyle: llvm,
679         AlwaysBreakAfterReturnType: AllDefinitions,
680         IndentWidth: 4,
681         }"))
682
683   (defun clang-format-buffer-smart ()
684     "Reformat buffer if .clang-format exists in the projectile root."
685     (when (file-exists-p (expand-file-name ".clang-format" (projectile-project-root)))
686       (when (if (eq major-mode 'c-mode))
687         (message "Formatting with clang-format...")
688         (clang-format-buffer))))
689
690   (add-hook 'before-save-hook 'clang-format-buffer-smart nil)
691 #+end_src
692 * General text editing
693 ** Spell checking
694 Spell check in text mode, and in prog-mode comments.
695 #+begin_src emacs-lisp
696   (dolist (hook '(text-mode-hook
697                   markdown-mode-hook
698                   scdoc-mode-hook))
699     (add-hook hook (lambda () (flyspell-mode))))
700   (dolist (hook '(change-log-mode-hook log-edit-mode-hook))
701     (add-hook hook (lambda () (flyspell-mode -1))))
702   (add-hook 'prog-mode (lambda () (flyspell-prog mode)))
703   (setq ispell-silently-savep t)
704 #+end_src
705 ** Sane tab width
706 #+begin_src emacs-lisp
707   (setq-default tab-width 2)
708 #+end_src
709 ** Save place
710 Opens file where you left it.
711 #+begin_src emacs-lisp
712   (save-place-mode)
713 #+end_src
714 ** Writing mode
715 Distraction free writing a la junegunn/goyo.
716 #+begin_src emacs-lisp
717   (use-package olivetti
718     :bind ("C-c o" . olivetti-mode))
719 #+end_src
720 ** Abbreviations
721 Abbreviate things! I just use this for things like my email address and copyright notice.
722 #+begin_src emacs-lisp
723   (setq abbrev-file-name "~/.emacs.d/abbrevs.el")
724   (setq save-abbrevs 'silent)
725   (setq-default abbrev-mode t)
726 #+end_src
727 ** TRAMP
728 #+begin_src emacs-lisp
729   (setq tramp-default-method "ssh")
730 #+end_src
731 ** Follow version controlled symlinks
732 #+begin_src emacs-lisp
733   (setq vc-follow-symlinks t)
734 #+end_src
735 ** Open file as root
736 #+begin_src emacs-lisp
737   (defun doas-edit (&optional arg)
738     "Edit currently visited file as root.
739
740     With a prefix ARG prompt for a file to visit.  Will also prompt
741     for a file to visit if current buffer is not visiting a file.
742
743     Modified from Emacs Redux."
744     (interactive "P")
745     (if (or arg (not buffer-file-name))
746         (find-file (concat "/doas:root@localhost:"
747                            (ido-read-file-name "Find file(as root): ")))
748       (find-alternate-file (concat "/doas:root@localhost:" buffer-file-name))))
749
750     (global-set-key (kbd "C-x C-r") #'doas-edit)
751 #+end_src
752 ** Markdown mode
753 #+begin_src emacs-lisp
754   (use-package markdown-mode)
755 #+end_src
756 ** scdoc mode
757 Get it for yourself at https://git.armaanb.net/scdoc
758 #+begin_src emacs-lisp
759   (add-to-list 'load-path "~/src/scdoc-mode")
760   (autoload 'scdoc-mode "scdoc-mode" "Major mode for editing scdoc files" t)
761   (add-to-list 'auto-mode-alist '("\\.scd\\'" . scdoc-mode))
762 #+end_src
763 * Keybindings
764 ** Switch windows
765 #+begin_src emacs-lisp
766   (use-package ace-window
767     :bind ("M-o" . ace-window))
768 #+end_src
769 ** Kill current buffer
770 Makes "C-x k" binding faster.
771 #+begin_src emacs-lisp
772   (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
773 #+end_src
774 * Other settings
775 ** OpenSCAD syntax
776 #+begin_src emacs-lisp
777   (use-package scad-mode)
778 #+end_src
779 ** Control backup and lock files
780 Stop backup files from spewing everywhere.
781 #+begin_src emacs-lisp
782   (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
783         create-lockfiles nil)
784 #+end_src
785 ** Make yes/no easier
786 #+begin_src emacs-lisp
787   (defalias 'yes-or-no-p 'y-or-n-p)
788 #+end_src
789 ** Move customize file
790 No more clogging up init.el.
791 #+begin_src emacs-lisp
792   (setq custom-file "~/.emacs.d/custom.el")
793   (load custom-file)
794 #+end_src
795 ** Better help
796 #+begin_src emacs-lisp
797   (use-package helpful
798     :commands (helpful-callable helpful-variable helpful-command helpful-key)
799     :custom
800     (counsel-describe-function-function #'helpful-callable)
801     (counsel-describe-variable-function #'helpful-variable)
802     :bind
803     ([remap describe-function] . counsel-describe-function)
804     ([remap describe-command] . helpful-command)
805     ([remap describe-variable] . counsel-describe-variable)
806     ([remap describe-key] . helpful-key))
807 #+end_src
808 ** GPG
809 #+begin_src emacs-lisp
810   (use-package epa-file
811     :straight (:type built-in)
812     :custom
813     (epa-file-select-keys nil)
814     (epa-file-encrypt-to '("me@armaanb.net"))
815     (password-cache-expiry (* 60 15)))
816
817   (use-package pinentry
818     :config (pinentry-start))
819 #+end_src
820 ** Pastebin
821 #+begin_src emacs-lisp
822   (use-package 0x0
823     :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
824     :custom (0x0-default-service 'envs))
825 #+end_src
826 *** TODO Replace this with uploading to my own server
827 Similar to the ufile alias in my ashrc
828 ** Automatically clean buffers
829 Automatically close unused buffers (except those of Circe) at midnight.
830 #+begin_src emacs-lisp
831   (midnight-mode)
832   (add-to-list 'clean-buffer-list-kill-never-regexps
833                (lambda (buffer-name)
834                  (with-current-buffer buffer-name
835                    (derived-mode-p 'lui-mode))))
836 #+end_src
837 * Tangles
838 ** Ash
839 *** Options
840 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.
841 #+begin_src conf :tangle ~/.config/ash/ashrc
842   set -o vi
843 #+end_src
844 *** Functions
845 **** Finger
846 #+begin_src shell :tangle ~/.config/ash/ashrc
847   finger() {
848       user=$(echo "$1" | cut -f 1 -d '@')
849       host=$(echo "$1" | cut -f 2 -d '@')
850       echo $user | nc "$host" 79
851   }
852 #+end_src
853 **** Upload to ftp.armaanb.net
854 #+begin_src shell :tangle ~/.config/ash/ashrc
855   _uprint() {
856       echo "https://l.armaanb.net/$(basename "$1")" | tee /dev/tty | xclip -sel c
857   }
858
859   _uup() {
860       rsync "$1" "armaa@armaanb.net:/srv/ftp/pub/$2" --chmod 644 --progress
861   }
862
863   ufile() {
864       _uup "$1" "$2"
865       _uprint "$1"
866   }
867
868   uclip() {
869       tmp=$(mktemp)
870       xclip -o -sel c >> "$tmp"
871       basetmp=$(echo "$tmp" | tail -c +5)
872       _uup "$tmp" "$basetmp"
873       _uprint "$basetmp"
874       rm -f "$tmp"
875   }
876 #+end_src
877 *** Exports
878 **** Default programs
879 #+begin_src shell :tangle ~/.config/ash/ashrc
880   export EDITOR="emacsclient -c"
881   export VISUAL="$EDITOR"
882   export TERM=xterm-256color # for compatability
883   #+end_src
884 **** General program configs
885 #+begin_src shell :tangle ~/.config/ash/ashrc
886   export GPG_TTY="$(tty)"
887   export GNUPGHOME="~/.local/share/gnupg"
888
889   export GOPATH="~/.local/share/go"
890
891   export MANPAGER='nvim +Man!'
892   export PAGER='less'
893
894   export GTK_USE_PORTAL=1
895   export CDPATH=:~
896   export LESSHISTFILE=/dev/null
897
898   export PASH_KEYID=me@armaanb.net
899   export PASH_LENGTH=20
900 #+end_src
901 **** PATH
902 #+begin_src shell :tangle ~/.config/ash/ashrc
903   export PATH="/home/armaa/src/bin:$PATH"
904   export PATH="/home/armaa/src/bin/bin:$PATH"
905   export PATH="/home/armaa/.local/bin:$PATH"
906   export PATH="/usr/lib/ccache/bin:$PATH"
907 #+end_src
908 **** Locale
909 #+begin_src shell :tangle ~/.config/ash/ashrc
910   export LC_ALL="en_US.UTF-8"
911   export LC_CTYPE="en_US.UTF-8"
912   export LANGUAGE="en_US.UTF-8"
913   export TZ="America/New_York"
914 #+end_src
915 **** KISS
916 #+begin_src shell :tangle ~/.config/ash/ashrc
917   export KISS_PATH=""
918   export KISS_PATH="$KISS_PATH:$HOME/repos/personal"
919   export KISS_PATH="$KISS_PATH:$HOME/repos/bin/bin"
920   export KISS_PATH="$KISS_PATH:$HOME/repos/main/core"
921   export KISS_PATH="$KISS_PATH:$HOME/repos/main/extra"
922   export KISS_PATH="$KISS_PATH:$HOME/repos/main/xorg"
923   export KISS_PATH="$KISS_PATH:$HOME/repos/community/community"
924   export KISS_PATH="$KISS_PATH:$HOME/repos/mid/ports"
925
926   export KISS_COMPRESS=xz
927 #+end_src
928 **** Compilation flags
929 #+begin_src shell :tangle ~/.config/ash/ashrc
930   export CFLAGS="-O3 -pipe -march=native"
931   export CXXFLAGS="$CFLAGS"
932   export MAKEFLAGS="-j$(nproc)"
933   export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
934 #+end_src
935 **** XDG desktop dirs
936 #+begin_src shell :tangle ~/.config/ash/ashrc
937   export XDG_DESKTOP_DIR="/dev/null"
938   export XDG_DOCUMENTS_DIR="$HOME/documents"
939   export XDG_DOWNLOAD_DIR="$HOME/downloads"
940   export XDG_MUSIC_DIR="$HOME/music"
941   export XDG_PICTURES_DIR="$HOME/pictures"
942   export XDG_VIDEOS_DIR="$HOME/videos"
943 #+end_src
944 *** Aliases
945 **** SSH
946 #+begin_src shell :tangle ~/.config/ash/ashrc
947   alias poki='ssh armaanb.net'
948   alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
949   alias union='ssh 192.168.1.18'
950   alias mine='ssh -p 23 root@pickupserver.cc'
951   alias tcf='ssh root@204.48.23.68'
952   alias ngmun='ssh root@157.245.89.25'
953   alias prox='ssh root@192.168.1.224'
954   alias ncq='ssh root@143.198.123.17'
955   alias envs='ssh acheam@envs.net'
956 #+end_src
957 **** File management
958 #+begin_src shell :tangle ~/.config/ash/ashrc
959   alias ls='LC_COLLATE=C ls -lh --group-directories-first'
960   alias la='ls -A'
961   alias df='df -h / /boot'
962   alias du='du -h'
963   alias free='free -m'
964   alias cp='cp -riv'
965   alias rm='rm -iv'
966   alias mv='mv -iv'
967   alias ln='ln -v'
968   alias grep='grep -in'
969   alias mkdir='mkdir -pv'
970   alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar && rm lxc*'
971   emacs() { $EDITOR "$@" & }
972   alias vim="emacs"
973 #+end_src
974 **** System management
975 #+begin_src shell :tangle ~/.config/ash/ashrc
976   alias crontab='crontab-argh'
977   alias sudo='doas'
978   alias pasu='git -C ~/.password-store push'
979   alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
980     yadm push'
981 #+end_src
982 **** Networking
983 #+begin_src shell :tangle ~/.config/ash/ashrc
984   alias ping='ping -c 10'
985   alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
986   alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
987   alias plan='T=$(mktemp) && \
988           rsync armaanb.net:/home/armaa/plan.txt "$T" && \
989           TT=$(mktemp) && \
990           head -n -2 $T > $TT && \
991           /bin/nvim $TT && \
992           echo >> "$TT" && \
993           echo "Last updated: $(date -R)" >> "$TT" && \
994           fold -sw 72 "$TT" > "$T"| \
995           rsync "$T" armaanb.net:/home/armaa/plan.txt && \
996           rm -f "$T"'
997 #+end_src
998 **** Virtual machines, chroots
999 #+begin_src shell :tangle ~/.config/ash/ashrc
1000   alias cwindows='qemu-system-x86_64 \
1001     -smp 3 \
1002     -cpu host \
1003     -enable-kvm \
1004     -m 3G \
1005     -device VGA,vgamem_mb=64 \
1006     -device intel-hda \
1007     -device hda-duplex \
1008     -net nic \
1009     -net user,smb=/home/armaa/public \
1010     -drive format=qcow2,file=/home/armaa/virtual/windows.qcow2'
1011 #+end_src
1012 **** Latin
1013 #+begin_src shell :tangle ~/.config/ash/ashrc
1014   alias words='gen-shell -c "words"'
1015   alias words-e='gen-shell -c "words ~E"'
1016 #+end_src
1017 **** Other
1018 #+begin_src shell :tangle ~/.config/ash/ashrc
1019   alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
1020     iflag=fullblock'
1021   alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
1022     iflag=fullblock'
1023   alias ytmusic="youtube-dl -x --add-metadata  --audio-format aac \
1024     --restrict-filenames -o '%(title)s.%(ext)s'"
1025   alias bc='bc -l'
1026 #+end_src
1027 ** MPV
1028 Make MPV play a little bit smoother.
1029 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
1030   ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
1031   hwdec=auto-copy
1032 #+end_src
1033 ** Git
1034 *** User
1035 #+begin_src conf :tangle ~/.config/git/config
1036   [user]
1037   name = Armaan Bhojwani
1038   email = me@armaanb.net
1039   signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
1040 #+end_src
1041 *** Init
1042 #+begin_src conf :tangle ~/.config/git/config
1043   [init]
1044   defaultBranch = main
1045 #+end_src
1046 *** GPG
1047 #+begin_src conf :tangle ~/.config/git/config
1048   [gpg]
1049   program = gpg
1050 #+end_src
1051 *** Sendemail
1052 #+begin_src conf :tangle ~/.config/git/config
1053   [sendemail]
1054   smtpserver = smtp.mailbox.org
1055   smtpuser = me@armaanb.net
1056   smtpencryption = ssl
1057   smtpserverport = 465
1058   confirm = auto
1059 #+end_src
1060 *** Submodule
1061 #+begin_src conf :tangle ~/.config/git/config
1062   [submodule]
1063   recurse = true
1064 #+end_src
1065 *** Aliases
1066 #+begin_src conf :tangle ~/.config/git/config
1067   [alias]
1068   stat = diff --stat
1069   sclone = clone --depth 1
1070   sclean = clean -dfX
1071   a = add
1072   aa = add .
1073   c = commit
1074   quickfix = commit . --amend --no-edit
1075   p = push
1076   subup = submodule update --remote
1077   loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1078   pushnc = push -o skip-ci
1079 #+end_src
1080 *** Commit
1081 #+begin_src conf :tangle ~/.config/git/config
1082   [commit]
1083   gpgsign = true
1084   verbose = true
1085 #+end_src
1086 *** Tag
1087 #+begin_src conf :tangle ~/.config/git/config
1088   [tag]
1089   gpgsign = true
1090 #+end_src
1091 ** Zathura
1092 The best document reader!
1093 *** Options
1094 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1095   map <C-i> recolor
1096   map <A-b> toggle_statusbar
1097   set selection-clipboard clipboard
1098   set scroll-step 200
1099
1100   set window-title-basename "true"
1101   set selection-clipboard "clipboard"
1102 #+end_src
1103 *** Colors
1104 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1105   set default-bg         "#000000"
1106   set default-fg         "#ffffff"
1107   set render-loading     true
1108   set render-loading-bg  "#000000"
1109   set render-loading-fg  "#ffffff"
1110
1111   set recolor-lightcolor "#000000" # bg
1112   set recolor-darkcolor  "#ffffff" # fg
1113   set recolor            "true"
1114 #+end_src
1115 ** Tmux
1116 I use tmux in order to keep my st build light. Still learning how it works.
1117 #+begin_src conf :tangle ~/.config/tmux/tmux.conf
1118   set -g status off
1119   set -g mouse on
1120
1121   set-option -g history-limit 50000
1122
1123   set -g set-titles on
1124   set -g set-titles-string "#W"
1125
1126   set-window-option -g mode-keys vi
1127   bind-key -T copy-mode-vi 'v' send -X begin-selection
1128   bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1129 #+end_src
1130 ** GPG
1131 *** Config
1132 #+begin_src conf :tangle ~/.local/share/gnupg/gpg.conf
1133   default-key 3C9ED82FFE788E4A
1134   use-agent
1135 #+end_src
1136 *** Agent
1137 #+begin_src conf :tangle ~/.local/share/gnupg/gpg-agent.conf
1138   pinentry-program /sbin/pinentry
1139
1140   max-cache-ttl 6000
1141   default-cache-ttl 6000
1142   allow-emacs-pinentry
1143 #+end_src
1144 ** Xmodmap
1145 #+begin_src conf :tangle (progn (if (string= (system-name) "frost.armaanb.net") "~/.config/xmodmap" "no"))
1146   ! Unmap left super
1147   clear mod4
1148
1149   ! Turn right alt into super
1150   remove mod1 = Alt_R
1151   add mod4 = Alt_R
1152
1153   ! Swap caps and control
1154   remove Lock = Caps_Lock
1155   remove Control = Control_L
1156   remove Lock = Control_L
1157   remove Control = Caps_Lock
1158   keysym Control_L = Caps_Lock
1159   keysym Caps_Lock = Control_L
1160   add Lock = Caps_Lock
1161   add Control = Control_L
1162 #+end_src
1163 ** sx
1164 #+begin_src shell :tangle ~/.config/sx/sxrc :tangle-mode (identity #o755)
1165   autostart &
1166   dwmblocks &
1167   exec dwm
1168 #+end_src