Getting Started

It only takes a few steps to get started with Vuvuzela:

1. Register your email address using the form on the right.

2. Install the Vuvuzela client (with Go 1.8+):

   $ go get -u vuvuzela.io/vuvuzela/cmd/vuvuzela-client
   $ vuvuzela-client -username [email protected]

3. Verify your email address by following the instructions in your email.
4. Add friends and start chatting.

These steps are covered in more detail below.

Install the Vuvuzela client

Vuvuzela is built on the Go language. To install the Vuvuzela client, you will need Go 1.8+. Some distros provide a convenient way to install a recent version of Go:

pacman -S go  # Arch Linux
brew install go  # Homebrew / OSX

Otherwise, download and install the official Go binaries. Ubuntu users have some more options. Verify that Go 1.8+ is installed:

$ go version
go version go1.9.2 linux/amd64

Configure your Go path in ~/.bashrc. You can skip this step, in which case the Vuvuzela client will be installed to ~/go/bin.

export GOPATH=~/go
export PATH=$GOPATH/bin:$PATH

Install the Vuvuzela client:

$ go get -u vuvuzela.io/vuvuzela/cmd/vuvuzela-client

You can rerun this command to update the client.

Finish creating your Vuvuzela account

Follow the instructions in your email to finish creating your Vuvuzela account. You'll have to run the /register command in your client with the token you receive in your email:

/register token

Add friends and start chatting

Send a friend request using the addfriend command:

/addfriend their_username

Your client will notify you when your friend accepts the request. The /list command lists your friends. Use the call command to start a conversation:

/call their_username

Their username will turn green when your friend answers the call; now you can start chatting!