Introduction
============

sydra is a toolbox which allows you to set up multiple bidirectional
Video/Audio streams from external locations.
sydra has been written to be used for the Elevate Festival in Graz
Austria in order to involve external locations to present themselves
at the festival.

Sydra consists of several components:

sydra-rtp:
  This is the basic utility for the task which is based on GStreamer and is
  written in C.
  The utility creates a gstreamer pipeline to send or receive RTP-based
  Audio/Video streams. For a bidirectional connection 2 instances of sydra-rtp
  are required on both sides of the communication. sydra-rtp has automatic
  client detection capabilities in the form of keep alive messages.
  These message are sent out by receivers to request RTP packets from a sender.
  The sender will send RTP packets to one or more receivers which request
  the stream. It also uses the keep alive messages to remove stale client
  'connections'. A receiver can also request to be removed from the list of
  receivers. This ensures a fast and clean shutdown.
  The keepalive messages are also a simple way to work around NAT and
  firewalls (UDP hole punching).

tba...

Dependencies
============

Linux
-----

core:
 build-essential
 libgstreamer1.0-dev
 pkg-config

if you want to use clang as compiler
 clang

if you want to rebuild the manpage:
 asciidoc


Installation
============

Getting the source via GIT:
---------------------------

git clone git://git.spreadspace.org/sydra.git
cd sydra

Building from source
--------------------

# cd src
# ./configure
# make


Installing
----------

# sudo make install

This will install sydra under the --prefix defined with configure.


Uninstalling
------------

# sudo make remove