Software

{pop-away:metadata | comments | children | labels}


Galicaster is based on Open Source technologies.

The recommended OS for this release is Ubuntu 10.10
The installation process consists of five steps: installing dependencies, checking configuration, downloading software, configuring and running.

h6. 1.\- Install dependences.

Galicaster requires the following software to be installed:

* Gstreamer
* python-setuptools and pip
* iCalendar
* pyCurl
* Capture card configuration tools

{code:none}
$ sudo apt-get install \
gstreamer0.10-ffmpeg gstreamer0.10-alsa gstreamer0.10-plugins-bad gstreamer0.10-plugins-bad-multiverse \
gstreamer0.10-plugins-base gstreamer0.10-plugins-base-apps gstreamer0.10-plugins-good \
gstreamer0.10-plugins-ugly gstreamer0.10-plugins-ugly-multiverse
$ sudo apt-get install python-pip python-setuptools
$ sudo pip install icalendar
$ sudo apt-get install python-pycurl
$ sudo apt-get install v4l-conf ivtv-utils guvcview
{code}

In ubuntu 11.04 and above is recommended installing v4l-utils instead of ivtv-utils.

h6. 2.\- Check configuration.

Launch the following commands from a shell to verify that all dependencies are installed:

{code:none}
$ python --version
Python 2.6.6

$ python -c "import pygtk; pygtk.require('2.0')"
$ python -c "import pygst; pygst.require('0.10')"
$ python -c "import pycurl"
$ python -c "import icalendar"

$ gst-launch-0.10 videotestsrc num-buffers=25 ! video/x-raw-yuv,width=800,height=600,framerate=24/1 ! ffmpegcolorspace ! xvimagesink
$ gst-launch-0.10 videotestsrc num-buffers=25 ! video/x-raw-yuv,width=800,height=600,framerate=24/1 ! ffmpegcolorspace ! x264enc pass=5 quantizer=22 speed-preset=4 profile=1 ! queue ! avimux ! filesink location=out.avi
$ file out.avi
out.avi: RIFF (little-endian) data, AVI, 800 x 600, ~24 fps, video: H.264 X.264 or H.264
$ rm out.avi
{code}

h6. 3.\- Download software

Download the software from [this site|http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.0.0-rc.tgz].

Uncompress it using tar:

{code}
$ tar xzf galicaster-1.0.0-rc.tgz
$ cd galicaster-1.0.0-rc

Galicaster configuration is in the file {{conf.ini}}.

The simplest way to get started with Galicaster is dowloading any of the pre-existing conf.ini files for any of the reference configurations proposed:
* [Video Capture Card configuration|Galicaster:Hardware#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau/conf.ini]
* [WebCam USB configuraion|Galicaster:Hardware#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam/conf.ini]





The values are in the file {{conf.ini}}:

** {{admin}}: enables admin mode (True\|False)
** Example:
{code:none}
[basic]
repository = /mnt/videos/Repository
admin = True

[screen]
right = Epiphan
left = Hauppagge
cursor = True

** Example:
{code:none}
[ingest]
active = True
default = True
username = matterhorn_system_account
host = http://admin.matterhorn.es:8080
password = CHANGE_ME
workflow = full

*** {{name}}: Name assigned to the device.
*** {{device}}: Device type. (v4l2\|vga2usb\|webcam\|hauppage\|pulse)
*** {{flavor}}: Matterhorn "flavor" associated to the track. (presenter\|presentation\|other)
*** {{location}}: Device's mount point in the system (e.g. /dev/video0).
**** For PulseAudio devices run:
{code:none}
$ pactl list | grep "Source" -A 5
{code}
and use "Name:" as the {{location}} field.
*** {{file}}: The file name where the track will be recorded.
*** {{active}}: Whether the device will be played and recorded. (True\|False)
** Values in audio (pulse) devices:
*** {{playing}}: Indicates if the audio, apart from being recorded, is played. (True\|False)
*** {{vumeter}}: Activates data sending to the program's vumeter. (True\|False) Only one device should be activated.
*** {{amplification}}: Gstreamer amplification value: < 1 decreases and > 1 increases volume. Values between 1 and 2 are commonly used.
** Example:
{code:none}
[track1]
name = Hauppagge
loc2 = /dev/hauprevideo
loc3 = /dev/haupreaudio
location = /dev/haucamera
file = CAMERA.mpg
device = hauppage
flavor = presenter
active = False

[track2]
name = Epiphan
active = False
location = /dev/screen
file = SCREEN.avi
device = vga2usb
flavor = presentation

[track3]
amplification = 2.0
name = AudioSource
vumeter = Active
location = alsa_input.usb-046d_081d_96D1FD90-00-U0x46d0x81d.analog-mono
file = sound.mp3
device = pulse
flavor = presenter
active = False
playing = False

[track4]
name = Webcam
videocrop-left = 160
videocrop-right = 160
caps = image/jpeg,framerate=25/1,width=1280,height=720
active = False
location = /dev/webcam
file = CAMERA.avi
device = mjpeg
flavor = presenter
{code}

h6. 5.\- Running

Galicaster Class is launched with the command:

{code:none}
$ ./classexec
{code}


In the [F.A.Q.|Galicaster:FAQ] section you can see some common questions about Galicaster.