View Homb on GitHub

Homb

Join the chat at https://gitter.im/threeiem/homb

Welcome Homb

The Homb is set of extensions for bash with all the gory details using fresh. Fresh is required for managing configurations, including configuring Homb. Homb leaves all the application configurations to Fresh while Homb extends applications with various completions, helpers, and tools. See the wiki for details on how to use Homb.

Homb only works with newer versions of bash and also relies on heavily on git. Currently we have tested Homb with newer versions of bash on CentOS/Redhat and flavors of Debian (Ubuntu and Raspbian).

Installing Homb with Fresh

The Homb project only works with Fresh. (Fresh is totally worth setting up.)

Install fresh

Install fresh with the following:

bash -c "`curl -sL get.freshshell.com`"

Configure Bash (~/.bash_profile)

Once fresh is downloaded add this to your ~/.bash_profile file (not ~/.bashrc).

export HOMBASE="${HOME}/.homb"
export FRESH="${HOME}/.fresh/build/shell.sh" && test -f $FRESH && source $FRESH

Configure (~/.freshrc)

Add this to the .freshrc file. In this example we are using “~/.homb/” as the setting for the $HOMBASE environment variable in the .bash_profile file.

# fresh make me a homb
fresh threeiem/homb . --file=~/.homb/

# fresh load homb
fresh threeiem/homb rc

Run fresh

It’s time to run fresh and begin setting things up. This will install homb with the latest version.

fresh

Run homb

Fresh has installed homb, but to run homb you need to resource .bash_profile

source ~/.bash_profile

homb Coming

Once homb is installed you can update using the homb command. Running homb runs fresh, then resources all the files to load the updated version.

homb

Common Problems

  • Not using bash? Homb is for bash only. Save that korn shell for taco night.

  • Non-Interactive Bash Check to see if you are running an interative shell. Check with this command… 
    shopt login_shell
  • Graphical Does Not Mean Interactive Some terminal programs like konsole do not start bash interactively. For konsole you will need to modify the profile. Here is the command to run bash interactively. ``` bash -l

```