My personal configuration files.
Find a file
Marty Oehme 90fcf81dfd
services: Fix commit_notes service autostart
Used wrong 'after' designation which would wait forever since it needed
to start after the runlevel which it was designated to run at.

Committed default.target.wants symlink to service file to automatically
enable its autostart on new machines.

This wil only really work for my directory set-up, so perhaps either the
service module should be disabled by default for the installation, be
asked during installation, or simply be manually enabled to autostart
during initial set-up (maybe mention in readme for the module).
2020-07-23 23:37:53 +02:00
.assets [polybar] Add sxhkd mode display module 2020-05-26 13:22:12 +02:00
.githooks Fix README image paths and dot description 2020-02-11 09:33:18 +00:00
alacritty/.config/alacritty [alacritty] Update settings file to recent version 2020-04-16 12:59:58 +02:00
bash [home] Remove module 2020-06-05 22:18:13 +02:00
bibtex [bibtex] Move pandoc latex template to module 2020-06-05 22:13:14 +02:00
bootstrap [nvim] Add python linting, suggestions to vim 2020-07-10 10:15:03 +02:00
dunst/.config/dunst Add simple dunst configuration 2020-02-16 14:29:21 +01:00
git git: Fix whitespace formatting 2020-07-23 12:25:46 +02:00
gopass [gopass] Add password revealing to rofi-gopass 2020-06-17 11:40:30 +02:00
i3/.config/i3 [sxhkd] Move media control mode to sxhkd from i3wm 2020-05-26 10:33:32 +02:00
mpv [repo] Add & update docs, fix install script dirs 2020-07-08 13:51:27 +02:00
nvim/.config/nvim nvim: Add longer yank highlight, standard toc map 2020-07-23 12:23:15 +02:00
picom/.config/picom Switch to GNU stow 2019-12-29 23:12:13 +01:00
polybar [polybar] Fix pomodoro timer script display 2020-05-26 13:42:14 +02:00
qutebrowser [qutebrowser] Lint and update options to 1.13 2020-07-08 09:52:14 +02:00
rofi [script] Add simple due script for bibtex file 2020-05-16 17:05:09 +00:00
rofi-surfraw/.config/rofi-surfraw Switch to GNU stow 2019-12-29 23:12:13 +01:00
scripts/.local/bin [mpv] Add quality limit to browser streams 2020-05-13 06:02:49 +00:00
services services: Fix commit_notes service autostart 2020-07-23 23:37:53 +02:00
sh sh: Unify fzf function names, add fzfman function 2020-07-23 15:33:02 +02:00
styler [styler] Remove optional rg dependency 2020-06-19 15:41:39 +02:00
sxhkd [sxhkd] Separate calculator and run shortcuts 2020-07-05 10:29:56 +02:00
tmux tmux: Fix session chooser without fzf 2020-07-23 15:29:05 +02:00
vifm [vifm] Use unique mpv player instance for video 2020-05-25 17:50:20 +02:00
X [X] Fix flashfocus autostart error 2020-07-05 10:27:31 +02:00
zsh [zsh] Expand fzf-tab functionality 2020-06-20 00:17:45 +02:00
.gitignore [mpv] Add sponsorblock 2020-05-13 23:32:34 +02:00
.gitlab-ci.yml Fix linting and static analysis 2020-02-10 22:24:38 +01:00
.gitmodules [polybar] Fix pomodoro timer script display 2020-05-26 13:42:14 +02:00
.stowrc [sh] Remove dimswitch,clean homedir,improve exist 2020-02-23 22:39:51 +01:00
install.sh [repo] Add & update docs, fix install script dirs 2020-07-08 13:51:27 +02:00
LICENSE Add LICENSE 2019-06-07 08:33:58 +00:00
README.md [sxhkd] Add script to show current sxhkd mode 2020-05-26 11:50:20 +02:00

dotfiles Read-Me and Roadmap

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-j>)
  • 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

Overview

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. Since it 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).

If you do not want to install any packages, but only link the dotfiles run stow -S */ from the main repository directory.

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

  • alacritty - Terminal emulator (GPU accelerated and customizable)
  • git - distributed version control system.
  • gopass - Password management suite, building on (and largely compatible with) pass for unix
  • i3 - Tiling window manager
  • nvim - Neovim configuration
  • pandoc - Pandoc plaintext transformation options (mostly latex templates)
  • picom - X11 compositor (maintained fork from compton)
  • polybar - Easy to customize statusbar
  • qutebrowser - vim-key enabled web browser
  • rofi - Application launcher, dmenu replacement
  • sxhkd - X11 hotkey manager
  • 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.
  • .config/shell contains all the general zsh/bash/sh configuration and environment variables usually contained in .zshrc, .zprofile and similar. It is divided in login shell config (loginrc.d), general shell config (rc.d) and zsh specific (zsh.d). Over time this should be migrated to specific stow 'units', but for now here is where it is.
  • 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.
  • .local/bin in scripts stow unit contains most executable user scripts. Most of these have been migrated to their corresponding modules (e.g. if a script exclusively targets git functionality, it will live there), some stand-alone scripts remain however.
  • .local/share/pandoc contains configuration for academic latex (pandoc, really) writing 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 runit as supervised services.
  • Generally, 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


  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. ↩︎