]> git.armaanb.net Git - config.org.git/blob - config.org
ash: don't use nvim as manpager
[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-operandi 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 ** Man
659 #+begin_src emacs-lisp
660   (use-package man
661     :bind ("C-c t" . man))
662 #+end_src
663 ** Git
664 *** Magit
665 A very good Git interface.
666 #+begin_src emacs-lisp
667   (use-package magit)
668 #+end_src
669 *** Email
670 #+begin_src emacs-lisp
671   (use-package piem)
672   ;; (use-package git-email
673   ;;   :straight (git-email :repo "https://git.sr.ht/~yoctocell/git-email")
674   ;;   :config (git-email-piem-mode))
675 #+end_src
676 ** C
677 Modified from https://eklitzke.org/smarter-emacs-clang-format.
678
679 Style is basically ddevault's style guide but with 4 spaces instead of 8 char tabs.
680 #+begin_src emacs-lisp
681   (use-package clang-format
682     :custom (clang-format-style "{
683         BasedOnStyle: llvm,
684         AlwaysBreakAfterReturnType: AllDefinitions,
685         IndentWidth: 4,
686         }"))
687
688   (defun clang-format-buffer-smart ()
689     "Reformat buffer if .clang-format exists in the projectile root."
690     (when (file-exists-p (expand-file-name ".clang-format" (projectile-project-root)))
691       (when (if (eq major-mode 'c-mode))
692         (message "Formatting with clang-format...")
693         (clang-format-buffer))))
694
695   (add-hook 'before-save-hook 'clang-format-buffer-smart nil)
696 #+end_src
697 * General text editing
698 ** Spell checking
699 Spell check in text mode, and in prog-mode comments.
700 #+begin_src emacs-lisp
701   (dolist (hook '(text-mode-hook
702                   markdown-mode-hook
703                   scdoc-mode-hook))
704     (add-hook hook (lambda () (flyspell-mode))))
705   (dolist (hook '(change-log-mode-hook log-edit-mode-hook))
706     (add-hook hook (lambda () (flyspell-mode -1))))
707   (add-hook 'prog-mode (lambda () (flyspell-prog mode)))
708   (setq ispell-silently-savep t)
709 #+end_src
710 ** Sane tab width
711 #+begin_src emacs-lisp
712   (setq-default tab-width 2)
713 #+end_src
714 ** Save place
715 Opens file where you left it.
716 #+begin_src emacs-lisp
717   (save-place-mode)
718 #+end_src
719 ** Writing mode
720 Distraction free writing a la junegunn/goyo.
721 #+begin_src emacs-lisp
722   (use-package olivetti
723     :bind ("C-c o" . olivetti-mode))
724 #+end_src
725 ** Abbreviations
726 Abbreviate things! I just use this for things like my email address and copyright notice.
727 #+begin_src emacs-lisp
728   (setq abbrev-file-name "~/.emacs.d/abbrevs.el")
729   (setq save-abbrevs 'silent)
730   (setq-default abbrev-mode t)
731 #+end_src
732 ** TRAMP
733 #+begin_src emacs-lisp
734   (setq tramp-default-method "ssh")
735 #+end_src
736 ** Follow version controlled symlinks
737 #+begin_src emacs-lisp
738   (setq vc-follow-symlinks t)
739 #+end_src
740 ** Open file as root
741 #+begin_src emacs-lisp
742   (defun doas-edit (&optional arg)
743     "Edit currently visited file as root.
744
745     With a prefix ARG prompt for a file to visit.  Will also prompt
746     for a file to visit if current buffer is not visiting a file.
747
748     Modified from Emacs Redux."
749     (interactive "P")
750     (if (or arg (not buffer-file-name))
751         (find-file (concat "/doas:root@localhost:"
752                            (ido-read-file-name "Find file(as root): ")))
753       (find-alternate-file (concat "/doas:root@localhost:" buffer-file-name))))
754
755     (global-set-key (kbd "C-x C-r") #'doas-edit)
756 #+end_src
757 ** Markdown mode
758 #+begin_src emacs-lisp
759   (use-package markdown-mode)
760 #+end_src
761 ** scdoc mode
762 Get it for yourself at https://git.armaanb.net/scdoc
763 #+begin_src emacs-lisp
764   (add-to-list 'load-path "~/src/scdoc-mode")
765   (autoload 'scdoc-mode "scdoc-mode" "Major mode for editing scdoc files" t)
766   (add-to-list 'auto-mode-alist '("\\.scd\\'" . scdoc-mode))
767 #+end_src
768 * Keybindings
769 ** Switch windows
770 #+begin_src emacs-lisp
771   (use-package ace-window
772     :bind ("M-o" . ace-window))
773 #+end_src
774 ** Kill current buffer
775 Makes "C-x k" binding faster.
776 #+begin_src emacs-lisp
777   (substitute-key-definition 'kill-buffer 'kill-buffer-and-window global-map)
778 #+end_src
779 * Other settings
780 ** OpenSCAD syntax
781 #+begin_src emacs-lisp
782   (use-package scad-mode)
783 #+end_src
784 ** Control backup and lock files
785 Stop backup files from spewing everywhere.
786 #+begin_src emacs-lisp
787   (setq backup-directory-alist `(("." . "~/.emacs.d/backups"))
788         create-lockfiles nil)
789 #+end_src
790 ** Make yes/no easier
791 #+begin_src emacs-lisp
792   (defalias 'yes-or-no-p 'y-or-n-p)
793 #+end_src
794 ** Move customize file
795 No more clogging up init.el.
796 #+begin_src emacs-lisp
797   (setq custom-file "~/.emacs.d/custom.el")
798   (load custom-file)
799 #+end_src
800 ** Better help
801 #+begin_src emacs-lisp
802   (use-package helpful
803     :commands (helpful-callable helpful-variable helpful-command helpful-key)
804     :custom
805     (counsel-describe-function-function #'helpful-callable)
806     (counsel-describe-variable-function #'helpful-variable)
807     :bind
808     ([remap describe-function] . counsel-describe-function)
809     ([remap describe-command] . helpful-command)
810     ([remap describe-variable] . counsel-describe-variable)
811     ([remap describe-key] . helpful-key))
812 #+end_src
813 ** GPG
814 #+begin_src emacs-lisp
815   (use-package epa-file
816     :straight (:type built-in)
817     :custom
818     (epa-file-select-keys nil)
819     (epa-file-encrypt-to '("me@armaanb.net"))
820     (password-cache-expiry (* 60 15)))
821
822   (use-package pinentry
823     :config (pinentry-start))
824 #+end_src
825 ** Pastebin
826 #+begin_src emacs-lisp
827   (use-package 0x0
828     :straight (0x0 :type git :repo "https://git.sr.ht/~zge/nullpointer-emacs")
829     :custom (0x0-default-service 'envs))
830 #+end_src
831 *** TODO Replace this with uploading to my own server
832 Similar to the ufile alias in my ashrc
833 ** Automatically clean buffers
834 Automatically close unused buffers (except those of Circe) at midnight.
835 #+begin_src emacs-lisp
836   (midnight-mode)
837   (add-to-list 'clean-buffer-list-kill-never-regexps
838                (lambda (buffer-name)
839                  (with-current-buffer buffer-name
840                    (derived-mode-p 'lui-mode))))
841 #+end_src
842 * Tangles
843 ** Ash
844 *** Options
845 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.
846 #+begin_src conf :tangle ~/.config/ash/ashrc
847   set -o vi
848 #+end_src
849 *** Functions
850 **** Finger
851 #+begin_src shell :tangle ~/.config/ash/ashrc
852   finger() {
853       user=$(echo "$1" | cut -f 1 -d '@')
854       host=$(echo "$1" | cut -f 2 -d '@')
855       echo $user | nc "$host" 79
856   }
857 #+end_src
858 **** Upload to ftp.armaanb.net
859 #+begin_src shell :tangle ~/.config/ash/ashrc
860   _uprint() {
861       echo "https://l.armaanb.net/$(basename "$1")" | tee /dev/tty | xclip -sel c
862   }
863
864   _uup() {
865       rsync "$1" "armaa@armaanb.net:/srv/ftp/pub/$2" --chmod 644 --progress
866   }
867
868   ufile() {
869       _uup "$1" "$2"
870       _uprint "$1"
871   }
872
873   uclip() {
874       tmp=$(mktemp)
875       xclip -o -sel c >> "$tmp"
876       basetmp=$(echo "$tmp" | tail -c +5)
877       _uup "$tmp" "$basetmp"
878       _uprint "$basetmp"
879       rm -f "$tmp"
880   }
881 #+end_src
882 *** Exports
883 **** Default programs
884 #+begin_src shell :tangle ~/.config/ash/ashrc
885   export EDITOR="emacsclient -c"
886   export VISUAL="$EDITOR"
887   export TERM=xterm-256color # for compatability
888   #+end_src
889 **** General program configs
890 #+begin_src shell :tangle ~/.config/ash/ashrc
891   export GPG_TTY="$(tty)"
892   export GNUPGHOME="~/.local/share/gnupg"
893
894   export GOPATH="~/.local/share/go"
895
896   export PAGER='less'
897   export GTK_USE_PORTAL=1
898   export CDPATH=:~
899   export LESSHISTFILE=/dev/null
900
901   export PASH_KEYID=me@armaanb.net
902   export PASH_LENGTH=20
903 #+end_src
904 **** PATH
905 #+begin_src shell :tangle ~/.config/ash/ashrc
906   export PATH="/home/armaa/src/bin:$PATH"
907   export PATH="/home/armaa/src/bin/bin:$PATH"
908   export PATH="/home/armaa/.local/bin:$PATH"
909   export PATH="/usr/lib/ccache/bin:$PATH"
910 #+end_src
911 **** Locale
912 #+begin_src shell :tangle ~/.config/ash/ashrc
913   export LC_ALL="en_US.UTF-8"
914   export LC_CTYPE="en_US.UTF-8"
915   export LANGUAGE="en_US.UTF-8"
916   export TZ="America/New_York"
917 #+end_src
918 **** KISS
919 #+begin_src shell :tangle ~/.config/ash/ashrc
920   export KISS_PATH=""
921   export KISS_PATH="$KISS_PATH:$HOME/repos/personal"
922   export KISS_PATH="$KISS_PATH:$HOME/repos/bin/bin"
923   export KISS_PATH="$KISS_PATH:$HOME/repos/main/core"
924   export KISS_PATH="$KISS_PATH:$HOME/repos/main/extra"
925   export KISS_PATH="$KISS_PATH:$HOME/repos/main/xorg"
926   export KISS_PATH="$KISS_PATH:$HOME/repos/community/community"
927   export KISS_PATH="$KISS_PATH:$HOME/repos/mid/ports"
928
929   export KISS_COMPRESS=xz
930 #+end_src
931 **** Compilation flags
932 #+begin_src shell :tangle ~/.config/ash/ashrc
933   export CFLAGS="-O3 -pipe -march=native"
934   export CXXFLAGS="$CFLAGS"
935   export MAKEFLAGS="-j$(nproc)"
936   export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
937 #+end_src
938 **** XDG desktop dirs
939 #+begin_src shell :tangle ~/.config/ash/ashrc
940   export XDG_DESKTOP_DIR="/dev/null"
941   export XDG_DOCUMENTS_DIR="$HOME/documents"
942   export XDG_DOWNLOAD_DIR="$HOME/downloads"
943   export XDG_MUSIC_DIR="$HOME/music"
944   export XDG_PICTURES_DIR="$HOME/pictures"
945   export XDG_VIDEOS_DIR="$HOME/videos"
946 #+end_src
947 *** Aliases
948 **** SSH
949 #+begin_src shell :tangle ~/.config/ash/ashrc
950   alias poki='ssh armaanb.net'
951   alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
952   alias union='ssh 192.168.1.18'
953   alias mine='ssh -p 23 root@pickupserver.cc'
954   alias tcf='ssh root@204.48.23.68'
955   alias ngmun='ssh root@157.245.89.25'
956   alias prox='ssh root@192.168.1.224'
957   alias ncq='ssh root@143.198.123.17'
958   alias envs='ssh acheam@envs.net'
959 #+end_src
960 **** File management
961 #+begin_src shell :tangle ~/.config/ash/ashrc
962   alias ls='LC_COLLATE=C ls -lh --group-directories-first'
963   alias la='ls -A'
964   alias df='df -h / /boot'
965   alias du='du -h'
966   alias free='free -m'
967   alias cp='cp -riv'
968   alias rm='rm -iv'
969   alias mv='mv -iv'
970   alias ln='ln -v'
971   alias grep='grep -in'
972   alias mkdir='mkdir -pv'
973   alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar && rm lxc*'
974   emacs() { $EDITOR "$@" & }
975   alias vim="emacs"
976 #+end_src
977 **** System management
978 #+begin_src shell :tangle ~/.config/ash/ashrc
979   alias crontab='crontab-argh'
980   alias sudo='doas'
981   alias pasu='git -C ~/.password-store push'
982   alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
983     yadm push'
984 #+end_src
985 **** Networking
986 #+begin_src shell :tangle ~/.config/ash/ashrc
987   alias ping='ping -c 10'
988   alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
989   alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
990   alias plan='T=$(mktemp) && \
991           rsync armaanb.net:/home/armaa/plan.txt "$T" && \
992           TT=$(mktemp) && \
993           head -n -2 $T > $TT && \
994           /bin/nvim $TT && \
995           echo >> "$TT" && \
996           echo "Last updated: $(date -R)" >> "$TT" && \
997           fold -sw 72 "$TT" > "$T"| \
998           rsync "$T" armaanb.net:/home/armaa/plan.txt && \
999           rm -f "$T"'
1000 #+end_src
1001 **** Virtual machines, chroots
1002 #+begin_src shell :tangle ~/.config/ash/ashrc
1003   alias cwindows='qemu-system-x86_64 \
1004     -smp 3 \
1005     -cpu host \
1006     -enable-kvm \
1007     -m 3G \
1008     -device VGA,vgamem_mb=64 \
1009     -device intel-hda \
1010     -device hda-duplex \
1011     -net nic \
1012     -net user,smb=/home/armaa/public \
1013     -drive format=qcow2,file=/home/armaa/virtual/windows.qcow2'
1014 #+end_src
1015 **** Latin
1016 #+begin_src shell :tangle ~/.config/ash/ashrc
1017   alias words='gen-shell -c "words"'
1018   alias words-e='gen-shell -c "words ~E"'
1019 #+end_src
1020 **** Other
1021 #+begin_src shell :tangle ~/.config/ash/ashrc
1022   alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
1023     iflag=fullblock'
1024   alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
1025     iflag=fullblock'
1026   alias ytmusic="youtube-dl -x --add-metadata  --audio-format aac \
1027     --restrict-filenames -o '%(title)s.%(ext)s'"
1028   alias bc='bc -l'
1029 #+end_src
1030 ** MPV
1031 Make MPV play a little bit smoother.
1032 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
1033   ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
1034   hwdec=auto-copy
1035 #+end_src
1036 ** Git
1037 *** User
1038 #+begin_src conf :tangle ~/.config/git/config
1039   [user]
1040   name = Armaan Bhojwani
1041   email = me@armaanb.net
1042   signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
1043 #+end_src
1044 *** Init
1045 #+begin_src conf :tangle ~/.config/git/config
1046   [init]
1047   defaultBranch = main
1048 #+end_src
1049 *** GPG
1050 #+begin_src conf :tangle ~/.config/git/config
1051   [gpg]
1052   program = gpg
1053 #+end_src
1054 *** Sendemail
1055 #+begin_src conf :tangle ~/.config/git/config
1056   [sendemail]
1057   smtpserver = smtp.mailbox.org
1058   smtpuser = me@armaanb.net
1059   smtpencryption = ssl
1060   smtpserverport = 465
1061   confirm = auto
1062 #+end_src
1063 *** Submodule
1064 #+begin_src conf :tangle ~/.config/git/config
1065   [submodule]
1066   recurse = true
1067 #+end_src
1068 *** Aliases
1069 #+begin_src conf :tangle ~/.config/git/config
1070   [alias]
1071   stat = diff --stat
1072   sclone = clone --depth 1
1073   sclean = clean -dfX
1074   a = add
1075   aa = add .
1076   c = commit
1077   quickfix = commit . --amend --no-edit
1078   p = push
1079   subup = submodule update --remote
1080   loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1081   pushnc = push -o skip-ci
1082 #+end_src
1083 *** Commit
1084 #+begin_src conf :tangle ~/.config/git/config
1085   [commit]
1086   gpgsign = true
1087   verbose = true
1088 #+end_src
1089 *** Tag
1090 #+begin_src conf :tangle ~/.config/git/config
1091   [tag]
1092   gpgsign = true
1093 #+end_src
1094 ** Zathura
1095 The best document reader!
1096 *** Options
1097 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1098   map <C-i> recolor
1099   map <A-b> toggle_statusbar
1100   set selection-clipboard clipboard
1101   set scroll-step 200
1102
1103   set window-title-basename "true"
1104   set selection-clipboard "clipboard"
1105 #+end_src
1106 *** Colors
1107 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1108   set default-bg         "#000000"
1109   set default-fg         "#ffffff"
1110   set render-loading     true
1111   set render-loading-bg  "#000000"
1112   set render-loading-fg  "#ffffff"
1113
1114   set recolor-lightcolor "#000000" # bg
1115   set recolor-darkcolor  "#ffffff" # fg
1116   set recolor            "true"
1117 #+end_src
1118 ** Tmux
1119 I use tmux in order to keep my st build light. Still learning how it works.
1120 #+begin_src conf :tangle ~/.config/tmux/tmux.conf
1121   set -g status off
1122   set -g mouse on
1123
1124   set-option -g history-limit 50000
1125
1126   set -g set-titles on
1127   set -g set-titles-string "#W"
1128
1129   set-window-option -g mode-keys vi
1130   bind-key -T copy-mode-vi 'v' send -X begin-selection
1131   bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1132 #+end_src
1133 ** GPG
1134 *** Config
1135 #+begin_src conf :tangle ~/.local/share/gnupg/gpg.conf
1136   default-key 3C9ED82FFE788E4A
1137   use-agent
1138 #+end_src
1139 *** Agent
1140 #+begin_src conf :tangle ~/.local/share/gnupg/gpg-agent.conf
1141   pinentry-program /sbin/pinentry
1142
1143   max-cache-ttl 6000
1144   default-cache-ttl 6000
1145   allow-emacs-pinentry
1146 #+end_src
1147 ** Xmodmap
1148 #+begin_src conf :tangle (progn (if (string= (system-name) "frost.armaanb.net") "~/.config/xmodmap" "no"))
1149   ! Unmap left super
1150   clear mod4
1151
1152   ! Turn right alt into super
1153   remove mod1 = Alt_R
1154   add mod4 = Alt_R
1155
1156   ! Swap caps and control
1157   remove Lock = Caps_Lock
1158   remove Control = Control_L
1159   remove Lock = Control_L
1160   remove Control = Caps_Lock
1161   keysym Control_L = Caps_Lock
1162   keysym Caps_Lock = Control_L
1163   add Lock = Caps_Lock
1164   add Control = Control_L
1165 #+end_src
1166 ** sx
1167 #+begin_src shell :tangle ~/.config/sx/sxrc :tangle-mode (identity #o755)
1168   exec dwm
1169 #+end_src