My dotfiles

Software

Current setup:

• 🐧 OS: Arch Linux (workstation & laptop) / postmarketOS (2nd laptop & phone, with sxmo)
• ⚙ Compositor: River
• ⚙ Window Manager: kwm
• 🍫 Bar: kwm's bar with custom blocks
• 🐚 Shell: zsh
• 🤖 Terminal: foot
• 🤖 Terminal Multiplexer: tmux
• 📮 Mail Client: aerc
• 🌐 Web Browser: Firefox
• 🧮 Code/Text Editor: neovim
• 📜 Word Processing: LaTeX (but more often via Markdown + pandoc)
• 📊 Presentations: LaTeX with beamer (more often via Markdown + pandoc)
• 📜 PDF viewer: zathura
• 🎥 Media Player: mpv
• 🎵 Music: rmpc (client) or ncmpcpp (client) with mpd + snapcast
• 📝 Notes: neovim and markdown files in a git repo
• ✅ To-Do: todo.txt with my own todo.txt-more extension.
• 📆 Calendar: todo.txt-more
• 🗞️ RSS Client: newsraft
• 🎤 Podcasts: same as above
• ⌨️ Launcher: bemenu
• 🌅 Photo viewer: swayimg
• 🌅 Photo editing: gimp
• 🌅 Image editing (vector): inkscape
• 📹 Video editing: kdenlive
• 💬 Chat: senpai + soju (IRC), nheko (Matrix, using bridges for Signal, Discord, Telegram), Dino (XMPP)
• 🔖 Bookmarks: buku + bemenu script
• 🔐 Password Management: pass
• 🛩 Flight Simulator: X-Plane 12 with simheaven, LittleNavMap,
• 🤦 Social Media: Mastodon

Install

You probably don't want to use the install method if you're not me, but rather just pick and copy things you like into your own setup.

If you are me, you (me) can install all dotfiles including all system packages I use for my system as follows:

$ make install

On Arch Linux this essentially provisions and entire desktop system. The script is idempotent so can be rerun freely.

However, to forcibly update some things as well, use this instead:

$ make update

Key bindings

• river/kwm
  • cmd+1,2,3,4,5,6,7,8,9 - switch tags/workspace
  • cmd+Shift+1,2,3,4,5,6,7,8,9 - move window to selected workspaces
  • cmd+tab - Switch to last used workspace (and back)
  • cmd+period - switch to right monitor
  • cmd+comma - switch to left monitor
  • cmd+Shift+period - move window to right monitor
  • cmd+Shift+comma - move windows to left monitor
  • cmd+space - Launcher (kickoff)
  • cmd+shift+space - Launcher (fuzzel)
  • cmd+enter - Put window in focus/master area
  • cmd+Shift+enter - New terminal
  • cmd+j|k - cycle window focus
  • cmd+l|h - resize window
  • cmd+ctrl+delete - Quit
  • cmd+Escape - Lock
  • cmd+Shift+Escape - Suspend
  • Layouts:
    • cmd+t - Switch to tiling layout
    • cmd+m - Monocle layout
    • cmd+g - Grid layout
    • cmd+s - Scroll layout
    • cmd+Shift+apostrophe - toggle floating
  • Timetracker:
    • cmd+slash - Timetracker
    • cmd+Shift+slash - Stop tracking
• tmux
  • alt+left/right/up/down - Switch pane
  • alt+pageup/pagedown - Switch window
  • ctrl+a (prefix)
    • (number) - Switch window
    • c - New window
    • " - New pane (horizontal split)
    • % - New pane (vertical split)
    • ctrl+a - Switch to last window (and back)
    • ; - Switch to last pane (and back)
    • space - Switch pane layout (cycles through a few), good for turning vertical panes horizontal and vice versa
    • , - Rename window
    • / - Flip/swap
    • x - Kill pane
    • z - zoom pane
    • ! - Break pane (to its own window)
    • l - Clear history
    • r - reload
    • v - copy mode
      • VI bindings (v,y,w,/,hjkl etc..)
    • P - paste buffer
    • W - Swap window
    • Q - Swap pane
    • M - Move pane (to another window or tmux)
    • F - Fingers mode
• vim
  • leader is space
  • navigate popup menus with C-j C-k
  • spelling
    • z= -- spelling suggestion
    • :set spelllang
  • buffers
    • C-^ -- previous buffer
  • telescope
    • <leader> o - git files
    • <leader> f - find files
    • <leader> b - find buffers
    • <leader> F - find inside files (live grep)
  • building
    • F4 - Build and preview (syncronously) (tex, markdown); pip install . (python)
    • F5 - Build and preview (asyncronously) (tex, markdown); pip install . (python)
  • git (tpope/fugitive)
    • F9 - Commit
    • F10 - Push
  • documentation/navigation/LSP
    • K - documentation
    • <space>lc - Incoming calls
    • <space>lC - Outgoing calls
    • <space>ld - Goto definition
    • gi - Goto implementation
    • gr - goto references
    • ga - show (unicode) character information
  • editing
    • <space>_ - strip trailing whitespace
    • visual mode
      • gc - (un)comment selection