Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Because home is wherever:

Where the wind takes us next year no turtle can tell
But we'll still be at home, come high water or hell,
Because home is wherever you carry your shell.
-- Windward, by Stephen Savitzky, 2015

This project contains a set of configuration files, with Makefiles for setup and installation, that allow me to set up a home directory exactly the way I like it, with a single command. Unlike its predecessor, which was very specific to me, it's meant to be reasonably general -- it expects to find its repository on github, leaves your .mailrc and .signature files alone, and preserves most of your old configuration in case you didn't really mean it. (It will probably get even more general as time goes by -- suggestions welcome.)

On the other hand, it still sets up my favorite aliases, gnome configuration options, emacs options, and xmonad configuration. Forking is not only encouraged, it's practically mandatory if you want to stay sane.

That said, there are provisions for personal and machine-local customizations: see the local directory. I first started putting those in to accommodate laptop and desktop systems with a wide range of screen sizes; it's gotten somewhat more general since then.

There is also a sample customization package that provides a wrapper around Honu, called (of course) Myrtle. (I have my own, too; it's called Mathilda. In case you were wondering, "Honu" is the Hawaiian word for the green sea-turtle, and Mathilda is the pet name my bandmate and I have for the narrator of "Windward".)

Annotated Contents


This is the shell script that runs the configuration process. Just say:
wget -O -|bash
or something of the sort. You can also clone the repo and source it, but half the fun is watching the magic unfold.

Honu will install itself in whatever directory you run the script in, and make a symlink in your home directory if necessary.


The license for this project.


Once things get bootstrapped, the entire configuration process is run via the Makefile. make install is the main target; eventually there will be targets for partial installs, e.g. on tiny systems, servers, or systems where I don't have sudo access.

The project's to-do list, of course. The format is trivial: an open circle (lowercase "o") is something that's not started yet; a period is something in progress, and a filled circle (asterisk) is finished. "~" indicates something I've decided not to do, and "?" indicates something I'm dithering about. "&" indicates something I did that I wasn't planning to do. Eventually finished items move to a "done" section.



Programs. Mostly small shell scripts; I don't think there are any actual binary files in there at the moment. Some are symlinks into other parts of the tree, e.g. dotfiles/_xmonad. No doubt many are useless at this point; some date back to the days of usenet.


Configuration files and directories that are symlinked into ~/.config/. Other files in .config are of course left alone.


Configuration files that go into the home directory. They are symlinked rather than being copied.


Like it says on the tin: configuration files for emacs. This doesn't include .emacs, which you'll find in dotfiles.


Files that are expected to be edited on a per-system or per-user basis. Initial versions are created by make install, but are left alone after that to preserve edits. If you're using Myrtle or Mathilda, most of these will be symlinks.


The Makefile here lets you download and install various optional programs from elsenet.


Scripts for configuring the things that can't (easily) be installed by simply symlinking a dotfile. This includes a lot of Gnome options. There are also files with a -pkgs suffix, that install programs using apt.

Copyright © Stephen R. Savitzky (HyperSpace Express)


Set up a Linux system and your home directory with a shell one-liner. As Mathilda the turtle says, "Home is wherever you carry your shell."







No packages published