My personal configuration files.
Find a file
Marty Oehme 333e2580f0
git: Add personal git server substitutions
Added automatic aliasing for my own git server pushing and pulling.
2021-12-15 17:38:10 +01:00
.assets Switch to wayland 2021-11-30 22:30:07 +01:00
.githooks sh: Switch yay to paru 2020-12-22 19:54:38 +01:00
alacritty/.config/alacritty Switch to wayland 2021-11-30 22:30:07 +01:00
an2linux an2linux: Try to fix ignored messages 2020-11-13 08:52:19 +01:00
bash bash: Fix git stash alias setting 2021-07-07 10:24:04 +02:00
bibtex bibtex: Fix default pandoc compilation target 2021-06-02 23:23:16 +02:00
bootstrap pass: Add wtype typer tool to pass-pick 2021-12-14 14:28:08 +01:00
disks disks: Fix udiskie service config file sourcing 2020-11-05 22:26:19 +01:00
dunst/.config/dunst nvim: Switch from vimL to lua setup 2021-05-24 18:01:54 +02:00
git git: Add personal git server substitutions 2021-12-15 17:38:10 +01:00
mail mail: Update to new neomutt structure 2021-11-23 16:09:32 +01:00
mpv mpv: Switch to m for menu invocation key 2021-11-30 22:43:43 +01:00
nvim/.config/nvim nvim: Switch to compe compatible branches 2021-12-04 11:24:28 +01:00
pass pass: Add wtype typer tool to pass-pick 2021-12-14 14:28:08 +01:00
picom/.config/picom Switch to GNU stow 2019-12-29 23:12:13 +01:00
qutebrowser qutebrowser: Add maps for command mode navigation 2021-12-02 16:55:43 +01:00
rofi Switch to wayland 2021-11-30 22:30:07 +01:00
rofi-surfraw/.config/rofi-surfraw Switch to GNU stow 2019-12-29 23:12:13 +01:00
scripts scripts: Add custom ytdl options for vidl 2021-12-11 11:17:58 +01:00
services services: Add geoclue agent as systemd autostart 2021-04-12 18:40:47 +02:00
sh Switch to wayland 2021-11-30 22:30:07 +01:00
ssh ssh: Add simple ssh configuration module 2021-04-05 15:04:27 +02:00
styler [styler] Remove optional rg dependency 2020-06-19 15:41:39 +02:00
sxhkd sxhkd: Switch dunst pause for history search 2021-10-20 22:35:49 +02:00
taskwarrior taskwarrior: Add overdue emoji script 2021-11-23 16:13:54 +01:00
tmux tmux: Add music session to defaults 2021-11-30 22:37:36 +01:00
vifm/.config/vifm Switch to wayland 2021-11-30 22:30:07 +01:00
wayland river: Move often used keybinds around 2021-12-14 15:31:10 +01:00
zathura/.config/zathura zathura: Add simple zathura configuration 2020-09-23 17:14:08 +02:00
zsh zsh: Fix shell history settings 2021-11-16 12:18:39 +01:00
.gitignore taskwarrior: Move sync settings out of repo 2021-10-10 10:04:59 +02:00
.gitlab-ci.yml repo: Update linting for 4-spaced shell scripts 2021-04-04 20:52:52 +02:00
.gitmodules [polybar] Fix pomodoro timer script display 2020-05-26 13:42:14 +02:00
.stowrc stow: Remove readme symlinking 2020-10-21 16:48:51 +02:00
install.sh Switch to wayland 2021-11-30 22:30:07 +01:00
LICENSE Add LICENSE 2019-06-07 08:33:58 +00:00
README.md README: Update in preparation for wayland 2021-12-02 16:55:17 +01:00

~/🌹

Note that the below screenshots still show the X configuration from v0.1. The current dotfiles are geared toward wayland for which the setup looks similar but not identical to the previews below.

What's in these dotfiles

  • vim configuration for simple programming tasks (especially go/typescript/python/bash) and prose
  • academic workflow tools, to allow quick citation, pdf compilation, and preview
  • simple, efficient polybar with package update notification, and spotify (mpris) integration
  • tmux session management through tm and tl tools
  • tmux fuzzy-searching of terminal sessions to switch to with hot-key (<C-A><C-s>) in addition to normal session switching
  • system-wide color management (terminals, vim, qutebrowser, polybar, xresources) through styler command using base16 themes
  • quick theme switching by activating styler and fuzzy-searching themes with hot-key (<Super>+F8)
  • many vim color-schemes with quick light/dark switching (F8) and individual theme switch (<Space>+F8)
  • quick directory jumping using z, with fzf integration
  • fzf integrations for bibtex citation, vim buffer management, most recently used switching, shell command history, and more

