10 releases

0.2.7 Oct 2, 2025
0.2.6 Jul 20, 2025
0.2.5 Feb 1, 2025
0.2.4 Sep 10, 2024
0.2.1 Jun 2, 2024

#595 in Configuration

Download history

458 downloads per month

Unlicense

31KB
639 lines

Homux is a home directory multiplexer.

How it works

A source directory is applied to the home directory of multiple hosts. In order to multiplex configurations across different hosts, the matchpick library is used to match different lines depending on which host is being applied to.

Let's look at an example configuration file, ~/.gitconfig. Suppose our home computer is named "homestation", while our computer at work is named "workstation". We wish to configure our email address differently on each host, while keeping our name the same:

# https://git-scm.com/docs/git-config
[user]
    name = Tux Linux

    ~>>>
    email = "[email protected]"
    ~>>> homestation
    email = "[email protected]"
    ~>>> workstation
    email = "[email protected]"
    ~<<<

This allows a single directory managed by a single repository to be used as the configuration source even across different hosts.

Dependencies

~1–12MB
~93K SLoC