|
Key
This line was removed.
This word was removed. This word was added.
This line was added.
|
Changes (42)
View Page History{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.
The installation process consists of five steps: installing dependencies, checking configuration, downloading software, configuring and running.
Before starting the installation process, please make sure that:
* Your equipment meets Galicaster's [Hardware Recommendations|1.1 Hardware recommendations].
* You are running a Linux-based OS. The recommended distribution is [Ubuntu 10.10|http://es.archive.ubuntu.com/cdimage/releases/10.10/release/] .
* Your capture devices are configured as indicated in the [Cookbook|1.1 Cookbook].
* Your equipment meets Galicaster's [Hardware Recommendations|1.1 Hardware recommendations].
* You are running a Linux-based OS. The recommended distribution is [Ubuntu 10.10|http://es.archive.ubuntu.com/cdimage/releases/10.10/release/] .
* Your capture devices are configured as indicated in the [Cookbook|1.1 Cookbook].
h6. 1.\- Install dependences.
The installation process consists of six steps: [installing dependencies|#dependences], [checking the configuration|#check], [downloading software|#download], [configuring Galicaster|#config], [checking the connection to a Matterhorn core|#matterhorn] and [testing it|#running].
{anchor:dependences}
h6. 1.\- Install dependencies.
h6. 1.\- Install dependencies.
Galicaster requires the following software to be installed:
* Gstreamer
* python-setuptools and pip
* Gstreamer
* python-setuptools and pip
* iCalendar 2.2 version
* pyCurl
* Capture card configuration tools
* Capture card configuration tools
In ubuntu 11.04 and above, installing v4l-utils is recommended instead of ivtv-utils.
{code:none}
$ sudo apt-get install \
$ sudo apt-get install \
...
gstreamer0.10-ffmpeg gstreamer0.10-alsa gstreamer0.10-plugins-bad gstreamer0.10-plugins-bad-multiverse \ gstreamer0.10-plugins-ugly gstreamer0.10-plugins-ugly-multiverse
$ sudo apt-get install python-pip python-setuptools
$ sudo apt-get install python-pip python-setuptools
$ sudo pip install icalendar==2.2
$ sudo apt-get install python-pycurl
$ sudo apt-get install v4l-conf ivtv-utils guvcview
{code}
$ 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.
{anchor:check}
h6. 2.\- Check configuration.
Launch Run the following commands from in a shell in order to verify that all dependencies are installed:
{code:none}
...{code}
{anchor:download}
h6. 3.\- Download software
Download the software from [this site|http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.0.0-rc.tgz].
*By downloading, you agree to the* *[non-commercial license|http://creativecommons.org/licenses/by-nc-sa/3.0/]**. (Commercial licenses also available under request)* *[!http://i.creativecommons.org/l/by-nc-sa/3.0/80x15.png|width=80!|http://creativecommons.org/licenses/by-nc-sa/3.0/]*
Download the software from [this site|http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.0.1.tgz].
Uncompress it using tar:
{code}
{code}
$ wget http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.0.0.tgz
$ tar xzf galicaster-1.0.0-rc.tgz
$ cd galicaster-1.0.0-rc
{code}
{anchor:config}
h6. 4.\- Configure Galicaster
h6. 4.\- Configure Galicaster
Galicaster configuration is in the file {{conf.ini}}. All the application parameters can be set up in this file, such as:
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]
* [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]
* Operation mode of the application: I.e. whether Galicaster will work as [Galicaster Class|Galicaster:Galicaster Class], designed to be used in a classroom environment, or as [Galicaster Mobile|Galicaster Mobile], a portable recording station.
* Devices used in the capturer, and their configuration.
* Server information to ingest.
* User privileges to control the recorder.
* Devices used in the capturer, and their configuration.
* Server information to ingest.
* User privileges to control the recorder.
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:
* Operation mode [Galicaster Class|Galicaster:Galicaster Class]:
** [Video Capture Card configuration|1.1 Hardware recommendations#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau_class/conf.ini]
** [WebCam USB configuraion|1.1 Hardware recommendations#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam_class/conf.ini]
* Operation mode [Galicaster Mobile|Galicaster Mobile]:
** [Video Capture Card configuration|1.1 Hardware recommendations#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau_mobile/conf.ini]
** [WebCam USB configuraion|1.1 Hardware recommendations#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam_mobile/conf.ini]
* Operation mode [Galicaster Class|Galicaster:Galicaster Class]:
** [Video Capture Card configuration|1.1 Hardware recommendations#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau_class/conf.ini]
** [WebCam USB configuraion|1.1 Hardware recommendations#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam_class/conf.ini]
* Operation mode [Galicaster Mobile|Galicaster Mobile]:
** [Video Capture Card configuration|1.1 Hardware recommendations#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau_mobile/conf.ini]
** [WebCam USB configuraion|1.1 Hardware recommendations#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam_mobile/conf.ini]
In the Section [1.0.x Galicaster Configuration] you will find a description of all section of {{conf.ini}} file.
{anchor:matterhorn}
The values are in the file {{conf.ini}}:
h6. 5.\- Opencast Matterhorn Connection
One of the key features of Galicaster is the connection to the publishing platform. If you are using Matterhorn as your media publishing and distribution system, you need to configure Galicaster to work as a Capture Agent and connect it to your core machine. Here are some tips to do so:
Sections:
* Your Galicaster unit needs access to your Matterhorn Core network.
* Use a valid *host* URL. It may be a fully-qualified name or simply an IP address.
* If your Matterhorn Core is not running in the default port (80), then you need to explicitly include it in the URL (i.e. {{http://<host_name_or_ip>:8080}}).
* The use of the {{http://}} prefix is mandatory.
* You need to use a Matterhorn account which authenticates via Digest (usually, this account is set up in the {{config.properties}} file in your Matterhorn server). A regular account will not work.
* Remember to activate the connection in Galicaster (in the configuration file, section {{ingest}}, value {{active}}).
* A wrong workflow will raise an error in Matterhorn. Please make sure you use a workflow name that exists in the machine you connect Galicaster to.
* Check your Galicaster unit is registered as a Capture Agent in the Admin Tools section of your Matterhorn installation.
** The log (in {{/tmp/galicaster.log}}) will record any problem occurring on the connection to the Matterhorn server.
* Use a valid *host* URL. It may be a fully-qualified name or simply an IP address.
* If your Matterhorn Core is not running in the default port (80), then you need to explicitly include it in the URL (i.e. {{http://<host_name_or_ip>:8080}}).
* The use of the {{http://}} prefix is mandatory.
* You need to use a Matterhorn account which authenticates via Digest (usually, this account is set up in the {{config.properties}} file in your Matterhorn server). A regular account will not work.
* Remember to activate the connection in Galicaster (in the configuration file, section {{ingest}}, value {{active}}).
* A wrong workflow will raise an error in Matterhorn. Please make sure you use a workflow name that exists in the machine you connect Galicaster to.
* Check your Galicaster unit is registered as a Capture Agent in the Admin Tools section of your Matterhorn installation.
** The log (in {{/tmp/galicaster.log}}) will record any problem occurring on the connection to the Matterhorn server.
{anchor:config_basic}
* {{basic}}
** {{repository}}: path to the working folder.
** {{admin}}: enables admin mode (True\|False)
** Example:
{code:none}
[basic]
repository = /mnt/videos/Repository
admin = True
{code}
* {{basic}}
** {{repository}}: path to the working folder.
** {{admin}}: enables admin mode (True\|False)
** Example:
{code:none}
[basic]
repository = /mnt/videos/Repository
admin = True
{code}
If your Galicaster is registered as a Capture Agent you should be able to receive the recording schedule, if any, and ingest any recordings in Galicaster to the Matterhorn Core. If this is not so, please review all the steps above and try again. The logs in Matterhorn and Galicaster will give you the hints to know what is failing.
{anchor:config_screen}
* {{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}
* {{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} {anchor:running}
* {{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}
** 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}
* {{trackN}}
** {color:red}Entrada por cada dispositivo utilizado en el capturador. Pueden ser de diferentes tipos en funcion del valor de{color} {color:red}{{{}device{}}}{color}{color:red}: hauppauge, pulse, v4l2, vga2usb y mjpeg{color}:
*** *hauppauge*: Audio and Video device.
**** Values in hauppauge devices:
***** {{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
***** {{loc2}}: Device's mount point of the RAW output
***** {{loc3}}: 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
loc2 = /dev/hauprevideo
loc3 = /dev/haupreaudio
location = /dev/haucamera
file = CAMERA.mpg
device = hauppage
flavor = presenter
active = False
{code}
*** *pulse*: Audio device.
**** Values in audio (pulse) devices:
***** {{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}
*** *mjpeg*: Video device
**** Values in mjpeg devices:
***** {{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}}
**** Example:
{code:none}
[track4]
name = Webcam
location = /dev/webcam
file = WEBCAM.avi
device = mjpeg
flavor = presenter
active = False
caps = image/jpeg,framerate=25/1,width=1280,height=720
videocrop-left = 160
videocrop-right = 160
{code}
*** *vga2usb*: Video device
**** Values in vga2usb devices:
***** {{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
* {{trackN}}
** {color:red}Entrada por cada dispositivo utilizado en el capturador. Pueden ser de diferentes tipos en funcion del valor de{color} {color:red}{{{}device{}}}{color}{color:red}: hauppauge, pulse, v4l2, vga2usb y mjpeg{color}:
*** *hauppauge*: Audio and Video device.
**** Values in hauppauge devices:
***** {{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
***** {{loc2}}: Device's mount point of the RAW output
***** {{loc3}}: 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
loc2 = /dev/hauprevideo
loc3 = /dev/haupreaudio
location = /dev/haucamera
file = CAMERA.mpg
device = hauppage
flavor = presenter
active = False
{code}
*** *pulse*: Audio device.
**** Values in audio (pulse) devices:
***** {{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}
*** *mjpeg*: Video device
**** Values in mjpeg devices:
***** {{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}}
**** Example:
{code:none}
[track4]
name = Webcam
location = /dev/webcam
file = WEBCAM.avi
device = mjpeg
flavor = presenter
active = False
caps = image/jpeg,framerate=25/1,width=1280,height=720
videocrop-left = 160
videocrop-right = 160
{code}
*** *vga2usb*: Video device
**** Values in vga2usb devices:
***** {{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
h6. 6.\- Run Galicaster
{code}
h6. 5.\- Running
h6. 5.\- Running
Galicaster Class is launched with the command:
{code:none}
{code:none}
$ ./classexec ./run_galicaster.py
{code}
In the [F.A.Q.|Galicaster:FAQ] section you can see some common questions about Galicaster.
The [1.1 User Guide] section contains Galicaster's user manual. Should you have any questions, please visit the [F.A.Q.|1.1 FAQ] section where some common questions are already answered.