Styler recoloring demo

Quick-Start

The dotfiles use GNU stow to link themselves in the home directory. You can clone this repository anywhere (though I have mine in ~/.dotfiles as it seemed most logical for me).

I would recommend doing a git clone --recursive for this repository, since it contains git submodules, which will then automatically get pulled in as well. Of course, you can do it non-recursively and then just pull those modules selectively which you actually want.

Once in the repository directory, when you then run ./install.sh it will install many of the packages I use (though they are probably slightly out-of-date) and link the dotfiles into the home directory. If you do not want to install any packages, but only link the dotfiles run stow -S */ from the main repository directory. Since dotfiles management is based on stow, it will not overwrite anything already in the home directory (though you can force it to if you really want, using stow --override='.*' -- I do not recommend this).

After all files are linked and you open a new shell session, the dotlink alias will allow you to re-link all dotfiles from anywhere on the system.1

Both automatic installation paths are presumably somewhat brittle. In any case, I would suggest to manually look through the files for things you want instead of copying and activating everything. Dotfiles are too personal to be standardized like that. They're pets, not cattle. Enjoy!

Main Modules

Overview - an older image of the dotfile desktop with gaps, showing git logs, styler logs, duckduckgo in a browser, and a vifm view of the dotfiles themselves

  • alacritty - Terminal emulator (GPU accelerated and customizable)
  • wayland - Containing basics for fully functional tiling wayland setup:
    • river - Tiling window manager for wayland
    • waybar - Easily customizable statusbar for wayland
    • bemenu - Extended dmenu replacement for wayland, X11 and ncurses
    • [fontconfig] - System-wide font replacements and styling settings
  • git - distributed version control system.
  • pass - Password management suite
  • nvim - Neovim configuration
  • bibtex - LateX/BibteX/pandoc plaintext writing & reference suite
  • qutebrowser - vim-key enabled web browser
  • tmux - terminal multiplexer
  • vifm - vim-like file-manager

Notes

  • Generally, most configuration for applications attempts to follow the XDG specifications, keeping configuration in .config directory and supplementary files in .local/share directory. Over time, I am moving more applications to this standard: it keeps the home directory clean, and the separation of configuration, binaries, and data relatively clear.
  • The zsh directory contains all setup for the z-shell, my daily work environment. It should not be required for working with any other module but will add additional functionality to many (such as command auto-completion and so on). sh sets some base functionality for any shell you may wish to work in. It is, for now, the only module that is required for some other modules to work.2
  • rofi contains additional scripts and a simple theming framework for rofi and should probably be reorganized to put the correct files into the correct directories (per xdg) at some point.
  • Whereas sh module scripts are requirements for other scripts, .local/bin in the scripts module contains most executable user scripts. Most of these have been migrated to other corresponding modules (e.g. if a script exclusively targets git functionality, it will live there), some useful --- or left-over --- stand-alone scripts remain however.
  • .local/share/pandoc contains configuration for academic latex writing (pandoc, really) and is of interest if you want to use this functionality.
  • .xinitrc is used for x initialization and program startup. At some point, some of the consistently running applications may be moved to systemd/runit as supervised services.
  • Generally, top-level directories starting with a . are only meaningful for the repository not for the functionality of the machine that these dotfiles are deployed on. That means .gitlab-ci.yml, .assets/, .stowrc and similar files and directories will not show up in the final deployment in any home directory. Perhaps they should be called dotdot-files since they're the dotfiles for my dotfiles. 🙂 (Also, 'dotfiles'.)

Gapless - the same image as above, only displayed without gaps


  1. This alias only works when the dotfiles are cloned into ~/.dotfiles, mirroring my setup. This is due to a hard-coded cd into this directory. If your dotfiles lie in another directory and you want to use the dotlink alias, simply change the corresponding line in bootstrap/.config/sh/alias.d/dotlink.sh] ↩︎

  2. I may remove this requirement in the future to make modules more self-contained. However, relying on some base utility scripts makes it easier to avoid duplicating such functionality for each individual script in other modules. ↩︎