hods 0.5

The home directory synchronization tool for perfectionists with deadlines.

pipeline_badge coverage_badge

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

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

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



hods (previously hogi) is yet another approach to synchronize home directories and dotfiles. The text-based user interface (TUI) runs in almost all terminals to provide a user-friendly configuration, even on headless hosts.

It uses rsync and optionally git to synchronize the configuration across all your users and hosts. hods groups these sources into features to easily create different configuration sets (E.g. default, headless, desktop, …). Each feature has optional shell hooks to prepare or initialize your sources.

The configuration files, the log and all sources are stored in ~/.hods/. Symlinks and templates (requires jinja2 or mako) are used to keep everything clean and in sync.


Found a bug?

  • All bug-reports are welcome. Try to find similar tickets first and be as informative as you can.

  • I will most likely fix it for you! Your problem with my project is my problem.

  • You have an idea how to solve an existing issue? Feel free to join the conversation!

  • You think you can fix it yourself? Awesome!! Feel free to contribute.

  • As always, please don’t expect anything. We’re all doing our best and good things take time.


Copyright (C) 2016-2020 Mathias Stelzer

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

hods 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/>.

Documentation Contents