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.
1.- Install dependences.
Galicaster requires the following software to be installed:
- Gstreamer
- python-setuptools and pip
- iCalendar
- pyCurl
- Capture card configuration tools
$ 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
In ubuntu 11.04 and above is recommended installing v4l-utils instead of ivtv-utils.
2.- Check configuration.
Launch the following commands from a shell to verify that all dependencies are installed:
$ 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
3.- Download software
Download the software from this site.
Uncompress it using tar:
$ tar xzf galicaster-1.0.0-rc.tgz $ cd galicaster-1.0.0-rc
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:
The values are in the file conf.ini:
Sections:
- basic
- repository: path to the working folder.
- admin: enables admin mode (True|False)
- Example:
[basic] repository = /mnt/videos/Repository admin = True
- screen
- right: Name of the video device in the [track list] to be shown in the right screen (None to deactivate).
- left: Name of the video device in the [track list] to be shown in the left screen (None to deactivate).
- cursor: Shows or hides the cursor. Util en la interfaz tactil de GClass (True|False)
- Example:
[screen] right = Epiphan left = Hauppagge cursor = True
- ingest
- The data to connect Galicaster to an Opencast-Matterhorn server.
- Example:
[ingest] active = True default = True username = matterhorn_system_account host = http://admin.matterhorn.es:8080 password = CHANGE_ME workflow = full
- trackN
- Entrada por cada dispositivo utilizado en el capturador. Pueden ser de diferentes tipos en funcion del valor de device: hauppauge, pulse, v4l2, vga2usb y mjpeg:
- hauppauge
- 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: Explicar y decir que es default
- loc2: Explicar y decir que es default
- loc3: Explicar y decir que es default
- file: The file name where the track will be recorded.
- active: Whether the device will be played and recorded. (True|False)
- 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:
[track1] name = Hauppagge loc2 = /dev/hauprevideo loc3 = /dev/haupreaudio location = /dev/haucamera file = CAMERA.mpg device = hauppage flavor = presenter active = False
- Values in hauppauge devices:
- pulse**** Values in audio (pulse) devices:***** 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:
$ pactl list | grep "Source" -A 5
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)***** 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:
[track1]name = Hauppaggeloc2 = /dev/hauprevideoloc3 = /dev/haupreaudiolocation = /dev/haucamerafile = CAMERA.mpgdevice = hauppageflavor = presenteractive = False [track2]name = Epiphanactive = Falselocation = /dev/screenfile = SCREEN.avidevice = vga2usbflavor = presentation [track3]amplification = 2.0name = AudioSourcevumeter = Activelocation = alsa_input.usb-046d_081d_96D1FD90-00-U0x46d0x81d.analog-monofile = sound.mp3device = pulseflavor = presenteractive = Falseplaying = False [track4]name = Webcamvideocrop-left = 160videocrop-right = 160caps = image/jpeg,framerate=25/1,width=1280,height=720active = Falselocation = /dev/webcamfile = CAMERA.avidevice = mjpegflavor = presenter
*** pulse
- Values in audio (pulse) devices:
- 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:
$ pactl list | grep "Source" -A 5
and use "Name:" as the location field.
- For PulseAudio devices run:
- file: The file name where the track will be recorded.
- active: Whether the device will be played and recorded. (True|False)
- 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:
[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
- Values in audio (pulse) devices:
- pulse
- Values in audio (pulse) devices:
- 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:
$ pactl list | grep "Source" -A 5
and use "Name:" as the location field.
- For PulseAudio devices run:
- file: The file name where the track will be recorded.
- active: Whether the device will be played and recorded. (True|False)
- 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:
[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
- Values in audio (pulse) devices:
- pulse
- Values in audio (pulse) devices:
- 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:
$ pactl list | grep "Source" -A 5
and use "Name:" as the location field.
- For PulseAudio devices run:
- file: The file name where the track will be recorded.
- active: Whether the device will be played and recorded. (True|False)
- 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:
[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
- Values in audio (pulse) devices:
- hauppauge
- Entrada por cada dispositivo utilizado en el capturador. Pueden ser de diferentes tipos en funcion del valor de device: hauppauge, pulse, v4l2, vga2usb y mjpeg:
5.- Running
Galicaster Class is launched with the command:
$ ./classexec
In the F.A.Q. section you can see some common questions about Galicaster.