My personal configuration files.
Go to file
Marty Oehme bc046d02df
nvim: Switch to lua-based setup
nvim: Restructure lua config directory

Restructured lua setting files, so that plugin settings are in clearly
labelled as such files, and the base files are just there --- the base
directory.

This should also lay the ground work for modularizing plugins, so that
we can enable/disable plugin groups as we need them.

----------

nvim: Remove ale linter and formatter

Removed ale from plugins.
Linting is being taken care of by lsp and treesitter plugins and
formatting by formatter.nvim.

Added all filetypes ale took care of to formatting on save.

----------

nvim: Replace wiki.vim with zettelkasten.nvim

Removed lerlvag's `wiki.vim` from plugin list.
Though I love it and loved using it, by now it clutters up the list and
the basic functionality I need it provided by zettelkasten.nvim.
(That being linking, following links, and quickly opening a central file).

I may still come back to it at some point, but for now I am happy with
the new setup.

----------

nvim: Add toggleterm and lazygit integration

Added toggleterm plugin, integrating a very quick access to the neovim
terminal (`<leader>=` mapping).

Additionally, added a command to quickly call up a lazygit floating
windows with the same plugin. `<leader>G` will open a git management
window in which you can stage, remove, commit, push, pull and more.

----------

nvim: Replace surround, sneak; Add treesitter, dial

Replaced vim-sneak with lightspeed lua plugin, which accomplishes
similar to the same goal, with a little more flexibility (can also be
used to replicate other vim plugins like e.g. easymotion).
For now I am using it as a straight replacement, with the same fF/tT
functionality stretching over multiple lines, and quick sS 2-letter
jumps to any location ahead/back.
The highlighting is noticeably more stable and faster. For now it is set
to always highlight the next 5 occurences of a letter, wherever they
are. Lastly, it does not -- so the lightspeed author -- change the
buffer in any way which is what happened with sneak (due to vimscript
limitations) and which can and did confuse things like treesitter and
the lsp integration.

Replaced vim-surround with a lua-equivalent surround.nvim. This one I am
less sure about, the lua pluging, while working, still carries some bugs
and does not seem as thoroughly tested. It still has problems with
surrounding stuff with e.g. `*` and does not deal well with some
quotation situations. I will try to keep using it and perhaps find the
time to contribute to some of the issues instead of going back at first
however, purely since I am a much bigger fan of the plugin existing in
luascript.

Replaced vim-peekaboo with registers, another switch to a lua plugin,
which also functions slightly differently however. I much prefer the lua
plugins display of register contents which simply appear as a dropdown,
compe-like, and I can either paste with the correct symbol choice as
always, or by scrolling through it as if it is an autocomplete choice.

Added dial.nvim which slightly extends the functionality of ^a and ^x
number in-/decreases. It should barely be noticeable in normal operation
but now the combination can be used to change dates, alphabet
characters, hex codes and some more. Most prominently, I am using it for
date manipulation.

Added a couple of treesitter related plugins:
treesitter-context shows the context the cursor is currently in if the
beginning of this context goes off-screen, e.g. the function beginning
or current class being edited. Works for nested contexts.
treesitter-textsubjects allows selecting units of codes by going up the
tree branches. So, first you select an argument, then the whole argument
chain, then the function definition, then the whole function, then the
containing class, and so on. It is quite natural, however, I have so far
only made it work for visual selection, so not as a motion target.
Still, very useful - works with `v.` and can be repeated with `.`.
Lastly, ts-context-commentstring improves the correct selection of
commenting type for commenting plugins (i.e. my `gcc` mapping), by
making use of treesitter where available. Can even do multi-language
files like vue, react, or tsx modules with html, css and javascript
interweaved.

----------

nvim: Add code formatter

Added code formatter in lua, right now supporting python, cpp,
javascript, lua, rust.
More can very easily be added.

I am not sure if this plugin supports the formatting of code within
snippets in another file format (lukas-reineke/format.nvim does support
this, but seems not-maintained).

----------

nvim: Add tmux, snippet completion

Added (for real this time) tmux adjacent buffer completion.

Added vsnip completion through compe: Invoke a completion (shown in
compe with snippet preview) through <cr> or <space-cr> and then use
<tab> and <s-tab> to go back and forth through the completable positions
for the respective snippet.

Many default snippets included through the community repository of
friendly-snippets.

----------

nvim: Improve compe completion, Add outline view

Added outline view to neovim, similar to the well-known vista.vim
plugin. Can be opened (and closed again) with <leader>o mapping, simply
mnemonic for 'outline'.

