|
Key
This line was removed.
This word was removed. This word was added.
This line was added.
|
Changes (43)
View Page History{pop-away:metadata | comments | children | labels}
In order to give adopters the possibility to taste and try what new features and looking are coming with Galicaster 1.2.0 a Release candidate is released, however, with a brief documentation.
{section}
{column:width=69%}
This is a generic step-by-step, one-page guide to Galicaster 1.2.0.
If you are not familiar with Galicaster you may want to read the full guide, starting at the [Download page.|1.2.0 Download Galicaster]
{column:width=69%}
This is a generic step-by-step, one-page guide to Galicaster 1.2.0.
If you are not familiar with Galicaster you may want to read the full guide, starting at the [Download page.|1.2.0 Download Galicaster]
h1. Prerequisites
To try this release you must follow these steps:
* Install Ubuntu 12.04 (64 bits recommended)
** Update all packages on at the Update Manager
** Activate the additional drivers for graphics card
** _Recommended_: Deactivate screensaver (Brightness & Lock configuration)
* h4. Install dependencies
{column}
{column:width=29%}
{bgcolor:yellow}
{table:align=center}
{td}
{center}
h5. Documentation
{center}
# [Hardware recommendations|1.2.0 Hardware recommendations]
#* [Cookbook|Cookbook]
# [Software installation|1.2.0 Software installation]
#* [Upgrading from older versions]
# [Configuration manual|1.2.0 Galicaster Configuration].
# [User's Guide|User Guide]
#* [FAQ|FAQ]
* [Quick installation guide|Quick installation guide]\\
\\
{td}
{table}
{bgcolor}
{column}
{section}
{column:width=29%}
{bgcolor:yellow}
{table:align=center}
{td}
{center}
h5. Documentation
{center}
# [Hardware recommendations|1.2.0 Hardware recommendations]
#* [Cookbook|Cookbook]
# [Software installation|1.2.0 Software installation]
#* [Upgrading from older versions]
# [Configuration manual|1.2.0 Galicaster Configuration].
# [User's Guide|User Guide]
#* [FAQ|FAQ]
* [Quick installation guide|Quick installation guide]\\
\\
{td}
{table}
{bgcolor}
{column}
{section}
{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 \
$ 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
$ sudo apt-get install python-pip python-setuptools
$ sudo pip install icalendar
$ sudo pip install icalendar
...
$ sudo apt-get install v4l-conf v4l-utils guvcview * Install Epiphan driver:
** For 64 bits machine with kernel 3.2.0-24 or newer in this [link|http://www.epiphan.com/downloads/linux/index.php?dir=&file=vga2usb-3.27.2.4-ubuntu-3.2.0-24-generic-x86_64.tbz]
** For 64 bits machine with kernel 3.2.0-24 or newer in this [link|http://www.epiphan.com/downloads/linux/index.php?dir=&file=vga2usb-3.27.2.4-ubuntu-3.2.0-24-generic-x86_64.tbz]
* Hauppauge driver is included Ubuntu 12.04, and Blackmagic gstreamer plugin is included on the gstreamer dependencies, however Blackmagic driver must be installed:
** Blackmagic driver installation: [Galicaster:Blackmagic cards]
** Blackmagic driver installation: [Galicaster:Blackmagic cards]
h4. Install drivers
* [Configure your udev rules|Galicaster:Cookbook] as in previous releases
* [Epiphan|Galicaster:Epiphan cards]
** Download the driver for 64 bits architecture and kernel 3.2.0-24 or newer from this [link|http://www.epiphan.com/downloads/linux/index.php?dir=&file=vga2usb-3.27.2.4-ubuntu-3.2.0-24-generic-x86_64.tbz]
* [Hauppauge|Galicaster:Hauppauge cards]
** Hauppauge driver is included Ubuntu 12.04
* [Galicaster:Blackmagic cards]
** Latest driver (9.6.9) is available at this [link|http://software.blackmagicdesign.com/DesktopVideo/Blackmagic_Desktop_Video_Linux_9.6.9.tar.gz]. It contains a DEB package.
** Blackmagic gstreamer plugin is included on the gstreamer dependencies installed above.
* [Galicaster:NCast cards]
** Driver for 3.x kernels is available at this [address|http://www.ncast.com/files/digitizer4-2_3_1_5.tgz].
** Download the driver for 64 bits architecture and kernel 3.2.0-24 or newer from this [link|http://www.epiphan.com/downloads/linux/index.php?dir=&file=vga2usb-3.27.2.4-ubuntu-3.2.0-24-generic-x86_64.tbz]
* [Hauppauge|Galicaster:Hauppauge cards]
** Hauppauge driver is included Ubuntu 12.04
* [Galicaster:Blackmagic cards]
** Latest driver (9.6.9) is available at this [link|http://software.blackmagicdesign.com/DesktopVideo/Blackmagic_Desktop_Video_Linux_9.6.9.tar.gz]. It contains a DEB package.
** Blackmagic gstreamer plugin is included on the gstreamer dependencies installed above.
* [Galicaster:NCast cards]
** Driver for 3.x kernels is available at this [address|http://www.ncast.com/files/digitizer4-2_3_1_5.tgz].
h1. Install Galicaster:
h4. [Configure your udev rules|Cookbook] as in previous releases.
* Consult the device internal names
{code:none}
ls /dev/video*
udevadm info --attribute-walk --name=/dev/video0 | grep name
{code}
* Create the file /etc/udev/rules.d/galicaster.rules with a variation of the following lines.
{code:none}
KERNEL=="video[0-9]*", ATTR{name}=="UVC Camera (0123d:4567)", GROUP="video", SYMLINK+="webcam"
KERNEL=="video[0-9]*", ATTR{name}=="vga2usb", SYMLINK+="screen"
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}
h3. Install Galicaster:
{code:none}
ls /dev/video*
udevadm info --attribute-walk --name=/dev/video0 | grep name
{code}
* Create the file /etc/udev/rules.d/galicaster.rules with a variation of the following lines.
{code:none}
KERNEL=="video[0-9]*", ATTR{name}=="UVC Camera (0123d:4567)", GROUP="video", SYMLINK+="webcam"
KERNEL=="video[0-9]*", ATTR{name}=="vga2usb", SYMLINK+="screen"
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}
h3. Install Galicaster:
* Download the [package|http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.2.0-rc1.tgz].
* Unpackage it and place the folder in an area where you have permissions to run applications. Change the folder name if you want to.
* Place the [conf.ini example|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/conf.ini] oin the designated folder.
* Download the profiles you want to try and copy them in {{profiles/}}. Modify the values to adapt them to your scenario.
** [VGA capturing |http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/vga.ini]
** [VGA and Sound capturing |http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/vga_sound.ini]
** [Webcam and sound|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/webcam_sound.ini]
*** The webcam device is set to {{/dev/video0}}, where webcams are usually found. Change it if necessary.
** [Hauppauge ( PAL / NTSC ) and VGA |http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hau_vga.ini]
*** Sound synch'ed and recorded through the Hauppauge card.
** Blackmagic (with sound incorporated)
*** [SDI capturing + VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/sdi_vga.ini] \- i.e. Blackmagic Decklink
*** [HDMI capturing + VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hdmi_vga.ini] \- i.e. Blackmagic Intensity Pro
** [VGA capturing |http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/vga.ini]
** [VGA and Sound capturing |http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/vga_sound.ini]
** [Webcam and sound|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/webcam_sound.ini]
*** The webcam device is set to {{/dev/video0}}, where webcams are usually found. Change it if necessary.
** [Hauppauge ( PAL / NTSC ) and VGA |http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hau_vga.ini]
*** Sound synch'ed and recorded through the Hauppauge card.
** Blackmagic (with sound incorporated)
*** [SDI capturing + VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/sdi_vga.ini] \- i.e. Blackmagic Decklink
*** [HDMI capturing + VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hdmi_vga.ini] \- i.e. Blackmagic Intensity Pro
* Run Galicaster with _./run_galicaster.py_. It will start with mock devices (bars, static and noise).
* Download the profiles you may want to try and copy then on _profiles/_. There are some [profile example|#examples] some chapters above.
* Replace those values on the profiles to adapt them to your devices.
* Replace those values on the profiles to adapt them to your devices.
h14. Migrate Repository from 1.1.x to 1.2.x
Mediapackages are compatible with both versions but we have included new information concerning the status of the operations. Then, Thus, only one file will needs to be modified, the others will remain unaltered.
To do so:
* The script is docs/scripts/migrate_repository.py at {{docs/scripts/migrate_repository.py}}
* Move Copy it to your Galicaster 1.2 directory,
* Configure Galicaster to point to on the repository you want to migrate to. {{basic>repository=/home/folder/example}}
* Make a backup
* _Optional:_ Backup your file.
* Run it on a terminal: {code:none}python migrate_repository.py{code}
h1. New features
h4. Create a launcher at the Desktop and in Unity
If you have used Galicaster before, you won't find many changes visually. Most of the work has been focused on new Operations upon packages, provide a basic Profile interface and improve the Ingest service.
Other internal changes will be visible on further releases, when we release new plugins and features that are not ready yet.
Other internal changes will be visible on further releases, when we release new plugins and features that are not ready yet.
* Copy {{docs/autostart/galicaster.svg}} to {{/usr/share/icons}}.
* Copy {{docs/autostart/galicaster.destktop}} to {{usr/share/applications}}.
* Pulse Meta(Win key), type Galicaster and drag the GC icon to the desktop.
** If the GC logo does not show, right-click on the file, go to Properties, choose the 'Permissions' tab and check 'Allow executing file as a program'.
* Resize it by right-clicking on the launcher, go to Resize Icon... .
* Copy {{docs/autostart/galicaster.destktop}} to {{usr/share/applications}}.
* Pulse Meta(Win key), type Galicaster and drag the GC icon to the desktop.
** If the GC logo does not show, right-click on the file, go to Properties, choose the 'Permissions' tab and check 'Allow executing file as a program'.
* Resize it by right-clicking on the launcher, go to Resize Icon... .
h3. Profiles
To make Galicaster start automatically at the system boot, do the following:
A profile is a group of tracks configurated to run together to record a Mediapackage. Each profile can have one or many tracks, usually from 1 to 4 (two videos and two audios). You can shift between profiles on the profile menu, clicking on the button below Recorder, on the welcome page.
* Copy {{docs/autostart/galicaster.desktop}} to {{\~/.config/autostart}}.
When you change a profile it's automatically loaded. If anything goes wrong, you will receive a message on the Recorder area.
You can try another profile any time you want, without leaving the program. You have to leave the program to edit any profile, if you have knowledge to do so.
You can try another profile any time you want, without leaving the program. You have to leave the program to edit any profile, if you have knowledge to do so.
h3. New operations
h4. Configure the ingestion server and behaviour
We have included two new operations: export to zip and create a size by size copy of the mediapackage. All the operations, including ingest, can be triggered immediately or nightly (00 am local by default).
* h4. Zip
The "export to zip" operation will zip without compression a mediapackage on the user main folder (usually /home/user/)
To change the folder set the custom path on the configuration files, changing the value of \[basic\]>export.
* h4. Side by Side
The "side by side" will create a single file video with a side-by-side composition of both presenter and presentation videos. The audio will be attached to. The video is exported to mp4 extension and will be placed on the user main folder.
To change the folder set the custom path on the configuration files, changing the value of \[basic]\>export.
Note: Size by size operation only works on mediapackages with 2 videos (audio could be both in or out the video track), the audio will be get from the track with presenter flavor (either video or audio)
h3. Ingest improvements
In this new version of Galicaster Ingesting is more flexible. You can choose a immediate or a nightly ingest style, separately on manual and scheduled recordings. You also may configure the starting time of the nightly ingests.
In addition, operations can be queued, so if you select many operations sequentially they will be resolved in the same order you or the program select them.
Note: nightly operations are not sequentially.
To change your nightly time to ingest, include or change this lines on your configuration files
* h4. Zip
The "export to zip" operation will zip without compression a mediapackage on the user main folder (usually /home/user/)
To change the folder set the custom path on the configuration files, changing the value of \[basic\]>export.
* h4. Side by Side
The "side by side" will create a single file video with a side-by-side composition of both presenter and presentation videos. The audio will be attached to. The video is exported to mp4 extension and will be placed on the user main folder.
To change the folder set the custom path on the configuration files, changing the value of \[basic]\>export.
Note: Size by size operation only works on mediapackages with 2 videos (audio could be both in or out the video track), the audio will be get from the track with presenter flavor (either video or audio)
h3. Ingest improvements
In this new version of Galicaster Ingesting is more flexible. You can choose a immediate or a nightly ingest style, separately on manual and scheduled recordings. You also may configure the starting time of the nightly ingests.
In addition, operations can be queued, so if you select many operations sequentially they will be resolved in the same order you or the program select them.
Note: nightly operations are not sequentially.
To change your nightly time to ingest, include or change this lines on your configuration files
Depending on when or how you want to ingest the mediapackages set the {{manual}} and {{scheduled}} properties to {{none}} / {{immediately}} / {{nightly}}.
{code:none}
[heartbeat]
night = 00:00
{code}
h3. Other improvements and features
* The frequency of the messages send to Matterhorn is configurable.
* Some device errors are captured by the program, avoiding crashing.
* New information is available on the Recorder Area: Elapsed time, free space, connectivity.
* Blackmagic plugin allows to record audio or not.
* New plugins has been included: Audiotest, Videotest - both mock devices - and Firewire.
h2. Configuration differences between 1.1.x and 1.2.0
*A updated configuration guide is available on docs/install/readme.txt*
Basically, your configuration will work on the new release.
Your track setup will be considered the "default" profile, so if you don't select a profile, or the profile name is wrong, the default profile will be loaded.
Take a look to a example (the default profile has been removed)
{code:none}
[basic]
admin = True
profile = Webcam
night = 00:00
{code}
h3. Other improvements and features
* The frequency of the messages send to Matterhorn is configurable.
* Some device errors are captured by the program, avoiding crashing.
* New information is available on the Recorder Area: Elapsed time, free space, connectivity.
* Blackmagic plugin allows to record audio or not.
* New plugins has been included: Audiotest, Videotest - both mock devices - and Firewire.
h2. Configuration differences between 1.1.x and 1.2.0
*A updated configuration guide is available on docs/install/readme.txt*
Basically, your configuration will work on the new release.
Your track setup will be considered the "default" profile, so if you don't select a profile, or the profile name is wrong, the default profile will be loaded.
Take a look to a example (the default profile has been removed)
{code:none}
[basic]
admin = True
profile = Webcam
[ingest]
active = True
active = True
...workflow-parameters = trimHold:true
{code}
{code}
{anchor:examples}
h3. Configuration and Profiles examples
There is a configuration file included on the package, conf-dist.ini
An example of conf.ini is provided [here|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/conf.ini], the default profile holds three mock tracks with static, color bars and pink noise.
We have uploaded some profile fully functional examples.
* [VGA capturing | http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/vga.ini]
* [VGA and Sound capturing | http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/vga_sound.ini]
* [Webcam and sound|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/webcam_sound.ini]
** The device is set on /dev/video0, where webcams are usually found, change it if necessary
* [Hauppauge ( PAL / NTSC ) and VGA | http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hau_vga.ini]
** Sound synced and recorded via Hauppauge
* Blackmagic (with sound incorporated)
** [SDI capturing + VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hdmi_vga.ini] - i.e. Blackmagic Decklink
** [HDMI capturing + VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/sdi_vga.ini] - i.e. Balckmagic Intensity Pro
You may temper the configuration, specially device output location and names of the recording files and current tracks.
If you have any doubt, please consult the guide on docs/install/readme.txt
h3. Matterhorn Scheduler behaviour
With the appearance of profiles, some understanding of their functioning is needed to use the Matterhorn scheduler. There's two options, whether Matterhorn can select the tracks or not.
* When Galicaster's admin mode is off, Galicaster send its tracks to Matterhorn -, giving the scheduler the option to disable some tracks, for instance the VGA or a backup audio.
* When admin mode is on, changes are expectable. Galicaster won't send its tracks and the scheduler won't be able to select any, just schedule. Then, Galicaster will record all tracks activated on the current profile and Matterhorn
h3. Media Manager new look
Media Manager has suffered some changes:
* Instead of ingest we have operations.
* Each operation status is shown on the Manager.
* Colors only affects operations.
* Colors are configurable.
* Classic color scheme is available and configurable (colors are decided depending on ingest status) .
An example for the color configuration:
{code:none}
[color]
classic = false
none = #FFF0AA
nightly = #AEFFAE
pending = #AEFFAE
processing = #FFAE00
done = #88FF88
failed = #FFAEAE
{code}