10 releases

0.2.0 Oct 5, 2020
0.1.9 Oct 4, 2020
0.1.3 Sep 19, 2020
0.1.0 Aug 27, 2020

48 downloads per month

Custom license

32KB
854 lines

Tittle - Dotfile Manager

Tittle tracks your dotfiles under version control and supports fine-grained user/machine-specific configuration.

Quick Start

You can start your own tittle-managed dotfile repo like so:

> tittle track ~/.config/i3
INFO: tracking /home/enricozb/.config/i3 under i3
> tittle repo git@github.com:enricozb/dotfiles
> tittle push

You can also clone an existing one with:

> tittle clone https://github.com/enricozb/dotfiles

Install

Currently the easiest way to install tittle is through cargo:

cargo install tittle

Documentation

  • commands: for info on the commands that tittle accepts.
  • config: for the tittle config specification.
  • templates: for how to use templates and variables.
  • tracking: for info on how to use tittle track.

Terminology

Throughout the codebase and this document the terms remote and local appear often. Remote refers to files that are under the $XDG_CONFIG_HOME/tittle directory. Local files are those on the user's filesystem currently being used as configs.

To do

See todo.

Why?

No idea.

Dependencies

~3.5–5MB
~110K SLoC