Added unicode symbols (invoked with '\') and tmux adjacent buffers
to compe completion sources.

----------

nvim: Add zen writing mode in lua

Switched from goyo to TrueZen.nvim in looking for a lua replacement of
zen writing modes. The F11 shortcut remains the same, additionally using
F10 shortcut to enter a less drastic minimal mode.

----------

nvim: Switch keymaps to lua format

Using cartographer to make setting keymaps easy.

----------

nvim: Add tmux Navigator lua replacement

----------

nvim: Add autopairs, zen writing lua plugins

Switch goyo and autopairs to make use of lua plugins.

Moved most of the plugin setup code from a custom and manually updated
array being called from init.lua, to their respective plugin
installations in plugins.lua (so, wherever the plugin is installed also
contains the call of the configuration code).

This should hopefully reduce duplication a little and may prepare for
the lua plugin setups to end up in plugins directory of neovim.

----------

nvim: Add lua statusline, base16, async grep

Added galaxyline in an initial iteration which is probably overloaded
but integrates well with the also moved over to lua base16 colorschemes.
For now, it is possible to, at any point, simply call the `:lua
B16theme('themename')` command to change the colorscheme of both neovim
itself and the galaxyline with it.

The statusline, as of now, includes the activated mode (of course), the
filename being edited, the edit state (whether changed from last save,
or read-only), the current git branch if any, as well as the amount of
added, modified, and deleted lines from current git commit. On the right
hand side it contains the lsp status (if connected), the amount of
errors and warnings in current file, the filetype currently recognized
for the file, as well as the usual cursor position in the window.

Added some small other things, including an asynchronous fuzzy-backed
full-text search through telescope, which should hopefully make
full-text searching much more responsive than before; updated the
version of indentline to the correct one; and disabled some unused vim
built-in plugins.
2021-07-27 10:12:33 +02:00
.assets repo: Move some assets to gitlab wiki 2021-04-05 13:15:11 +02:00
.githooks sh: Switch yay to paru 2020-12-22 19:54:38 +01:00
alacritty/.config/alacritty alacritty: New default font size 2021-03-27 22:21:11 +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 nvim: Switch to lua-based setup 2021-07-27 10:12:33 +02: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: Fix shellcheck zsh static analysis detection 2021-07-08 12:11:23 +02:00
i3/.config/i3 xdg: Move xdg media directories 2021-04-18 13:04:59 +02:00
mail repo: Update linting for 4-spaced shell scripts 2021-04-04 20:52:52 +02:00
mpv mpv: Decrease overlay font size 2021-06-02 23:16:21 +02:00
nvim/.config/nvim nvim: Switch to lua-based setup 2021-07-27 10:12:33 +02:00
pass pass: Add README explaining the switch 2020-09-12 17:33:05 +02:00
picom/.config/picom Switch to GNU stow 2019-12-29 23:12:13 +01:00
polybar polybar: Add pop-up calendar to date module 2021-07-08 10:39:34 +02:00
qutebrowser qute: Update bookmarklets and config structure 2021-04-22 11:37:27 +02:00
rofi rofi: Remove leftover test files 2021-06-02 23:08:58 +02:00
rofi-surfraw/.config/rofi-surfraw Switch to GNU stow 2019-12-29 23:12:13 +01:00
scripts scripts: Remove bar animations from vol/brightness 2021-06-02 23:30:47 +02:00
services services: Add geoclue agent as systemd autostart 2021-04-12 18:40:47 +02:00
sh fasd: Fix directory display to work on all shells 2021-07-07 10:28:15 +02: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: Change chain mode exiting 2021-07-10 18:03:50 +02:00
taskwarrior taskwarrior: Make auto-sync script silent 2021-07-10 18:04:14 +02:00
tmux bibtex: Fix default pandoc compilation target 2021-06-02 23:23:16 +02:00
vifm vifm: Fix vifmrun script argument parsing 2021-04-21 11:09:33 +02:00
X sxhkd: Change chain mode exiting 2021-07-10 18:03:50 +02:00
zathura/.config/zathura zathura: Add simple zathura configuration 2020-09-23 17:14:08 +02:00
zsh sh: Added date stamps to history command 2021-03-27 22:19:43 +01:00
.gitignore bootstrap: Update package index 2021-07-10 23:51:48 +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 repo: Update linting for 4-spaced shell scripts 2021-04-04 20:52:52 +02:00
LICENSE Add LICENSE 2019-06-07 08:33:58 +00:00
README.md repo: Move some assets to gitlab wiki 2021-04-05 13:15:11 +02:00

~/🌹

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)
  • i3 - Tiling window manager
  • polybar - Easy to customize statusbar
  • picom - X11 compositor (maintained fork from compton)
  • 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
  • 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 - 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. ↩︎