Intertac Code
Software for teachers to create playlists and reflective questions
Brought to you by:
ckutay
Menu
▾
▴
Tree [776b78] default tip / History
Cat Kutay<cat.kutay@gmail.com>
Read Me
WORKSHOP ======== A web based application for clipping, annotating and accessing archives of text, audio and video media. REQUIREMENTS ============ 1. The python build tools for your distribution. authkit PIL python-lxml sqlite3 Python gst (0.10) 1a. System tools you may need. lxml from apt-get or yum 2. Recent annodex libraries (see http://www.annodex.net): libcmml liboggz libfishsound liboggplay 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 Enter the trunk directory of each, run autogen.sh, ./configure, then make and make install. With liboggz, oggz-chop needs to be set up so that apache2 uses it to serve ogg files. Firstly enable actions with: sudo a2enmod actions Then run the apache-install.sh script (as root) and restart apache2. 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) NOTE: As of 2011, it is possible with Ubuntu to install these dependencies using the distro package manager. 3. Pylons and associated middleware The instructions to get Pylons working are at: http://pylonshq.com/docs/en/0.9.7/gettingstarted/#installing or 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 Intertac ====================== Tested under linux (Ubuntu) and windows Unpack the tarball, enter the directory, and edit production.ini to suit your environment. Change topic to the "topic" you are using and the media files are kept in /workshop/public/"topic", so you'll need to make sure that directory i exists, and that you have write permissions on it and it is a site accessible on the web (or whatever location you choose). At the moment the approach is to use the "paster" server rather than apache, but using Apache and the fastcgi module is possible. Then run: paster setup-app production.ini and to serve it: paster serve --reload production.ini Point your browser at http://localhost:5000/list/index 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 Chrome to access the application, as we now use the new html5 <video> and <audio> tags for playing webm files natively within the browser. GENERAL INFO ============ The media directory will contain .webm/.ogg/.mp3 files (the source media) and .cmml files with the same basename. In the particular approach I have taken here, the sql database is really only used for searching - the information is mirrored in the cmml files. There is an obvious disadvantage compared to cmmlwiki here in that the database could get out of sync with the cmml, but there is the advantage that an archive can be lifted by simply moving the cmml and ogg files, then pointing a new instance of the application at it. There is a function to import a directory full of cmml files with corresponding source files (the base names have to be identical at this stage) although it is pretty crude at the moment. Authors ======= Cat Kutay (Cat.Kutay@cse.unsw.edu.au), The University of New South Wales Denis Crowdy (Denis.Crowdy@mq.edu.au), Macquarie University. The original idea for this was suggested by Shane Stephens - I took it on out of interest and it became useful. Parts of the code in this distribution are modifications and paraphrasings of cmmlwiki code released under the BSD license by CSIRO Australia. The code in this distribution is released under the new BSD license, detailed in the file "COPYING".
