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