All-in-one Ring repository
Switch branches/tags
Clone or download
hlef oci: use .list format for source.list.d entry
Use .list format instead of .sources. This will allow for better
compatibility with the version from our APT repositories.

Change-Id: I18e1cca6fb9e0e6fa6fa62add0868ea133a37b29
Latest commit 6527954 Sep 18, 2018
Permalink
Failed to load latest commit information.
.cqfd cqfd: add android configuration Jan 6, 2017
client-android @ 59c28d0 build: Add support for Ubuntu 18.04. Apr 25, 2018
client-electron @ 395c112 add client-electron submodule Jun 9, 2017
client-gnome @ a3ae9fd build: Add support for Ubuntu 18.04. Apr 25, 2018
client-ios @ a68931d git: add ring-client-ios submodule Jul 8, 2016
client-macosx @ 812d550 setup submodules for version 1.0.0 Mar 17, 2016
client-uwp @ f15a122 add uwp client submodule Jan 30, 2017
client-windows @ 5fac25a setup submodules for version 1.0.0 Mar 17, 2016
daemon @ 36c6d85 build: Add support for Ubuntu 18.04. Apr 25, 2018
docker 17.10 EOL: remove old docker files Aug 17, 2018
docs fix spelling errors Jul 24, 2018
lrc @ 82f8718 build: Add support for Ubuntu 18.04. Apr 25, 2018
packaging oci: use .list format for source.list.d entry Sep 18, 2018
scripts packaging: different releases for website Aug 17, 2018
.dockerignore Add Debian and Ubuntu packaging Jul 20, 2016
.gitignore gitignore: ignore .docker-image-* Apr 25, 2017
.gitmodules add client-electron submodule Jun 9, 2017
.gitreview add .gitreview Feb 26, 2016
CONTRIBUTING.md docs: Fix contributing page URL. Dec 5, 2017
COPYING Add COPYING file (GPL-3+) Apr 4, 2016
Makefile.packaging packaging: different releases for website Aug 17, 2018
README.rst README: clarify make-ring init command Dec 4, 2017
clean-DATA-LOSS.sh Remove sudo from client install Jan 29, 2016
cqfd cqfd: add -d behaviour Jan 6, 2017
make-ring.py macOS: don't fail on brew error codes during install Aug 13, 2018

README.rst

ring-project

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.

Using make-ring

Dependencies

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

Initialize the repositories

./make-ring.py --init

It initializes and updates the submodules to set them at the top of their master branch. This is ideal to have the latest development version.

However, in order to build a specific version of Ring, such as the Production one, please use

git submodule update --init

On Linux

  1. Build and install all the dependencies:
./make-ring.py --dependencies

Your distribution's package manager will be used.

  1. Build and install locally under this repository:
./make-ring.py --install
  1. 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.

Install globally for all users instead

./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

On OSX

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

Output

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

On Android

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

Output

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