1.1 Cookbook

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

Galicaster is dependant on the hardware installed on the units so we provide some guides to install and configure of the most commom cards used along this software. We also include some instructions to help you fix the access to those cards and the application on the operative system.

h4. Drivers installation and configuration:

* *[Epiphan Modules Installation|Epiphan cards]*
* *[Hauppauge Cards Configuration|Hauppauge cards]*
* *[Blackmagic Cards Configuration|Galicaster:Blackmagic cards]*
* *[NCast Cards Configuration|Galicaster:NCast cards]*
* *[Firewire Cards Configuration|Galicaster:Firewire cards]* (Not available yet)

h4. Instructions
* [UDEV rules|#udev]
* [Galicaster Autostart|#autostart]

h5. UDEV rules


Create the file {{/etc/udev/rules.d/galicaster.rules}}, which will contain the udev rules that will be applied to the devices.

Use the following command to find out the value of *{{ATTR\{name\}}}* for a specific device:

{code:none}
$ udevadm info --attribute-walk --name=${device}
{code}

substituting {{"$\{device\}"}} for the device's mount point, for example:

{code:none}
$ udevadm info --attribute-walk --name=/dev/video0
$ udevadm info --attribute-walk --name=/dev/video1 | grep name
{code}

(e.g. {{/dev/video0}})

These are some configuration examples:

{code:none} 
KERNEL=="video[0-9]*", ATTR{name}=="Epiphan VGA2USB #V2U19350", GROUP="video", SYMLINK+="screen"
KERNEL=="video[0-9]*", ATTR{name}=="ivtv0 encoder MPG", GROUP="video", SYMLINK+="camera"
KERNEL=="video[0-9]*", ATTR{name}=="UVC Camera (046d:0821)", GROUP="video", SYMLINK+="webcam"
KERNEL=="video[0-9]*", ATTR{name}=="ivtv0 encoder MPG", GROUP="video", SYMLINK+="haucamera"
KERNEL=="video[0-9]*", ATTR{name}=="ivtv0 encoder YUV", GROUP="video", SYMLINK+="hauprevideo"
KERNEL=="video[0-9]*", ATTR{name}=="ivtv0 encoder PCM", GROUP="audio", SYMLINK+="haupreaudio"
{code}

For newer Epiphan drivers:
{code:none}
KERNEL=="video[0-9]*", ATTR{name}=="vga2usb", SYMLINK+="screen"
{code}

{anchor:autostart}

h4. Galicaster Launcher & Autostart

If you want to make a launcher to run galicaster through the visual interface you may follow these instructions:

* Copy {{docs/autostart/galicaster.svg}} to {{/usr/share/icons}}.
* Copy {{docs/autostart/galicaster.destktop to {{usr/share/applications}}.
** Now you have galicaster on your Unity interface.
* Run Galicaster and Lock the launcher of the dock.
* Drag the GC icon to the desktop.
** If the GC logo doesn't show, right-button on the file, go to _Properties_, choose the tab _Permissions_ and check _Allow executing file as a program_.
** You can resize it by clicking right-button on the launcher, go to _Resize Icon..._ .

To make galicaster start as the operative system loads do the following:
* Copy {{docs/autostart/galicaster.desktop}} to {{~/.config/autostart}}.