This repository is the master repository for Ring. It contains a build script, make-ring.py, that can be used to build and install ring from source on different platforms.

More documentation can be found on http://docs.ring.cx. You may also build the documentation with make docs. The documentation will be built in docs/build/html.

The Ring installer uses python3. Please make sure it is installed before running it.

./make-ring.py --init

1. Build and install all the dependencies:

./make-ring.py --dependencies

Your distribution's package manager will be used.

2. Build and install locally under this repository:

./make-ring.py --install

3. Run daemon and client that were installed locally:

./make-ring.py --run

You can then stop the processes with CTRL-C.

You can also run them in the background with the --background argument and then use the --stop command to stop them. Stdout and stderr go to daemon.log and client-gnome.log.

./make-ring.py --install --global-install

Run global install:

gnome-ring

This already starts the daemon automatically for us.

Uninstall the global install:

./make-ring.py --uninstall

You need to setup Homebrew (<http://brew.sh/>) since their is no built-in package manager on OSX.

Build and install all the dependencies:

./make-ring.py --dependencies

Build and install locally under this repository:

./make-ring.py --install

You can find the .app file in the ./install/client-macosx folder.

Please make sure you have the Android SDK and NDK installed, and that their paths are properly set. For further information, please visit <https://github.com/savoirfairelinux/ring-client-android>

Build and install locally under this repository:

./make-ring.py --install --distribution=Android

You can find the .apk file in the ./client-android/ring-android/app/build/outputs