]> git.armaanb.net Git - config.org.git/blob - config.org
ash: put jupyter and ipython in XDG base dirs
[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
893   export GNUPGHOME="$HOME/.local/share/gnupg"
894   export GOPATH="$HOME/.local/share/go"
895   export JUPYTER_CONFIG_DIR="$HOME/.config/jupyter"
896   export IPYTHON_DIR="$HOME/.local/share/ipython"
897
898   export PAGER='less'
899   export GTK_USE_PORTAL=1
900   export CDPATH=:~
901   export LESSHISTFILE=/dev/null
902
903   export PASH_KEYID=me@armaanb.net
904   export PASH_LENGTH=20
905 #+end_src
906 **** PATH
907 #+begin_src shell :tangle ~/.config/ash/ashrc
908   export PATH="/home/armaa/src/bin:$PATH"
909   export PATH="/home/armaa/src/bin/bin:$PATH"
910   export PATH="/home/armaa/.local/bin:$PATH"
911   export PATH="/usr/lib/ccache/bin:$PATH"
912 #+end_src
913 **** Locale
914 #+begin_src shell :tangle ~/.config/ash/ashrc
915   export LC_ALL="en_US.UTF-8"
916   export LC_CTYPE="en_US.UTF-8"
917   export LANGUAGE="en_US.UTF-8"
918   export TZ="America/New_York"
919 #+end_src
920 **** KISS
921 #+begin_src shell :tangle ~/.config/ash/ashrc
922   export KISS_PATH=""
923   export KISS_PATH="$KISS_PATH:$HOME/repos/personal"
924   export KISS_PATH="$KISS_PATH:$HOME/repos/bin/bin"
925   export KISS_PATH="$KISS_PATH:$HOME/repos/main/core"
926   export KISS_PATH="$KISS_PATH:$HOME/repos/main/extra"
927   export KISS_PATH="$KISS_PATH:$HOME/repos/main/xorg"
928   export KISS_PATH="$KISS_PATH:$HOME/repos/community/community"
929   export KISS_PATH="$KISS_PATH:$HOME/repos/mid/ports"
930
931   export KISS_COMPRESS=xz
932 #+end_src
933 **** Compilation flags
934 #+begin_src shell :tangle ~/.config/ash/ashrc
935   export CC=clang
936   export CFLAGS="-O3 -pipe -march=native"
937   export CXX=clang++
938   export CXXFLAGS="$CFLAGS -stdlib=libc++"
939   export MAKEFLAGS="-j$(nproc)"
940   export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
941 #+end_src
942 **** XDG desktop dirs
943 #+begin_src shell :tangle ~/.config/ash/ashrc
944   export XDG_DESKTOP_DIR="/dev/null"
945   export XDG_DOCUMENTS_DIR="$HOME/documents"
946   export XDG_DOWNLOAD_DIR="$HOME/downloads"
947   export XDG_MUSIC_DIR="$HOME/music"
948   export XDG_PICTURES_DIR="$HOME/pictures"
949   export XDG_VIDEOS_DIR="$HOME/videos"
950 #+end_src
951 *** Aliases
952 **** SSH
953 #+begin_src shell :tangle ~/.config/ash/ashrc
954   alias poki='ssh armaanb.net'
955   alias irc='ssh root@armaanb.net -t abduco -A irc catgirl freenode'
956   alias union='ssh 192.168.1.18'
957   alias mine='ssh -p 23 root@pickupserver.cc'
958   alias tcf='ssh root@204.48.23.68'
959   alias ngmun='ssh root@157.245.89.25'
960   alias prox='ssh root@192.168.1.224'
961   alias ncq='ssh root@143.198.123.17'
962   alias envs='ssh acheam@envs.net'
963 #+end_src
964 **** File management
965 #+begin_src shell :tangle ~/.config/ash/ashrc
966   alias ls='LC_COLLATE=C ls -lh --group-directories-first'
967   alias la='ls -A'
968   alias df='df -h / /boot'
969   alias du='du -h'
970   alias free='free -m'
971   alias cp='cp -riv'
972   alias rm='rm -iv'
973   alias mv='mv -iv'
974   alias ln='ln -v'
975   alias grep='grep -in'
976   alias mkdir='mkdir -pv'
977   alias lanex='java -jar ~/.local/share/lxc/lanxchange.jar && rm lxc*'
978   emacs() { $EDITOR "$@" & }
979   alias vim="emacs"
980 #+end_src
981 **** System management
982 #+begin_src shell :tangle ~/.config/ash/ashrc
983   alias crontab='crontab-argh'
984   alias sudo='doas'
985   alias pasu='git -C ~/.password-store push'
986   alias yadu='yadm add -u && yadm commit -m "Updated `date -Iseconds`" && \
987     yadm push'
988 #+end_src
989 **** Networking
990 #+begin_src shell :tangle ~/.config/ash/ashrc
991   alias ping='ping -c 10'
992   alias gps='gpg --keyserver keyserver.ubuntu.com --search-keys'
993   alias gpp='gpg --keyserver keyserver.ubuntu.com --recv-key'
994   alias plan='T=$(mktemp) && \
995           rsync armaanb.net:/home/armaa/plan.txt "$T" && \
996           TT=$(mktemp) && \
997           head -n -2 $T > $TT && \
998           /bin/nvim $TT && \
999           echo >> "$TT" && \
1000           echo "Last updated: $(date -R)" >> "$TT" && \
1001           fold -sw 72 "$TT" > "$T"| \
1002           rsync "$T" armaanb.net:/home/armaa/plan.txt && \
1003           rm -f "$T"'
1004 #+end_src
1005 **** Virtual machines, chroots
1006 #+begin_src shell :tangle ~/.config/ash/ashrc
1007   alias cwindows='qemu-system-x86_64 \
1008     -smp 3 \
1009     -cpu host \
1010     -enable-kvm \
1011     -m 3G \
1012     -device VGA,vgamem_mb=64 \
1013     -device intel-hda \
1014     -device hda-duplex \
1015     -net nic \
1016     -net user,smb=/home/armaa/public \
1017     -drive format=qcow2,file=/home/armaa/virtual/windows.qcow2'
1018 #+end_src
1019 **** Latin
1020 #+begin_src shell :tangle ~/.config/ash/ashrc
1021   alias words='gen-shell -c "words"'
1022   alias words-e='gen-shell -c "words ~E"'
1023 #+end_src
1024 **** Other
1025 #+begin_src shell :tangle ~/.config/ash/ashrc
1026   alias bigrandomfile='dd if=/dev/urandom of=1GB-urandom bs=1M count=1024 \
1027     iflag=fullblock'
1028   alias bigboringfile='dd if=/dev/zero of=1GB-zero bs=1M count=1024 \
1029     iflag=fullblock'
1030   alias ytmusic="youtube-dl -x --add-metadata  --audio-format aac \
1031     --restrict-filenames -o '%(title)s.%(ext)s'"
1032   alias bc='bc -l'
1033 #+end_src
1034 ** MPV
1035 Make MPV play a little bit smoother.
1036 #+begin_src conf :tangle ~/.config/mpv/mpv.conf
1037   ytdl-format="bestvideo[height<=?1080]+bestaudio/best"
1038   hwdec=auto-copy
1039 #+end_src
1040 ** Git
1041 *** User
1042 #+begin_src conf :tangle ~/.config/git/config
1043   [user]
1044   name = Armaan Bhojwani
1045   email = me@armaanb.net
1046   signingkey = 0FEB9471E19C49C60CFBEB133C9ED82FFE788E4A
1047 #+end_src
1048 *** Init
1049 #+begin_src conf :tangle ~/.config/git/config
1050   [init]
1051   defaultBranch = main
1052 #+end_src
1053 *** GPG
1054 #+begin_src conf :tangle ~/.config/git/config
1055   [gpg]
1056   program = gpg
1057 #+end_src
1058 *** Sendemail
1059 #+begin_src conf :tangle ~/.config/git/config
1060   [sendemail]
1061   smtpserver = smtp.mailbox.org
1062   smtpuser = me@armaanb.net
1063   smtpencryption = ssl
1064   smtpserverport = 465
1065   confirm = auto
1066 #+end_src
1067 *** Submodule
1068 #+begin_src conf :tangle ~/.config/git/config
1069   [submodule]
1070   recurse = true
1071 #+end_src
1072 *** Aliases
1073 #+begin_src conf :tangle ~/.config/git/config
1074   [alias]
1075   stat = diff --stat
1076   sclone = clone --depth 1
1077   sclean = clean -dfX
1078   a = add
1079   aa = add .
1080   c = commit
1081   quickfix = commit . --amend --no-edit
1082   p = push
1083   subup = submodule update --remote
1084   loc = diff --stat 4b825dc642cb6eb9a060e54bf8d69288fbee4904 # Empty hash
1085   pushnc = push -o skip-ci
1086 #+end_src
1087 *** Commit
1088 #+begin_src conf :tangle ~/.config/git/config
1089   [commit]
1090   gpgsign = true
1091   verbose = true
1092 #+end_src
1093 *** Tag
1094 #+begin_src conf :tangle ~/.config/git/config
1095   [tag]
1096   gpgsign = true
1097 #+end_src
1098 ** Zathura
1099 The best document reader!
1100 *** Options
1101 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1102   map <C-i> recolor
1103   map <A-b> toggle_statusbar
1104   set selection-clipboard clipboard
1105   set scroll-step 200
1106
1107   set window-title-basename "true"
1108   set selection-clipboard "clipboard"
1109 #+end_src
1110 *** Colors
1111 #+begin_src conf :tangle ~/.config/zathura/zathurarc
1112   set default-bg         "#000000"
1113   set default-fg         "#ffffff"
1114   set render-loading     true
1115   set render-loading-bg  "#000000"
1116   set render-loading-fg  "#ffffff"
1117
1118   set recolor-lightcolor "#000000" # bg
1119   set recolor-darkcolor  "#ffffff" # fg
1120   set recolor            "true"
1121 #+end_src
1122 ** Tmux
1123 I use tmux in order to keep my st build light. Still learning how it works.
1124 #+begin_src conf :tangle ~/.config/tmux/tmux.conf
1125   set -g status off
1126   set -g mouse on
1127
1128   set-option -g history-limit 50000
1129
1130   set -g set-titles on
1131   set -g set-titles-string "#W"
1132
1133   set-window-option -g mode-keys vi
1134   bind-key -T copy-mode-vi 'v' send -X begin-selection
1135   bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -in -selection clipboard'
1136 #+end_src
1137 ** GPG
1138 *** Config
1139 #+begin_src conf :tangle ~/.local/share/gnupg/gpg.conf
1140   default-key 3C9ED82FFE788E4A
1141   use-agent
1142 #+end_src
1143 *** Agent
1144 #+begin_src conf :tangle ~/.local/share/gnupg/gpg-agent.conf
1145   pinentry-program /sbin/pinentry
1146
1147   max-cache-ttl 6000
1148   default-cache-ttl 6000
1149   allow-emacs-pinentry
1150 #+end_src
1151 ** Xmodmap
1152 #+begin_src conf :tangle (progn (if (string= (system-name) "frost.armaanb.net") "~/.config/xmodmap" "no"))
1153   ! Unmap left super
1154   clear mod4
1155
1156   ! Turn right alt into super
1157   remove mod1 = Alt_R
1158   add mod4 = Alt_R
1159
1160   ! Swap caps and control
1161   remove Lock = Caps_Lock
1162   remove Control = Control_L
1163   remove Lock = Control_L
1164   remove Control = Caps_Lock
1165   keysym Control_L = Caps_Lock
1166   keysym Caps_Lock = Control_L
1167   add Lock = Caps_Lock
1168   add Control = Control_L
1169 #+end_src
1170 ** sx
1171 #+begin_src shell :tangle ~/.config/sx/sxrc :tangle-mode (identity #o755)
1172   exec dwm
1173 #+end_src