Rhatto's locally-installed applications
=======================================

This repository hosts applications I keep installed locally inside my home
directory. Some of these applications also manages my configurations such as
dotfiles.

It is my starting point to keep all my configuration centralized in a single
versioned tree, so if I need to setup an account in a new machine -- be it
a server or personal computer -- I just need to clone this little thing and
run a couple commands to have my usual configuration ready to use.

If you don't like my config -- which might be the case as this kind of
stuff is so personal -- you still can use my approach to do the same
management with your own stuff.

Installation
------------

Get the code:

    git clone --recursive https://git.fluxo.info/rhatto/apps $HOME/apps

Then check the source integrity of the latest release:

    /usr/bin/git -C $HOME/apps verify-commit HEAD

Note that `/usr/bin/git` is called to avoid any other `git` wrappers or aliases
you might have available on your shell.

Inception
---------

To use a project distributed by this repository simply add it's folder into
your `$PATH`.

If you want to use all all my applications and dotfiles, replacing your
existing configuration with mine, simply run

    $HOME/apps/inception install --all --deps

Once installed locally, you can sincronize this config to a remote host using
rsync+ssh:

    inception deploy <hostname>

Folder structure
----------------

This repository also plays well with the following `$HOME` folder structure:

    apps: this repository
    code: other software projects
    data: media assets (git-annex and other repositories)
    file: other, non-software projects
    load: download area
    mail: maildir
    temp: temporary folder

Note the all folder names have:

* The same lenght so I get free alignment on lists.
* Lowercase characters to save typing.