{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 dependencies.
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, installing v4l-utils is recommended 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-rc1.tgz].
Uncompress it using tar:
{code}
$ tar xzf galicaster-1.0.0-rc1.tgz
$ cd galicaster-1.0.0-rc1
{code}
{anchor:config}
h6. 4.\- Configure Galicaster
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|Hardware recommendations#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau/conf.ini]
* [WebCam USB configuraion|Hardware recommendations#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam/conf.ini]
This is the structure of the {{conf.ini}} file:
{anchor:config_basic}
* Section {{basic}}
** {{repository}}: absolute path to the working folder. If not specified, a {{Repository}} directory in the user's home will be used.
** {{admin}}: enables admin mode (True\|False)
*** *False*: By default, the user will only be allowed to make recordings. Galicaster will operate as a [GClass|Galicaster:Galicaster Class]
*** *True*: Apart from recording, the user can edit metadata, play and manage the recordings. Galicaster will behave as a [GMobile|Galicaster:Galicaster Mobile]
** Example:
{code:none}
[basic]
repository = /mnt/videos/Repository
admin = True
{code}
{anchor:config_screen}
* Section {{screen}}
** {{right}}: Name of the video device in the [track list|#config_track] to be shown in the right screen (None to deactivate).
** {{left}}: Name of the video device in the [track list|#config_track] to be shown in the left screen (None to deactivate).
** {{cursor}}: Shows or hides the pointe. Useful if using a tactile screen (True\|False)
** Example:
{code:none}
[screen]
right = Epiphan
left = Hauppagge
cursor = True
{code}
{anchor:config_ingest}
* Section {{ingest}}
** The data to connect Galicaster to an Opencast-Matterhorn server.
** Example:
{code:none}
[ingest]
active = True
default = True
username = matterhorn_system_account
host = http://admin.matterhorn.es:8080
password = CHANGE_ME
workflow = full
{code}
{anchor:config_track}
* Section {{trackN}}
** A section for each device used in the capturer. Each section is set according to the device type: {{hauppauge}}, {{pulse}}, {{v4l2}} or {{vga2usb}}:
*** *hauppauge*: Audio and Video device.
**** Admitted values:
***** {{name}}: Name assigned to the device.
***** {{device}}: Device type: hauppage
***** {{flavor}}: Matterhorn "flavor" associated to the track. (presenter\|presentation\|other)
***** {{location}}: Device's mount point of the MPEG output
***** {{locprevideo}}: Device's mount point of the RAW output
***** {{locpreaudio}}: Device's mount point of the PCM output
***** {{file}}: The file name where the track will be recorded.
***** {{active}}: Whether the device will be played and recorded. (True\|False)
**** Example:
{code:none}
[track1]
name = Hauppagge
location = /dev/haucamera
locpreavideo = /dev/hauprevideo
locpreaudio = /dev/haupreaudio
file = CAMERA.mpg
device = hauppage
flavor = presenter
active = False
{code}
*** *pulse*: Audio device.
**** Admitted values:
***** {{name}}: Name assigned to the device.
***** {{device}}: Device type: pulse
***** {{flavor}}: Matterhorn "flavor" associated to the track. (presenter\|presentation\|other)
***** {{location}}: PulseAudio source name. Use _default_ to select the same Input as the Sound Control
****** to list 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)
***** {{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}
[track3]
name = AudioSource
vumeter = Active
location = default
file = sound.mp3
device = pulse
flavor = presenter
active = False
amplification = 2.0
{code}
*** *v4l2*: Video device
**** Admitted values:
***** {{name}}: Name assigned to the device.
***** {{device}}: Device type: v4l2
***** {{flavor}}: Matterhorn "flavor" associated to the track. (presenter\|presentation\|other)
***** {{location}}: Device's mount point in the system (e.g. /dev/video0).
***** {{file}}: The file name where the track will be recorded.
***** {{active}}: Whether the device will be played and recorded. (True\|False)
***** {{caps: }} GStreamer cappabilities of the device (mimetype=video/TYPE, framerate=X/Y,width=A,height=B)
TYPE: (jpeg\|x-raw-int)
Use GVUCView tool to know wich capabilities are compatible with your device
For more information [http://pygstdocs.berlios.de/pygst-tutorial/capabilities.html|http://pygstdocs.berlios.de/pygst-tutorial/capabilities.html]
***** Videocrop: Margin in pixels to be cutted. Useful to set a 4:3 proportion on a HD webcam.{{videocrop-top}}, {{videocrop-bottom,}} {{videocrop-left, videocrop-right}} (optional).
**** Example:
{code:none}
[track4]
name = Webcam
location = /dev/webcam
file = WEBCAM.avi
device = v4l2
flavor = presenter
active = False
caps = image/jpeg,framerate=25/1,width=1280,height=720
videocrop-left = 160
videocrop-right = 160
{code}
*** *vga2usb*: Video device
**** Admitted values:
***** {{name}}: Name assigned to the device.
***** {{device}}: Device type: vga2usb
***** {{flavor}}: Matterhorn "flavor" associated to the track. (presenter\|presentation\|other)
***** {{location}}: Device's mount point in the system (e.g. /dev/video0).
***** {{file}}: The file name where the track will be recorded.
***** {{active}}: Whether the device will be played and recorded. (True\|False)
***** {{drivertype}}: Wheter the device use a v4l or a v4l2 interface to guarantee compatibility (v4l\|v4l2)
**** Example:
{code:none}
[track2]
name = Epiphan
active = True
location = /dev/screen
file = SCREEN.avi
device = vga2usb
flavor = presentation
drivertype = v4l
{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.
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 dependencies.
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, installing v4l-utils is recommended 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-rc1.tgz].
Uncompress it using tar:
{code}
$ tar xzf galicaster-1.0.0-rc1.tgz
$ cd galicaster-1.0.0-rc1
{code}
{anchor:config}
h6. 4.\- Configure Galicaster
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|Hardware recommendations#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau/conf.ini]
* [WebCam USB configuraion|Hardware recommendations#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam/conf.ini]
This is the structure of the {{conf.ini}} file:
{anchor:config_basic}
* Section {{basic}}
** {{repository}}: absolute path to the working folder. If not specified, a {{Repository}} directory in the user's home will be used.
** {{admin}}: enables admin mode (True\|False)
*** *False*: By default, the user will only be allowed to make recordings. Galicaster will operate as a [GClass|Galicaster:Galicaster Class]
*** *True*: Apart from recording, the user can edit metadata, play and manage the recordings. Galicaster will behave as a [GMobile|Galicaster:Galicaster Mobile]
** Example:
{code:none}
[basic]
repository = /mnt/videos/Repository
admin = True
{code}
{anchor:config_screen}
* Section {{screen}}
** {{right}}: Name of the video device in the [track list|#config_track] to be shown in the right screen (None to deactivate).
** {{left}}: Name of the video device in the [track list|#config_track] to be shown in the left screen (None to deactivate).
** {{cursor}}: Shows or hides the pointe. Useful if using a tactile screen (True\|False)
** Example:
{code:none}
[screen]
right = Epiphan
left = Hauppagge
cursor = True
{code}
{anchor:config_ingest}
* Section {{ingest}}
** The data to connect Galicaster to an Opencast-Matterhorn server.
** Example:
{code:none}
[ingest]
active = True
default = True
username = matterhorn_system_account
host = http://admin.matterhorn.es:8080
password = CHANGE_ME
workflow = full
{code}
{anchor:config_track}
* Section {{trackN}}
** A section for each device used in the capturer. Each section is set according to the device type: {{hauppauge}}, {{pulse}}, {{v4l2}} or {{vga2usb}}:
*** *hauppauge*: Audio and Video device.
**** Admitted values:
***** {{name}}: Name assigned to the device.
***** {{device}}: Device type: hauppage
***** {{flavor}}: Matterhorn "flavor" associated to the track. (presenter\|presentation\|other)
***** {{location}}: Device's mount point of the MPEG output
***** {{locprevideo}}: Device's mount point of the RAW output
***** {{locpreaudio}}: Device's mount point of the PCM output
***** {{file}}: The file name where the track will be recorded.
***** {{active}}: Whether the device will be played and recorded. (True\|False)
**** Example:
{code:none}
[track1]
name = Hauppagge
location = /dev/haucamera
locpreavideo = /dev/hauprevideo
locpreaudio = /dev/haupreaudio
file = CAMERA.mpg
device = hauppage
flavor = presenter
active = False
{code}
*** *pulse*: Audio device.
**** Admitted values:
***** {{name}}: Name assigned to the device.
***** {{device}}: Device type: pulse
***** {{flavor}}: Matterhorn "flavor" associated to the track. (presenter\|presentation\|other)
***** {{location}}: PulseAudio source name. Use _default_ to select the same Input as the Sound Control
****** to list 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)
***** {{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}
[track3]
name = AudioSource
vumeter = Active
location = default
file = sound.mp3
device = pulse
flavor = presenter
active = False
amplification = 2.0
{code}
*** *v4l2*: Video device
**** Admitted values:
***** {{name}}: Name assigned to the device.
***** {{device}}: Device type: v4l2
***** {{flavor}}: Matterhorn "flavor" associated to the track. (presenter\|presentation\|other)
***** {{location}}: Device's mount point in the system (e.g. /dev/video0).
***** {{file}}: The file name where the track will be recorded.
***** {{active}}: Whether the device will be played and recorded. (True\|False)
***** {{caps: }} GStreamer cappabilities of the device (mimetype=video/TYPE, framerate=X/Y,width=A,height=B)
TYPE: (jpeg\|x-raw-int)
Use GVUCView tool to know wich capabilities are compatible with your device
For more information [http://pygstdocs.berlios.de/pygst-tutorial/capabilities.html|http://pygstdocs.berlios.de/pygst-tutorial/capabilities.html]
***** Videocrop: Margin in pixels to be cutted. Useful to set a 4:3 proportion on a HD webcam.{{videocrop-top}}, {{videocrop-bottom,}} {{videocrop-left, videocrop-right}} (optional).
**** Example:
{code:none}
[track4]
name = Webcam
location = /dev/webcam
file = WEBCAM.avi
device = v4l2
flavor = presenter
active = False
caps = image/jpeg,framerate=25/1,width=1280,height=720
videocrop-left = 160
videocrop-right = 160
{code}
*** *vga2usb*: Video device
**** Admitted values:
***** {{name}}: Name assigned to the device.
***** {{device}}: Device type: vga2usb
***** {{flavor}}: Matterhorn "flavor" associated to the track. (presenter\|presentation\|other)
***** {{location}}: Device's mount point in the system (e.g. /dev/video0).
***** {{file}}: The file name where the track will be recorded.
***** {{active}}: Whether the device will be played and recorded. (True\|False)
***** {{drivertype}}: Wheter the device use a v4l or a v4l2 interface to guarantee compatibility (v4l\|v4l2)
**** Example:
{code:none}
[track2]
name = Epiphan
active = True
location = /dev/screen
file = SCREEN.avi
device = vga2usb
flavor = presentation
drivertype = v4l
{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.