Marty/dotfiles
1
0
Fork 0
Code Issues 3 Pull requests Projects Releases Wiki Activity
My personal configuration files.
485 commits 7 branches 1 tag 27 MiB
Lua 65%
Shell 17.9%
Python 8.4%
Nushell 3.7%
Vim script 2.9%
Other 2%
Find a file
Marty Oehme facb95f0b9
Fix linting and static analysis 
Set linter and formatter to *only* run when files it works for are
actually detected. Uses moreutils' ifne to detect the status of stdin
before sending an empty string to the test suite.
2020-02-10 22:24:38 +01:00
.assets Standardize top-level directory paths 2020-02-07 22:41:30 +01:00
.githooks Add git hook for package comparison 2020-02-07 22:31:41 +01:00
_bootstrap Remove zsh plugin manager 2020-02-08 16:28:36 +01:00
alacritty/.config/alacritty Switch to GNU stow 2019-12-29 23:12:13 +01:00
fontconfig/.config/fontconfig Switch to GNU stow 2019-12-29 23:12:13 +01:00
git Sign commits by default 2020-02-07 22:36:00 +01:00
gopass/.config/gopass Switch to GNU stow 2019-12-29 23:12:13 +01:00
home Add basic XDG compliant sh architecture 2020-02-02 15:08:40 +00:00
i3/.config/i3 Move scripts into respective directories 2020-02-08 20:17:44 +01:00
libinput-gestures/.config Switch to GNU stow 2019-12-29 23:12:13 +01:00
nvim/.config/nvim Add spellsync plugin to vim 2020-02-08 18:42:12 +01:00
pandoc/.local/share/pandoc/templates Add personalized pandoc latex template 2020-01-03 10:29:44 +01:00
picom/.config/picom Switch to GNU stow 2019-12-29 23:12:13 +01:00
polybar Move scripts into respective directories 2020-02-08 20:17:44 +01:00
qutebrowser Integrate dynamic colorschemes into applications 2020-02-01 11:01:26 +01:00
rofi Move scripts into respective directories 2020-02-08 20:17:44 +01:00
rofi-surfraw/.config/rofi-surfraw Switch to GNU stow 2019-12-29 23:12:13 +01:00
scripts/.local/bin Fix compile script 2020-02-08 20:26:31 +01:00
sh Change ifinstalled script to exist 2020-02-08 20:23:30 +01:00
styler Add styler zsh completions 2020-02-05 23:52:23 +01:00
sxhkd/.config/sxhkd Integrate dynamic colorschemes into applications 2020-02-01 11:01:26 +01:00
tmux Fix tmux vim navigator movement 2020-02-06 20:49:15 +01:00
vifm Move scripts into respective directories 2020-02-08 20:17:44 +01:00
xdg-user-dirs/.config Add basic XDG compliant sh architecture 2020-02-02 15:08:40 +00:00
xresources/.config/xresources Fix xinitrc issues 2020-02-01 15:17:10 +01:00
zsh/.config/zsh Improve zsh vi-mode handling 2020-02-10 21:07:00 +01:00
.gitignore Standardize top-level directory paths 2020-02-07 22:41:30 +01:00
.gitlab-ci.yml Fix linting and static analysis 2020-02-10 22:24:38 +01:00
.stowrc Change bootstrap to use standard stow functions 2020-02-06 12:48:08 +01:00
install.sh Add git hook for package comparison 2020-02-07 22:31:41 +01:00
LICENSE Add LICENSE 2019-06-07 08:33:58 +00:00
README.md Point main README to git module README 2020-02-06 15:09:45 +01:00

README.md

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

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.
  • .config/rofi contains additional scripts and a simple theming framework for rofi and should probably be migrated into the correct directories at some point.
  • .local/bin in scripts stow unit contains most executable user scripts.
  • .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.
  • .gitlab-ci.yml is only used for simple CI code linting and static analysis on gitlab, can be deleted on individual deployments.

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