Porting to gst1.0

.gitignore

@@ -66,13 +66,7 @@ doc/reference/html/
 
 # Ignore external command
 flumotion/extern/command.revision
-flumotion/extern/command/ChangeLog
-flumotion/extern/command/README
-flumotion/extern/command/__init__.py
-flumotion/extern/command/command.py
-flumotion/extern/command/help2man.py
-flumotion/extern/command/manholecmd.py
-flumotion/extern/command/test_command.py
+flumotion/extern/command/*
 
 # Misc ignores
 data/flumotion-admin.desktop

.gitmodules

@@ -1,3 +1,3 @@
 [submodule "common"]
 	path = common
-	url = git://code.flumotion.com/flumotion-common.git
+	url = https://github.com/Flumotion/flumotion-common.git

.travis.yml

@@ -0,0 +1,33 @@
+language: python
+python:
+  - "2.7"
+virtualenv:
+  system_site_packages: true
+# installing missing packages
+before_install:
+ - sudo add-apt-repository ppa:gstreamer-developers/ppa -y
+ - sudo apt-get update -qq
+ - "export DISPLAY=:99.0"
+ - "sh -e /etc/init.d/xvfb start"
+install:
+ - sudo apt-get install -qq subversion autopoint python-gst0.10 gstreamer0.10* python-gi python3-gi python-gobject-dev gstreamer1.0* gir1.2-gstreamer-1.0 gir1.2-gst-plugins-base-1.0 libglib2.0-dev gir1.2-glib-2.0 libgirepository1.0-dev libglib2.0-0 gir1.2-gtk-3 libxml-parser-perl python-twisted python-gtk2 python-glade2 python-kiwi pkg-config libglib2.0-dev liborc-0.4-dev bison flex
+ - sudo pip install icalendar==2.2 pyparsing python-dateutil
+ - wget https://launchpadlibrarian.net/170386464/gst-python1.0_1.2.0.orig.tar.gz
+ - tar xvzf gst-python1.0_1.2.0.orig.tar.gz
+ - cd gst-python-1.2.0/
+ - ./configure
+ - make
+ - sudo make install
+ - cd ..
+# command to run tests
+script:
+ - ./autogen.sh
+ - make
+ - ./run_tests.sh
+# specified which branches to test
+branches:
+  only:
+    - porting-to-gst1.0
+# parallelizing the builds
+env:
+ - TEST_TYPE=test

README

@@ -1,129 +1,122 @@
-Flumotion - your streaming media server
+Flumotion - Your streaming media server
+=======================================
 
-WHAT IT IS
-----------
+[![Build Status](https://travis-ci.org/aps-sids/flumotion-orig.svg?branch=porting-to-gst1.0)](https://travis-ci.org/aps-sids/flumotion-orig)
 
 Flumotion is a streaming media server based on GStreamer and Twisted.
 
-This is the first public development series of Flumotion.
-It will probably still contain bugs, be difficult to install (since
-you need recent dependencies), and cause you some headaches.
+This is the first public development series of **Flumotion ported to Gstreamer 1.x API**.
+It is still a **work in progress** and will probably still contain bugs, be difficult to install (since some parts still need to be ported), and cause you some headaches.
 
 On the other hand, when it works and you are capturing your Firewire camera
 on one machine, encoding to Theora on a second (with an overlay, of course),
 encoding the audio to Vorbis on a third, muxing to Ogg on a fourth, and then
 streaming both audio and video from a fifth, audio only from a sixth,
 video only from a seventh, and capturing all three streams to disk from
-an eigth, you feel very good about yourself.
+an eighth, you feel very good about yourself.
 
 And you also have too many computers.
 
-REQUIREMENTS
+Requirements
 ------------
 
-You need:
+* Gstreamer 1.2.4 or higher
+* Gstreamer plugins - good, bad and ugly
+* Python bindings GObject Introspection Libraries
+* Twisted 13 or higher
+* and some other python packages
 
-Gstreamer: you need GStreamer version 0.10.10 or higher. 0.10.11 or higher is
-strongly recommended.
+**Note:** You might have to use Gstreamer Developers PPA to get the latest packages
 
-For 0.10.x:
-  GStreamer: 0.10.10 or higher
-  GStreamer plugins base 0.10.10 or higher
-  GStreamer plugins good 0.10.1 or higher
-  GStreamer python bindings 0.10.1 or higher
+To install system requirements on Ubuntu, run follow commands:
 
-PyGTK - 2.8.3 or higher
-Python - 2.4 or higher
-Twisted - 2.5.0 or higher
-Kiwi - 1.9.13 or higher
-PyCairo- 1.2.0 or higher
+```bash
+$ sudo add-apt-repository ppa:gstreamer-developers/ppa
+$ sudo apt-get update
+$ sudo apt-get install libtool autopoint autoconf libxml-parser-perl python-gi python-gobject-dev python-gst-1.0 gir1.2-gstreamer-1.0 gir1.2-gst-plugins-base-1.0 libglib2.0-dev gir1.2-glib-2.0 libgirepository1.0-dev libglib2.0-0 gir1.2-gtk-3 pkg-config libglib2.0-dev liborc-0.4-dev python-twisted python-pyparsing python-kiwi python-dateutil
+
+# we can't use latest python-icalendar till a few things are fixed
+
+$ sudo pip install icalendar==2.2
+```
 
 And depending on what codecs you want to use:
 
-libvorbis 1.0.1 or higher
-libogg 1.1 or higher
-libtheora 1.0alpha3 or higher
+* libvorbis 1.0.1 or higher
+* libogg 1.1 or higher
+* libtheora 1.0alpha3 or higher
 
 And if you want to build documentation:
 
-epydoc
+* epydoc
 
 And if you want support for java applets:
 
-cortado
+* cortado
 
-ISSUES
-------
+Quick Start
+-----------
 
-Some issues have been brought to our attention.  Please take note if you
-run into them:
-- locales with a comma as a decimal point trigger problems in the XML parsing.
-  Run with LANG=C if you run into this
-- When encoding to Vorbis, prefer to use quality instead of absolute bitrate.
-  For absolute bitrate, for each sample rate a limited range of bitrates is
-  allowed.
-- You may see memory leaks if you use the soundcard or firewire source
-  components, and you use PyGTK prior to 0.8.5, or gst-python prior to 0.10.3,
-  so upgrading to these versions is strongly recommended.
-
-A FIRST TEST
-------------
+```bash
+# Build source
+$ ./autogen.sh
+$ make
 
-Once everything is built and installed,
-you can try this to start the server:
+# To run the tests
+$ ./run_tests.sh
 
-terminal 1:
-  flumotion-manager -v -T tcp conf/managers/default/planet.xml
+# in terminal 1
+$ ./env bash
+$ flumotion-manager -v -T tcp test_config.xml
 
-terminal 2:
-  flumotion-worker -v -T tcp -u user -p test
+# in terminal 2
+$ ./env bash
+$ flumotion-worker -v -T tcp -u user -p test
 
-terminal 3:
-  flumotion-admin
-  Unselect 'Secure connection via SSL', press Next, then enter "user" and
-  "test" in the dialog.
+# in terminal 3
+$ gst-launch playbin2 uri=http://localhost:8800/ogg-audio-video/
+```
 
-  Go through the wizard, chosing defaults.
+Some systems may not have `gst-launch`, but only `gst-launch-0.10` or `gst-launch-1.0`. In that case you can substitute either of those commands.
 
-  Double-click the http component after the wizard has completed
+Alternatively, you can use any theora-enabled network player or web browser to see the stream.
 
-terminal 4:
-  gst-launch playbin2 uri=http://localhost:8800/ogg-audio-video/
+```bash
+# in terminal 4
+$ for a in `seq 1 9`; do ( flumotion-tester http://localhost:8800/ogg-audio-video/ & ); done
+```
 
-  Some systems may not have gst-launch, but only gst-launch-0.8 or
-  gst-launch-0.10, in that case you can substitute either of those commands.
+This will throw 9 processes with 100 clients each at the server.  Hopefully, all of them will return success at the end of their run!
 
-  Alternatively, you can use any theora-enabled network player to see the
-  stream.
+We use 900 clients rather than a nice round number such as 1000 because, with a standard unix system, you'll usually be limited to slightly under 1000 clients by default due to limits on open file descriptors (each client requires a file descriptor). This limit is changeable, but it's simpler to just test with slightly fewer clients.
 
-terminal 5:
-  for a in `seq 1 9`; do ( flumotion-tester http://localhost:8800/ogg-audio-video/ & ); done
+Issues
+------
 
-  This will throw 9 processes with 100 clients each at the server.  Hopefully,
-  all of them will return success at the end of their run!
+Take a look at the Github issues. Please create any new issues you encounter.
 
-  We use 900 clients rather than a nice round number such as 1000 because, with
-  a standard unix system, you'll usually be limited to slightly under 1000
-  clients by default due to limits on open file descriptors (each client
-  requires a file descriptor). This limit is changable, but it's simpler to just
-  test with slightly fewer clients.
+Hacking
+-------
 
-DOCUMENTATION
--------------
+The user manual is available [here](http://www.flumotion.net/doc/flumotion/manual/en/trunk/html/), but it's probably outdated since currently there is no admin GUI to work with. Still, it might be helpful if you are new to Flumotion.
 
-A manual is being written.  You can access the current work in progress at
-http://www.flumotion.net/doc/flumotion/manual/en/trunk/html/
+The developer documentation is available [here](https://code.flumotion.com/trac/wiki/Documentation/DeveloperIntroduction). More information will be added as the work progresses.
 
-Flumotion also comes with API documentation.  You need epydoc to build them.
+Contributing
+------------
 
-HACKING
--------
+The project had been quite dead for a while. This port was done as a [GSoC 2014](https://www.google-melange.com/gsoc/homepage/google/gsoc2014) project under [TimVideos](http://code.timvideos.us/).
+
+You can subscribe to the official development list. Information is at
+http://lists.fluendo.com/mailman/listinfo/flumotion-devel
 
-You can use jhbuild with the flu.modules and jhbuildrc file provided in misc/
+You can visit us on IRC: [#fluendo](irc://irc.freenode.net/#fluendo) and [#timvideos](irc://irc.freenode.net/#timvideos) on irc.freenode.org
 
-This will set up everything except for Twisted for you from source.
+You can visit our trac installation for the Wiki, source browsing and
+ticket tracking:
+https://core.fluendo.com/flumotion/trac
 
-SECURITY
+Security
 --------
 
 Read the security chapter in the aforementioned manual to get started.
@@ -142,32 +135,12 @@ sure you change the configuration before moving it into production.
 Remove the host entry from the sample planet.xml file to allow other hosts
 to connect.
 
-ABOVE AND BEYOND
-----------------
-
-You can subscribe to our development list.  Information is at
-http://lists.fluendo.com/mailman/listinfo/flumotion-devel
-
-You can visit us on IRC: #fluendo on irc.freenode.org
-
-You can visit our trac installation for the Wiki, source browsing and
-ticket tracking:
-https://core.fluendo.com/flumotion/trac
-
-LICENSING
----------
+Licence
+-------
 
 This version of the Flumotion Streaming Server is licensed under the the
 terms of the GNU Lesser General Public License version 2.1 as published
 by the Free Software Foundation. See LICENSE.LGPL
 
 If the conditions of this licensing strategy are not clear to you, please
 contact Thomas Vander Stichele ([email protected]).
-
-TESTING
--------
-For testing purposes of your streams, you can run some GStreamer pipelines
-to verify if things work as they should.
-
-- multipart/jpeg stream (video only):
-  gst-launch -v gnomevfssrc location=http://localhost:8802 ! multipartdemux ! jpegdec ! xvimagesink