|
Key
This line was removed.
This word was removed. This word was added.
This line was added.
|
Changes (84)
View Page History{pop-away:metadata | comments | children | labels}
\\
There is two configuration files: *conf-dist.ini* and *conf.ini*. The idea is to set default values on the first one and use the second to set the current configuration. _If any duplicated value between the two files, conf.ini values will prevail._
There is two configuration files: *conf-dist.ini* and *conf.ini*. The idea is to set default values on the first one and use the second to set the current configuration. _If any duplicated value between the two files, conf.ini values will prevail._
In addition Galicaster 1.2 supports a profile logic. Profiles are sets of tracks that can be loaded to run together. Profiles are listed on a menu on the welcome page, thus being available only for admin users.
{section}
{column:width=69%}
There are two types of configuration files: general configuration files and input configuration files:
{column:width=69%}
There are two types of configuration files: general configuration files and input configuration files:
There are two *general configuration* files: *conf-dist.ini* and *conf.ini*. The idea is to set default values on the first one and use the second to set the current configuration. _If any duplicated value between the two files, conf.ini values will prevail._ Each general configuration file is divided in sections, each one explained below, on this very same page.
In addition Galicaster 1.2 supports a *input profile* logic. Profiles are sets of configuration for devices - tracks - that can be loaded to run together. Profiles are listed on a menu on the welcome page, thus being available only for admin users. To know more about input profile please visit [this page|Galicaster:Input Profiles].
In addition Galicaster 1.2 supports a *input profile* logic. Profiles are sets of configuration for devices - tracks - that can be loaded to run together. Profiles are listed on a menu on the welcome page, thus being available only for admin users. To know more about input profile please visit [this page|Galicaster:Input Profiles].
* Sections
** [Basic|#config_basic] (Updated in 1.2.2)
** [Repository|#config_repo] (New on 1.2.2)
** [Screen|#config_screen]
** [Ingest|#config_ingest] (Updated 1.2.1)
** [Allows|#config_allows]
** [Tracks|#config_track]
** [Tracks|#config_track]
* [Profiles|#config_profiles]
*** [Generic V4L2|#v4l2]
*** [Epiphan|#vga2usb]
*** [Pulse Audio|#pulse]
*** [Blackmagic|#blackmagic] (Updated in 1.2.0)
*** [Hauppauge|#hauppauge]
*** [Firewire|#firewire] (New on 1.2)
*** [Videotest|#videotest] (New on 1.2)
*** [Audiotest|#audiotest] (New on 1.2)
* [Input profiles|Galicaster:Input Profiles] (New page)
{column}
{column:width=29%}
{bgcolor:yellow}
{table:align=center}
{td}
{center}
*** [Epiphan|#vga2usb]
*** [Pulse Audio|#pulse]
*** [Blackmagic|#blackmagic] (Updated in 1.2.0)
*** [Hauppauge|#hauppauge]
*** [Firewire|#firewire] (New on 1.2)
*** [Videotest|#videotest] (New on 1.2)
*** [Audiotest|#audiotest] (New on 1.2)
* [Input profiles|Galicaster:Input Profiles] (New page)
{column}
{column:width=29%}
{bgcolor:yellow}
{table:align=center}
{td}
{center}
h5. Documentation
{center}
# [Hardware recommendations|1.2.0 Hardware recommendations]
# [Software installation|1.2.0 Software installation]
#* [Galicaster:Capture cards configuration]
#* [Upgrading from older versions]
# [Configuration manual|1.2.0 Galicaster Configuration].
#* [Input profiles]
# [User's Guide|User Guide]
#* [FAQ|FAQ]
* [Quick installation guide|Quick installation guide]
* [Cookbook|Cookbook]\\
\\
{td}
{table}
{bgcolor}
{column}
{section}
{center}
# [Hardware recommendations|1.2.0 Hardware recommendations]
# [Software installation|1.2.0 Software installation]
#* [Galicaster:Capture cards configuration]
#* [Upgrading from older versions]
# [Configuration manual|1.2.0 Galicaster Configuration].
#* [Input profiles]
# [User's Guide|User Guide]
#* [FAQ|FAQ]
* [Quick installation guide|Quick installation guide]
* [Cookbook|Cookbook]\\
\\
{td}
{table}
{bgcolor}
{column}
{section}
h5. Sections
The files are divided in sections. The beginning of a section is marked by a keyword indicating its title, surrounded by square brackets. Below is a detailed description of the different sections and their contents:
{anchor:config_basic}
{anchor:config_basic}
h6. Section {{basic}}
* {{admin}}: enables admin mode ({{True\|False}})
** *False*: By default, the user will only be allowed to make recordings. Galicaster will operate as a [Galicaster Class|Galicaster:Galicaster Class]
* {{admin}}: enables admin mode ({{True\|False}})
** *False*: By default, the user will only be allowed to make recordings. Galicaster will operate as a [Galicaster Class|Galicaster:Galicaster Class]
*** In this mode, tracks are selectable, so only the selected ones will be send back to the server.
** *True*: Apart from recording, the user can edit metadata, play and manage the recordings. Galicaster will behave as a [Galicaster Mobile|Galicaster Mobile]
*** In this mode Matterhorn server won't receive a list of tracks, so all tracks specified will be recorded, packaged and send back to the server.
** Depending on the mode, the capture unit will assume a different capture agent name. A computer named Example will gcExample on Class mode and gcMobileEXample on Mobile mode. The agent name can be set manually on ingest>hostname.
** Depending on the mode, the capture unit will assume a different capture agent name. A computer named Example will gcExample on Class mode and gcMobileEXample on Mobile mode. The agent name can be set manually on ingest>hostname.
* {{repository}}: absolute path to the working folder. If not specified, a {{Repository}} directory in the user's home will be used.
* {{export}}: absolute path to the export folder for operations. If not specified, exported files will be placed at the user's home folder.
* {{export}}: absolute path to the export folder for operations. If not specified, exported files will be placed at the user's home folder.
* {{legacy}}: activates Openacast Matterhonr 1.2 and 1.3 compatibility, excluding the namespace field on the xml files from the mediapackages. (True\|False)
* {{stopdialog}}: Enable/Disable a dialog requesting confirmation to stop the recording. Defaults to True. *(True\|False)*
* {{quit}}: Shows or hides the quit button. *(True\|False)*
Example:
...
{code:none} stopdialog = True
quit = True
quit = True
{code}
{align:right}{pop-top}{align}
{anchor:config_repo}
* folder_template: Name template for the repository folders. Useful on file manager navigation. By default gc_\{hostname\}_\{year\}-\{month\}-\{day\}T\{hour\}h\{minute\}m\{second\}. Keys for the template:
** id: MP identifier
** title: Original MP's title.
** series: Original series' title.
** hostname: Capture agent's name.
** type: 'M' if MP was recorded manually, 'S' if it was scheduled.
** longtype: 'manual' if MP was recorded manually, 'scheduled' if it was scheduled.
** year: MP's recording star-time year with century as decimal
** month: MP's recording start-time month as decimal. \[01,12\]
** day: MP's recording start-time day as decimal. \[01,31\]
** hour: MP's recording start-time hour as decimal. \[00,23\]
** minute: MP's recording start-time minute as decimal.
** second: MP's recording start-time second as decimal.
* folder_template: Name template for the repository folders. Useful on file manager navigation. By default gc_\{hostname\}_\{year\}-\{month\}-\{day\}T\{hour\}h\{minute\}m\{second\}. Keys for the template:
** id: MP identifier
** title: Original MP's title.
** series: Original series' title.
** hostname: Capture agent's name.
** type: 'M' if MP was recorded manually, 'S' if it was scheduled.
** longtype: 'manual' if MP was recorded manually, 'scheduled' if it was scheduled.
** year: MP's recording star-time year with century as decimal
** month: MP's recording start-time month as decimal. \[01,12\]
** day: MP's recording start-time day as decimal. \[01,31\]
** hour: MP's recording start-time hour as decimal. \[00,23\]
** minute: MP's recording start-time minute as decimal.
** second: MP's recording start-time second as decimal.
{anchor:config_screen}
h6. Section {{screen}}
...left = Hauppauge
{code}
{code}
{align:right}{pop-top}{align}
{anchor:config_ingest}
h6. Section {{ingest}}
* {{active}}: Enables the connection to a Opencast-Matterhorn server *(True\|False)*.
* {{manua}}l: {{manual}}: Configure the method to automatically ingest the manual recordings. The possible options are: disable the automatic ingestion (none), ingest immediately after the recording (immediately) or ingest nightly all the recordings of the previous day (nightly). Defaults to 'none'. *(none\|immediately\|nightly)*
* {{scheduled}}: Configure the method to automatically ingest the scheduled recordings. The possible options are: disable the automatic ingestion (none), ingest immediately after the recording (immediately) or ingest nightly all the recordings of the previous day (nightly). Defaults to 'none'. *(none\|immediately\|nightly)*
* {{host}}: Matterhorn server URL.
* {{username}}: Name of the Galicaster unit. Defaults to the host name as defined in the OS, prepended by "GC-" if it is a Galicaster Class or "GCMobile-" if it is a Galicaster Mobile.
* {{password}}: Password for the account used to operate the Matterhorn REST endpoints service.
* {{hostname}}: Custom denomination of the galicaster unit. By default it's obtained from de operative system.
* {{workflow}}: name of the workflow used to ingest the recordings.
* {{hostname}}: Custom denomination of the galicaster unit. By default it's obtained from de operative system.
* {{workflow}}: name of the workflow used to ingest the recordings.
* {{workflow-parameters}}: pairs of parameter and value (parameter:value) to be parsed on the Matterhorn workflow, separated by semicolon.
* {{workflow-parameters}}: pairs of parameter and value (parameter:value) to be parsed on the Matterhorn workflow. If more than one parameter is required separate them with a semicolon and encase the whole string in single quotes.
Example:
...password = CHANGE_ME
workflow = full
workflow = full
workflow-parameters = 'trimHold:true;captionHold:false;archiveOp:true'
{code}
{align:right}{pop-top}{align}
{anchor:config_allows}
h6. Section {{allows}}
...overlap = False
{code}
{code}
{align:right}{pop-top}{align}
{anchor:config_track}
h6. Section {{trackN}}
A section per device used in the capturer. Each section is set according to the device type: {{hauppauge}}, {{pulse}}, {{v4l2}} or {{vga2usb}}:
{anchor:v4l2}
*v4l2*: Video device
* Admitted values:
* Admitted values:
...** {{location}}: Device's mount point in the system (e.g. /dev/video0).
** {{file}}: The file name where the track will be recorded.
** {{file}}: The file name where the track will be recorded.
** {{active}}: Whether the device will be played and recorded. ({{True\|False}})
** {{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}} (optional).
** {{active}}: Whether the device will be played and recorded. ({{True\|False}})
** {{caps: }} GStreamer cappabilities of the device ({{mimetype=TYPE, framerate=X/Y,width=A,height=B}})
...For more information [http://pygstdocs.berlios.de/pygst-tutorial/capabilities.html|http://pygstdocs.berlios.de/pygst-tutorial/capabilities.html]
Example:
{code:none}
{code:none}
[track41]
name = Webcam
device = v4l2
device = v4l2
...videocrop-right = 160
{code}
{code}
{align:right}{pop-top}{align}
{anchor:vga2usb}
*vga2usb*: Video device
** Admitted values:
** Admitted values:
...file = SCREEN.avi
active = True
active = True
drivertype = v4l2
{code}
{align:right}{pop-top}{align}
{anchor:pulse}
*pulse*: Audio device.
* Admitted values:
* Admitted values:
...** {{location}}: PulseAudio source name. Use _default_ to select the same Input as the Sound Control
** {{file}}: The file name where the track will be recorded.
** {{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.
** {{amplification}}: Gstreamer amplification value: < 1 decreases and > 1 increases volume. Values between 1 and 2 are commonly used.
** {{player}}: Wheter the audio will be previewed (played).
** {{active}}: Whether the device will be played and recorded. ({{True\|False}})
** {{active}}: Whether the device will be played and recorded. ({{True\|False}})
* to list PulseAudio devices run:
...location = default
file = sound.mp3
file = sound.mp3
active = False True
vumeter = Active True
amplification = 2.0
{code}
{code}
{align:right}{pop-top}{align}
{anchor:blackmagic}
*blackmagic*: Video device
* Admitted values:
* Admitted values:
...** {{flavor}}: Matterhorn "flavor" associated to the track. ({{presenter\|presentation\|other}})
** {{file}}: The file name where the track will be recorded.
** {{file}}: The file name where the track will be recorded.
** {{active}}: Whether the device will be played and recorded. ({{True\|False}})
** {{input}}: Input signal format. (sdi\|hdmi\|opticalsdi\|component\|composite\|svideo)
** {{input-mode}}: Input vidoe video mode and framerate (1-20). (eg. 1080i60). More information [here|Galicaster:Blackmagic cards].
** {{audio-input}}: Input audio mode ({{none\|auto\|embedded\|aes\|analog}}). More information [here|Galicaster:Blackmagic cards].
** {{active}}: Whether the device will be played and recorded. ({{True\|False}})
** {{subdevice}}: Select a Blackmagic card from a maximum of 4 devices ({{0-3, Default: 0}})
** {{active}}: Whether the device will be played and recorded. ({{True\|False}})
** {{subdevice}}: Select a Blackmagic card from a maximum of 4 devices ({{0-3, Default: 0}})
Example:
{code:none}
[track54]
name = BlackmagicSDI
device = blackmagic
device = blackmagic
...active = True
input = sdi
input = sdi
input-mode = 4 ntsc
audio-mode = none
{code}
{align:right}{pop-top}{align}
*hauppauge*: Audio and Video device.
{anchor:hauppauge}
*hauppauge*: Audio and Video device with MPEG HW encoding
* Admitted values:
** {{name}}: Name assigned to the device.
** {{name}}: Name assigned to the device.
...** {{locpreaudio}}: Device's mount point of the PCM output
** {{file}}: The file name where the track will be recorded.
** {{file}}: The file name where the track will be recorded.
** {{vumeter}}: Whether the audio input would be represented on the vumeter. (True\|False)
** {{player}}: Whether the audio input would be played on preview. (True\|False)
** {{player}}: Whether the audio input would be played on preview. (True\|False)
** {{active}}: Whether the device will be played and recorded. ({{True\|False}})
Example:
{code:none}
Example:
{code:none}
[track15]
name = Hauppauge
device = hauppauge
device = hauppauge
...locpreaudio = /dev/haupreaudio
file = CAMERA.mpg
file = CAMERA.mpg
active = False
vumeter = True
player = True
player = True
{code}
{align:right}{pop-top}{align}
{anchor:config_profiles}
h5. Profiles
h5. Profiles
Profiles are a new feature added on Galicaster 1.2.0. Each profile contains a group of tracks that will be ran together. The syntax of a profile it's simple.
{anchor:firewire}
*firewire*: Video and audio device.
* Admmited values:
** name: Name assigned to the device.
** device: Device type: blackmagic
** 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.
** format: Input signal format. (dv\|hdv,iidc)
** vumeter: Activates data sending to the program's vumeter. (True\|False) Only one device should be activated.
** player: Whether the audio input would be played on preview. (True\|False)
*firewire*: Video and audio device.
* Admmited values:
** name: Name assigned to the device.
** device: Device type: blackmagic
** 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.
** format: Input signal format. (dv\|hdv,iidc)
** vumeter: Activates data sending to the program's vumeter. (True\|False) Only one device should be activated.
** player: Whether the audio input would be played on preview. (True\|False)
* On the data section, a name to identify the profile is set.
* The order on the track list determine the position on the preview, the first one on the list will be the first from left to right.
* The order on the track list determine the position on the preview, the first one on the list will be the first from left to right.
Example:
An example with mock devices:
{code:none}
[data] [track6]
name = Example Firewire
device = firewire
flavor = presenter
location = /dev/fw0
file = CAMERA.dv
format = dv
vumeter = True
player = True
{code}
{align:right}{pop-top}{align}
flavor = presenter
location = /dev/fw0
file = CAMERA.dv
format = dv
vumeter = True
player = True
{code}
{align:right}{pop-top}{align}
[track1]
name = Static
device = videotest
location = default
file = SCREEN.avi
flavor = presentation
caps = video/x-raw-yuv,framerate=25/1,width=640,height=480
pattern = 1
color1 = 4294967295
color2 = 4278190080
name = Static
device = videotest
location = default
file = SCREEN.avi
flavor = presentation
caps = video/x-raw-yuv,framerate=25/1,width=640,height=480
pattern = 1
color1 = 4294967295
color2 = 4278190080
[track2]
name = Bars
device = videotest
flavor = presenter
location = default
file = CAMERA.avi
caps = video/x-raw-yuv,framerate=25/1,width=640,height=480
pattern = 0
color1 = 4294967295
color2 = 4278190080
device = videotest
flavor = presenter
location = default
file = CAMERA.avi
caps = video/x-raw-yuv,framerate=25/1,width=640,height=480
pattern = 0
color1 = 4294967295
color2 = 4278190080
{anchor:videotest}
*videotest*: Mock video device.
* Admmited values:
** name: Name assigned to the device.
** device: Device type: videotest
** 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 capabilities of the device.
** pattern: type of pattern to show. Run gst-inspect-0.10 videotestsrc fore more information. (0-20)
** color1: pattern foreground color, indicated on Big endian ARGB. Run gst-inspect-0.10 videotestsrc fore more information. (0,4294967495)
** color2: pattern background color, indicated on Big endian ARGB. Run gst-inspect-0.10 videotestsrc fore more information. (0,4294967495)
* Pattern options
(0): smpte - SMPTE 100% color bars
(1): snow - Random (television snow)
(2): black - 100% Black
(3): white - 100% White
(4): red - Red
(5): green - Green
(6): blue - Blue
(7): checkers-1 - Checkers 1px
(8): checkers-2 - Checkers 2px
(9): checkers-4 - Checkers 4px
(10): checkers-8 - Checkers 8px
(11): circular - Circular
(12): blink - Blink
(13): smpte75 - SMPTE 75% color bars
(14): zone-plate - Zone plate
(15): gamut - Gamut checkers
(16): chroma-zone-plate - Chroma zone plate
(17): solid-color - Solid color
(18): ball - Moving ball
(19): smpte100 - SMPTE 100% color bars
(20): bar - Bar
{align:right}{pop-top}{align}
{anchor:audiotest}
*audiotest*: Mock audio device.
* Admitted values:
** 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` and use "Name:" as the location field.
*videotest*: Mock video device.
* Admmited values:
** name: Name assigned to the device.
** device: Device type: videotest
** 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 capabilities of the device.
** pattern: type of pattern to show. Run gst-inspect-0.10 videotestsrc fore more information. (0-20)
** color1: pattern foreground color, indicated on Big endian ARGB. Run gst-inspect-0.10 videotestsrc fore more information. (0,4294967495)
** color2: pattern background color, indicated on Big endian ARGB. Run gst-inspect-0.10 videotestsrc fore more information. (0,4294967495)
* Pattern options
(0): smpte - SMPTE 100% color bars
(1): snow - Random (television snow)
(2): black - 100% Black
(3): white - 100% White
(4): red - Red
(5): green - Green
(6): blue - Blue
(7): checkers-1 - Checkers 1px
(8): checkers-2 - Checkers 2px
(9): checkers-4 - Checkers 4px
(10): checkers-8 - Checkers 8px
(11): circular - Circular
(12): blink - Blink
(13): smpte75 - SMPTE 75% color bars
(14): zone-plate - Zone plate
(15): gamut - Gamut checkers
(16): chroma-zone-plate - Chroma zone plate
(17): solid-color - Solid color
(18): ball - Moving ball
(19): smpte100 - SMPTE 100% color bars
(20): bar - Bar
{align:right}{pop-top}{align}
{anchor:audiotest}
*audiotest*: Mock audio device.
* Admitted values:
** 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` and use "Name:" as the location field.
{code}
** file: The file name where the track will be recorded.
** wave: Generated waveform sample. Run gst-inspect-0.10 audiotestsrc fore more information. (0-12)
** frequency: Test signal central frequency. (0-20000)
** volume: Percent volume of the pattern. (0-1)
** 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. (0-10)
** player: Whether the audio input would be played on preview. (True\|False)
** wave: Generated waveform sample. Run gst-inspect-0.10 audiotestsrc fore more information. (0-12)
** frequency: Test signal central frequency. (0-20000)
** volume: Percent volume of the pattern. (0-1)
** 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. (0-10)
** player: Whether the audio input would be played on preview. (True\|False)
Profiles can be switched anytime, if the configuration is wrong or a device is disconnected a message will appear when entering the Recorder Area. To edit any profile, better leave the program to reload them.
* Wave options
(0): sine - Sine
(1): square - Square
(2): saw - Saw
(3): triangle - Triangle
(4): silence - Silence
(5): white-noise - White uniform noise
(6): pink-noise - Pink noise
(7): sine-table - Sine table
(8): ticks - Periodic Ticks
(9): gaussian-noise - White Gaussian noise
(10): red-noise - Red (brownian) noise
(11): blue-noise - Blue noise
(12): violet-noise - Violet noise
{align:right}{pop-top}{align}
(0): sine - Sine
(1): square - Square
(2): saw - Saw
(3): triangle - Triangle
(4): silence - Silence
(5): white-noise - White uniform noise
(6): pink-noise - Pink noise
(7): sine-table - Sine table
(8): ticks - Periodic Ticks
(9): gaussian-noise - White Gaussian noise
(10): red-noise - Red (brownian) noise
(11): blue-noise - Blue noise
(12): violet-noise - Violet noise
{align:right}{pop-top}{align}