Skip to content
Branch: master
Find file Copy path
Find file Copy path
2 contributors

Users who have contributed to this file

@dpeite @Alfro
111 lines (82 sloc) 6.22 KB

Software installation

This page is updated to the 2.1 version

Installation process

The installation process consists of 5 simple steps:

  1. Check the prerequisites.
  2. Install the software.
  3. Setup config directory
  4. Install and configure drivers.( optional )
  5. Run Galicaster for the first time.

After installing Galicaster, the next step is configuring it. You can take a look at the Configuration Guide.

Step 1: Check the prerequisites

Before starting the installation process, please make sure that:

  • Your unit meets Galicaster Hardware Recommendations.
  • You are running a Linux-based OS. The recommended distribution is Ubuntu 16.04. Make sure that the version chosen matches your system architecture (32 or 64 bits). If using the recommended Linux OS, check the following guide: How to install Ubuntu.
  • galicaster is the default user in the system.
forbbiden Important
Due to a bug in Gstreamer v4l2 library, present in the 1.8.3 version, it is necessary to install our patched version from our repositories, or to compile the latest GStreamer 1.10.3 version manually. We have included the installation of the patched version in our installation instructions.

Step 2: Install the software

There are two options to install Galicaster:

By installing or downloading Galicaster, you agree to the non-commercial license. (Commercial licenses also available under request)

Using the Galicaster repository

Installation instructions using the galicaster repository are as follows:

Info Info
Remember to install the system using the galicaster user
echo "deb xenial main" | sudo tee --append /etc/apt/sources.list.d/galicaster.list
wget -O -  | sudo apt-key add -
sudo apt-get update
sudo apt-get install gstreamer1.0-plugins-good gir1.2-gstreamer-1.0 #Required to solve #298 and #29
sudo apt-get install galicaster

If you are upgrading from a previous 2.0 version, you just need to execute

sudo apt-get update
sudo apt-get install gir1.2-gstreamer-1.0 gstreamer1.0-plugins-good #Required to solve #298 and #29
sudo apt-get install galicaster

Source code

As an alternative, you can install Galicaster from the source code. Stable versions are available on the Release Archive.. Stable and development versions, as well as development information, are available in our Git repository.

Installing a source code version requires installing its dependencies manually. If a repository installation is also present, conf.ini and the profiles will be read from the folder /etc/galicaster. Otherwise, the ones in the installation folder will be used.


Galicaster depends on the following modules and libraries:

python python-pip python-setuptools python-dev python-pycurl python-bottle python-glade2 python-icalendar python-gi python-dbus python-simplejson python-ldap python-serial
gstreamer1.0-plugins-base gstreamer1.0-plugins-base-apps gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-plugins-good gstreamer1.0-alsa gstreamer1.0-libav gstreamer1.0-pulseaudio
gir1.2-gstreamer-1.0 gir1.2-gtk-3.0 gir1.2-gst-plugins-base-1.0
onboard onboard-data
libsasl2-dev libldap2-dev libssl-dev
Adding a launcher

You can easilly add a launcher to a manual installation by creating a file at /usr/local/bin/ containing the following command:

python <path>/

where <path> is the directory where you downloaded galicaster source code.

Info Info
For testing devices, specially webcams and V4L2-compatible devices, other software may be installed as well:
  • guvcview (apt)
  • v4l-utils (apt)
  • Step 3: Setup config directory

    Galicaster will be installed in /usr/share/galicaster . The configuration files and profiles folder will be placed at /etc/galicaster/. In order to editIn order to get Galicaster ready to go, it would be useful running this command to put the right file owners:

    sudo chown -R galicaster:galicaster /etc/galicaster

    Step 4: Install and configure drivers (Optional)

    Depending on the hardware you have chosen to run Galicaster with, you may need to install and configure its drivers.

    Check our Compatible hardware and visit your device manufacturer's Driver & Info websites for information on how to install and configure the drivers.

    Info Info
    If you have purchased a Galicaster unit, the drivers are already installed.

    Step 5: Run Galicaster for the first time

    Once installed, Galicaster is ready to run. You may start Galicaster by:

    • Opening a terminal and executing galicaster.
    • Find Galicaster under Applications in the Unity Menu. You can also add Galicaster to your Unity sidebar, place a link at the Desktop or include it as a startup application.

    The default Input Profile consists of two mock video sources and a mock audio source. You can try recording from them, edit its metadata and check if the media is listed in the Media Manager.

    You can’t perform that action at this time.