1.0.x Galicaster Configuration

The conf.ini file is 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:

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
  - True: Apart from recording, the user can edit metadata, play and manage the recordings. Galicaster will behave as a Galicaster Mobile
- repository: absolute path to the working folder. If not specified, a Repository directory in the user's home will be used.
- Example:
```
[basic]
admin = True
repository = /mnt/videos/Repository
```

Section 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 mouse pointer. Useful if using a tactile screen (True|False)
- Example:
```
[screen]
right = Epiphan
left = Hauppauge
cursor = True
```

Section ingest
- active: Enables the connection to a Opencast-Matterhorn server (True|False).
- default: Enables the night ingestion of the recordings (True|False)
- username: Matterhorn server URL.
- host: Account used to operate the Matterhorn REST endpoints.
- password: Password for the account used to operate the Matterhorn REST endpoints.
- workflow: Name of the Matterhorn Workflow to be run after the ingestion.
- Example:
```
[ingest]
active = True
default = True
username = matterhorn_system_account
host = http://admin.matterhorn.es:8080
password = CHANGE_ME
workflow = full
```

Section allows
- manual: Allows full manual control of the recordings. (True|False)
- start: If manual is false, recordings can be started manually. (True|False)
- stop: If manual is false, recordings can be stopped manually -also the scheduled ones. (True|False)
- pause: Allows pausing a recording -independently from the value of manual. (True|False)
- overlap: If activated, a manual recording takes priority over a scheduled one, meaning it will not stop when the scheduled one should start. Otherwise, the manual recording will be stopped and the scheduled one started.(True|False)
- Example:
```
[allows]
manual = True
start = False
stop = False
pause = True
overlap = False
```

Section trackN
- A section per device used in the capturer. Each section is set according to the device type: hauppauge, pulse, v4l2 or vga2usb:
  - hauppauge: Audio and Video device.
    - Admitted values:
      - name: Name assigned to the device.
      - device: Device type: hauppauge
      - flavor: Matterhorn "flavor" associated to the track. (presenter|presentation|other)
      - location: Device's mount point of the MPEG output
      - locprevideo: Device's mount point of the RAW output
      - locpreaudio: Device's mount point of the PCM output
      - file: The file name where the track will be recorded.
      - active: Whether the device will be played and recorded. (True|False)
    - Example:
      [track1] name = Hauppauge device = hauppauge flavor = presenter location = /dev/haucamera locpreavideo = /dev/hauprevideo locpreaudio = /dev/haupreaudio file = CAMERA.mpg active = False
  - pulse: 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:
        
        $ 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)
      - 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:
      [track3] name = AudioSource device = pulse flavor = presenter location = default file = sound.mp3 active = False vumeter = Active amplification = 2.0
  - v4l2: Video device
    - Admitted values:
      - name: Name assigned to the device.
      - device: Device type: v4l2
      - 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 cappabilities of the device (mimetype=TYPE, framerate=X/Y,width=A,height=B)
        TYPE: (image/jpeg | video/x-raw-yuv)
        Use GVUCView tool to know wich capabilities are compatible with your device
        For more information http://pygstdocs.berlios.de/pygst-tutorial/capabilities.html
      - 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).
    - Example:
      [track4] name = Webcam device = v4l2 flavor = presenter location = /dev/webcam file = WEBCAM.avi active = False caps = image/jpeg,framerate=25/1,width=1280,height=720 videocrop-left = 160 videocrop-right = 160
  - vga2usb: Video device
    - Admitted values:
      - name: Name assigned to the device.
      - device: Device type: vga2usb
      - 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)
      - drivertype: Wheter the device use a v4l or a v4l2 interface to guarantee compatibility (v4l|v4l2)
        As for Ubuntu 10.10 (recommended OS) use v4l.
    - Example:
      [track2] name = Epiphan device = vga2usb flavor = presentation location = /dev/screen file = SCREEN.avi active = True drivertype = v4l
  - Blackmagic: Video device
    - Admitted values:
      - name: Name assigned to the device.
      - device: Device type: blackmagic
      - flavor: Matterhorn "flavor" associated to the track. (presenter|presentation|other)
      - 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 mode and framerate (1-20). More information here.
    - Example:
      [track5] name = BlackmagicSDI device = blackmagic flavor = presenter file = CAMERA.avi active = True input = sdi input-mode = 4

1.0.x Galicaster Configuration

Labels