[xiph-commits] r3911 - arkaiv/trunk

[dcrowdy at svn.annodex.net]

Author: dcrowdy
Date: 2009-05-02 01:01:01 -0700 (Sat, 02 May 2009)
New Revision: 3911

Modified:
   arkaiv/trunk/README.txt
Log:
Updated readme and install info as things have changed a fair bit.


Modified: arkaiv/trunk/README.txt
===================================================================
--- arkaiv/trunk/README.txt	2009-04-24 03:24:03 UTC (rev 3910)
+++ arkaiv/trunk/README.txt	2009-05-02 08:01:01 UTC (rev 3911)
@@ -4,7 +4,8 @@
 A web based application for building, annotating and accessing archives of
 audio and video media.
 
-The name is pronounced "archive".
+The name is pronounced "archive" (it uses Melanesia Tok Pisin orthography as it
+was originally developed for research with Melanesian music).
 
 REQUIREMENTS
 ============
@@ -21,31 +22,50 @@
 liboggz
 libfishsound
 liboggplay
-mod_annodex (only tested with mod_annodex-ap20 so far)
 
-All of these should be installed from svn, so for libannodex, for example:
+Some of this is in a git repository, and some subversion.
 
+Install liboggz, liboggplay and libfishsound from git; see
+http://blog.kfish.org/2009/04/liboggplay-liboggz-libfishsound.html
+
+Install as follows:
+
+git clone git://git.xiph.org/liboggz.git
+git clone git://git.xiph.org/libfishsound.git
+git clone git://git.xiph.org/liboggplay.git
+
+
+The others can be retrieved from the annodex svn repository, so:
+
 svn co http://svn.annodex.net/libannodex
+svn co http://svn.annodex.net/libcmml
 
 Then move into the libannodex/trunk directory and follow the install
 instructions (./configure, make, make install)
 
 3. Pylons and associated middleware
 
-Pylons 0.9.6.1
-SQLAlchemy 0.4
+The instructions to get Pylons working are at:
+http://pylonshq.com/docs/en/0.9.7/gettingstarted/#installing
 
-All things pylons can be found at: http://pylonshq.com/ and info about
-installation is at
-http://wiki.pylonshq.com/display/pylonsdocs/Installing+Pylons.
+That didn't work at all for me, but this did:
 
-The best way to install these is using the easy_install script.  Note that I
-haven't tested the app with later versions of these.
+sudo easy_install Pylons
 
+SQLAlchemy is also needed:
+
+sudo easy_install SQLAlchemy
+
+Then try this test:
+paster create -t pylons helloworld
+paster serve --reload development.ini
+And point browser to http://127.0.0.1:5000 and get a welcome pylons page.
+
+
 INSTALLATION OF ARKAIV
 ======================
 
-Only tested under linux (Ubuntu Feisty and Gutsy) so far.
+Only tested under linux (Ubuntu Intrepid Ibex and Jaunty Jackalope) so far.
 
 Unpack the tarball, enter the directory, and edit production.ini to suit your
 environment.  At the moment the media files are kept in /var/www/arkaiv, so
@@ -64,7 +84,14 @@
 
 Point your browser at http://localhost:5000/page/mainpage
 
+That will get the application running, but the server that serves the media
+should be running oggz-chop to serve ogg files.  Information on setting this up
+is in the liboggz directory.  
 
+You need to use firefox 3.5 to access the application, as we now use the new
+html5 <video> and <audio> tags for playing ogg files natively within the
+browser.
+
 GENERAL INFO
 ============