A dotfile manager
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
trivernis a4848617c6
Fix issue where directories are created in the wrong places
10 months ago
src Fix issue where directories are created in the wrong places 10 months ago
.gitignore Add initial cli funcitonality 10 months ago
Cargo.lock Add config entry to ignore files 10 months ago
Cargo.toml Add config entry to ignore files 10 months ago
LICENSE.md Add README and LICENSE 10 months ago
README.md Add default repo path to data dir 10 months ago

README.md

silo

Silo is a dotfile manager that supports templating.

Install

Currently silo can only be installed manually by cloning the repo and running cargo install --path .

Usage

Create Repo

First create a repo

silo --repo /path/to/repo init

This creates the repo directory and initializes a git repository. If no --repo argument is passed, it will default to $HOME/.local/share/silo or $HOME/AppData/Roaming/silo.

Add configuration files

Now add some configuration files you want to track. Silo uses metadata-files to keep track of which files belong where. For example if you want all files in the root directory of your repo to be copied over to your home folder, you'd add a dir.toml entry like this:

path = "{{dirs.home}}"
ignored = []

Notice the use of templating for the path. The dirs variable contains paths specific to your platform. home in this case would either be {FOLDERID_Profile} on Windows or $HOME on Linux and MacOS. The ignored setting can be used to ignore certain files using an array of glob-strings.

Now add some files to the repos root directory. Normal files get just copied over. Subdirectories are created and copied as well, unless they themselves contain a dirs.toml file that specifies a different location.

Files ending with .tmpl are treated as handlebars templates and are processed before being written to the target location. The .tmpl extension will be stripped from the filename. You can check the available context variables and their values on the system with silo context.

Applying the configuration

Once you have a repo you want to apply you can run

silo --repo /path/to/repo apply

which will process and copy over all the configuration files of that repository.

License

CNPL-v7+