hogi 0.4

The dotfile and home synchronization tool for perfectionists with deadlines.

pipeline_badge coverage_badge

Code: https://rolln.de/knoppo/hogi/tree/master

Coverage: https://coverage.rolln.de/knoppo/hogi/master

Documentation: https://docs.rolln.de/knoppo/hogi/master



hogi is yet another approach to dotfile and home directory synchronization. It comes with a text-based user interface (TUI) that runs in almost all terminals and provides a user-friendly way to manage the files you want to synchronize across your *nix machines and users.

Instead of copying the files directly into your home directory, all git repositories and rsync directories are stored along with the configuration file inside each users ~/.hogi/ directory. hogi will then create symlinks in your home directory pointing to these source files. Each source file can be configured and can have its own custom symlink.

The git/rsync sources are grouped into features to allow different pre-configured sets of them.

Sources (git repositories or rsync remote directories) can be linked themselves. This allows to install and update repositories like oh-my-zsh or vim pathogen plugins directly into your home directory.


I wanted a dotfile synchronization tool that…

  1. shows the magic its doing.
  2. runs on all *nix environments.
  3. is easy to install.
  4. is easy to configure.
  5. allows different configurations for each user/machine to skip desktop-only files on a server and vice-versa.
  6. supports rsync for binary files.


Copyright (C) 2016-2018 Mathias Stelzer

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

Indices and tables