Galicaster Class Installation Guide

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

{section}
{column:width=59%}

h2. Introduction

On this section you will be guided through a series of steps to finish the setup of your Galicaster Class unit. Please, read this documentation carefully and follow its instructions. In case of doubts please take advantage of the [Galicaster Community list|Galicaster:Community] to make any question or suggestion. If you have purchased this unit from [Teltek Video Research|http://teltek.es] contact us directly through the channels we've provided.

In the following sections you will receive instructions on how to connect and configure you Galicaster unit. Some of the sections may not affect you because of the hardware you've installed or the type of installation you made, so ignore them and focus on the ones that matters to you.
{column}
{column:width=38%}
{bgcolor:lightblue}
{center}

h2. Contents
{center}
* [A. Room installation|#room]
* [B. Cards and connectors|#cards]
* [C. Operative System setup|#ossetup]
** [Autostart|#start]
** [Shortcuts|#shortcuts]
** [Network configuration|#net]
* [D. Capture Devices configuration|#gcconf]
*# [Epiphan framegrabber|#epi]
*# [HD Webcam|#webcam]
*# [Hauppauge video-capturer|#hau]
*# [Blackmagic HD video-capture|#bm]
*# [Sound configuration|#sound]
* [E. Opencast Matterhorn related configuration|#mh]

\\
{bgcolor}
{column}
{section}

h4. A. Room installation
----

{section}
{column: 59 %}

There plenty of variations for a room to be equiped with Galicaster. On every step we will point out some recommendations and instructions to achieve the best solution to your needs.

h5. a. Place the rack

* Take into account the access to power supply, network and other wiring like usb.

h5. b. Place the screen

* The screen is usually installed over or in the lateral of the rack.
* Other locations are suitable, but never near the lecturer's computer because it can be confusing.
Place the camera
* The optimal position for the camera is 5m ahead of the wall - the one being recorded.
* It should be placed about 1.5 to 2 m height, in order to record people "face to face" and don't get in the view of the audience.
* Slides shouldn't be recorded by the camera
* Avoid any direct light pointing the camera

h5. c. Place the microphone
* The microphone is usually kept on the Rack itself.
* In case you want to place it on the desk, set a box to keep it and set a usb extension from the microphone to de rack

h5. d. Wire everything:
* There is commercial USB extensions cable up to 25m
* There is commercial VGA extensions cable up to 20m - in case a longer wire is necessary, UTP extensions are mandatory
* The laptop or desk computer is usually connected to the projector. The projector have a VGA passthrough which you can connect to the Galicater unit with a VGA extension.
** In other case set a VGA splitter to duplicate the output of the desk.

h5. e. Place warnings on the room and the unit:
* Remember the lecture to place the microphone back on its bay
* Inform the audience that it could be accidentally recorded

{column}
{column: 39 %}
!class_scheme.png|align=center,border=1,width=500,thumbnail!
{center}Click on the image to enlarge.{center}

!wiring.png|align=center,border=1,width=400,thumbnail!
{center}Simplified wiring.{center}

{column}
{section}

{anchor:cards}
h3. B. Cards and connectors
----
The Galicaster Mobile Unit comes equipped with different inputs to fulfil your needs on recording multistream material. Depending on the devices you are about to use you should combine those inputs properly.

There are two main combinations, depending on the type of camera (NTSC or SDI) you use to record the presenter. In both cases you have to use a VGA grabber to record the slides. Those combinations will be explained briefly on the next two sections.

Please, take a closer look to the image to identify the ports of each capture card before connecting anything.
{section}
{column: 59 %}

h5. a.Graphics card

|| \# || Port || Description ||
| A1 | *VGA output* | To connect the monitor of the computer. |
| A2 | *HDMI output* | To connect the monitor of the computer. |
| A3 | *DVI output* | To connect the monitor of the computer. |


h5. b.Epiphan card

|| \# || Port || Description ||
| B1 | *VGA capture* | To connect a laptop or computer VGA output to capture it |

h5. c.Motherboard

| C1 | *Mouse-Keyboard* | PS2 connector for keyboard or mouse |
| C2 | *USB hub* | External USB 2.0 hub for multiple purposes. |
| C3 | *LAN input* | To connect a RJ45 connector for network purposes. |
| C4 | *SPDIF input* | External USB 2.0 hub for multiple purposes. |

{column}
{column: 39 %}
!class_with_inputs.png|align=center,thumbnail,width=400,border=1!
{center}Click on the image to enlarge.{center}
{column}
{section}

h5. d.On-board sound card

|| \# || Port || Description ||
| D1 | *Line IN* | (Recommended) To connect a mixer or a line level microphone to record, mini-jack 3.5mm. |
| D2 | *Headphones OUT* | To connect a mixer or a microphone to record, mini-jack 3.5mm. |
| D3 | *Microphone IN* | To connect a microphone to record, mini-jack 3.5mm. |

\\

{anchor:start}
h4. Autostart

By default, Galicaster is started automatically as the operative system is loaded. To change this do the following:
* Press Win and write _Startup Applications_,
* Check out Galicaster to disable the autostart
* Repeat the operation to re-stablish the autostart

You may want to do it using the terminal:
* Delete \~/.config/autostart/galicaster.desktop

To re-stablish the autostart:
* cp /usr/share/applications/galicaster.desktop \~/.config/autostart/

{anchor:shortcuts}
h4. Shortcuts

To configure the operative system supporting Galicaster you may exit Galicaster or change the current desktop. To do so:

a. If the _admin mode_ is activated you can quit on the welcome page, on the quit button on the bottom right corner.
* To access the welcome page you can't be recording
b. If the _admin mode_ isn't active then you can use a keyboard shortcut Ctrl+Shift+Q, to do so the Num Block has to be activated.
c. You may not want to exit Galicaster and still change configuration on the OS, use the combination Ctrl+Alt+Left/RightArrow to switch between desktops (usually four).

To run Galicaster once closed use the Shortcut in the Desktop or press Win and write Galicaster to look for the application launcher.

The Network Manager is on the top right corner, Right-button click on the double arrow icon.

!netmanager.png|align=left!\\


h3. D. Capture Devices configuration
----
Galicaster configuration are specified by two types files: configuration and input profiles.
Depending on your needs you may set different parameters. Consult ....... to know the meaning and possible values of each parameters.

Galicaster records multiple devices synchronously. Each device and its configuration is called a _track_. A Input Profile is a group of tracks to be recorded together. The most common profiles are:

* Webcam + Slides + Microphone: class.ini
* Webcam + Slides + Microphone + Backup Audio: class_audio_backup.ini
* Video Camera (audio included) + Slides: camera_slides.ini
* HD input (audio included) + Slides: hd_slides.ini
* HD camera + HDMI slides: hd_unit.ini

In these examples, we suppose two streams of video. If you don't want to record the slides, create a new profile without the slides track and remember to change the name of the profile, to avoid confusion.

Now, it's time to configure the cards you've selected and the audio. More information about this matter is available [here|Galicaster: Cookbook].


{anchor:epiphan}

h4. D.1 Epiphan configuration

EXPLAIN the behaviour of the Switcher, input and output resolution, blask strips ...

{anchor:webcan}
h4. D.2 Webcam configuration

Logitech c920 is an HD webcam with optic lens and automatic behaviour - white balance, autofocus, auto-aperture.
It records 24 fps at 720p. The default configuration is:
* power-line-frequency:50Hz
* cappabilities: image/jpeg,framerate=24/1,width=1280,height=720
*Back to 4:3*
If you want you can _cut_ part of the video to record a non-panoramic video including in the configuration:
* videocrop-left=160
* videocrop-right=160
_The value is in pixels_

To set manual values on the parameters of the webcam use a tool called guvcview:
* Open a terminal and run:
{code:none}
guvcview -o
{code}

{code:none}
gst-inspect-0.10 decklinksrc | grep Enum -A 20
{code}

Once you identified the format you want to capture, edit the _conf.ini_ file you've just downloaded. Search for the _track_ Blackmagic and change the parameters _input_ and _input_type_ for their right values. Some try-and-error may be neccessary since maybe you can't gather all the information from your video source.
The _p_ in 1080p stands for _progressive_
The _i_ in 1080i stands for _interlaced_

*Standard selection*
You have to choose between a list of standards. To list and select the standard, run in a shell:

{code:none}
v4l2-ctl -d /dev/haucamera --list-standards | grep Index -A 2
v4l2-ctl -d /dev/haucamera -s 0
{code}

*Input selection*
Depending on the input you are using you have to choose between S-Video (4-pin) and Composite (RCA). To list and select the input, run in shell:

{code:none}
v4l2-ctl -d /dev/haucamera -n | grep Input -A 1
v4l2-ctl -d /dev/haucamera -i 2
{code}

Inputs 1 and 3 are for 4-pin.
Inputs 2, 4 and 5 are for RCA.

*Headphones output*
Regulate this slide bar to a comfortable sound level.

*Pulse input ( Line in):*
_If you are using the Hauppauge card please skip this section_
Select the input you are using and set the values to 100% volume, no amplification.
Later, if you have distortion on your audio input, edit the conf.ini and set _amplification = 1.0_ in the AudioSource device.

{code:none}
pactl list | grep Source -A 2
{code}

Identify the input you want to use, for example
{code:none}
alsa_input.pci-0000_00_1b.0.analog-stereo
{code}

Use the _name_ as _location_ on the _conf.ini_ pulse track
{code:none}
[track3]
name = AudioSource
device = pulse
flavor = presenter
active = True
*location = alsa_input.pci-0000_00_1b.0.analog-stereo*
file = sound.mp3
amplification = 2.0
vumeter = True
player = True
{code}
----
\\

*Galicaster Vumeter*
Add this section in the _conf.ini_ file.

{code:none}
[audio]
min = -60
max = 0
{code}

If the NO SOUND dialog is coming in and out constantly, set a higher value on _min_, for example \-40.
\\

*Alsa Advanced configuration*
If you still experience problems after configuring the Sound Manager and your Mixer or Sound input device, you should take a look to ALSA.
Run _alsamixer_ on a shell and ensure that your device is not being amplified.
* Press F6 to select the input and F4 to go to the Capture section.
* You can check the real Gain on _Item_ on the top left corner of the screen.

First of all, You need the admin host address, including the port. For example:

{code:none}
host = http://fakeadmin.matterhorn.com:80
{code}

You also need a *digest user* \- a regular one won't work. There is a default digest account that should be replaced with your own values.

{code:none}
username= matterhorn_system_account
password= CHANGE_ME
{code}

You also need to set up a default workflow and its parameters. Scheduled recordings will have his own workflow and parameters, defined in the scheduling operation, but the recordings started manually won't. The usual parameters you have to set up are *captions* and *trimHold*, which default to *False*. The normal configuration is:

{code:none}
workflow = full
workflow-parameters = trimHold:true
{code}

If you set up more than one parameter:

{code:none}workflow-parameters = trimHold:true;captions=True{code}

Finally, you have to decide if your recordings will be recorded automatically or not. If you want to do so, set *default* to True. All the configuration together will look like:

{code:none}
[ingest]
active = True
default = False
host = http://fakeadmin.matterhorn.com:80
username = matterhorn_system_account
password = CHANGE_ME
workflow = full
workflow-parameters = trimHold:true
{code}

This piece of code must be written on one of the configurations file. Be aware that values in _conf.ini_ will overrule its equivalent in _conf-dist.ini_.