This page is updated to the 2.0.0 release
The installation process consists of 5 simple steps:
- Check the prerequisites.
- Install the software.
- Setup config directory
- Install and configure drivers.( optional )
- Run Galicaster for the first time.
After installing Galicaster, the next step is configuring it. You can take a look at the Configuration Guide.
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.
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. |
There are two options to install Galicaster:
- Install through our repository. This is the recommended option for newcomers.
- Clone the source code and install manually.
By installing or downloading Galicaster, you agree to the non-commercial license. (Commercial licenses also available under request)
Installation instructions using the galicaster repository are as follows:
Info |
---|
Remember to install the system using the galicaster user |
echo "deb https://packages.galicaster.org/apt xenial main" | sudo tee --append /etc/apt/sources.list.d/galicaster.list
wget -O - https://packages.galicaster.org/apt/galicaster.gpg.key | sudo apt-key add -
sudo apt-get update
sudo apt-get install gstreamer1.0-plugins-good #Required due to gstreamer error
sudo apt-get install galicaster
If you are upgrading from a previous 2.0-RCX version, you just need to execute
sudo apt-get update
sudo apt-get install gstreamer1.0-plugins-good #Required due to gstreamer error
sudo apt-get install galicaster
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
You can easilly add a launcher to a manual installation by creating a file at /usr/local/bin/
containing the following command:
python <path>/run_galicaster.py
where <path>
is the directory where you downloaded galicaster source code.
Info |
---|
For testing devices, specially webcams and V4L2-compatible devices, other software may be installed as well:guvcview (apt) v4l-utils (apt) |
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
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 |
---|
If you have purchased a Galicaster unit, the drivers are already installed. |
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.