Installation instructions

There are at least four possible ways to install and set up Algernon. Choose the appropriate method for your operating system and how you prefer to install applications.

OS X (App Store)

There is a user-friendly launcher application available for OS X. Just install the Algernon tray launcher from App Store. Drag a shortcut from Programs to the Dock if you wish to have a quick way to start Algernon later on.

OS X (Homebrew)

Install Homebrew if needed, from http://brew.sh/, then run:

brew install algernon

Windows (64-bit)

Download this zip file and extract it to C:\Program Files\Algernon\. Add the directory to the system PATH for easy execution from the Command Prompt or PowerShell.

algernon --version should output Algernon followed by the current version number.

Arch Linux (AUR)

Install the algernon package with your favorite AUR-helper.

Using go get on OS X or Linux

Installation

First install go and make sure that $GOPATH is set to for instance ~/goprojects or ~/go. Add $GOPATH/bin to your $PATH.

When go is properly set up, you can install Algernon as a user with just:

go get github.com/xyproto/algernon

If you wish to install algernon system-wide after having downloaded and built it with go get, this command should do the trick:

sudo install -Dm755 "$GOPATH/bin/algernon" /usr/bin/algernon

Confirming that Algernon is installed

  • If you installed Algernon from App Store, just launch the application from the Dock. A status icon should appear in the menu line at the top.

  • If you use the command line, algernon --version should output Algernon followed by the current version number.