2. Installing eCAL#
Before using eCAL, you must install it on your PC. This section covers how to install eCAL on Microsoft Windows and Ubuntu (both 64 bit only). You can either use eCAL just on one PC (local communication) or on multiple PCs (cloud communication). We will cover both scenarios in the next sections.
So, let’s get started!
See also
If you are looking for a tutorial on how to build eCAL from source (e.g. to get it working on a non-supported OS) please refer to Building eCAL from source .
2.1. Installing eCAL on Windows#
Choose your desired eCAL Version from the eCAL Download Archive and download the Windows installer. New users should download the latest Version.
Install eCAL with default options (Full installation):
2.2. Installing eCAL on Ubuntu#
For Ubuntu, you can either install eCAL from a PPA (Personal Package Archive) or manually from debian files. For most users, the PPA will provide the easiest way of installing eCAL. The PPA also supports more Ubuntu Versions and CPU Architectures (x86, x64, arm64, armhf).
Ubuntu 22.04 Users: You may experience issues with the GUI Applications (actually all Qt5 Apps) due to Ubuntus switch to wayland. But you can log in with X11, which solves those issues.
See also
Advanced users can also compile eCAL from source.
2.2.1. Automatically install eCAL from a PPA#
Installing eCAL from a PPA will cause apt-get to automatically update eCAL for you. You can choose from different PPAs, depending on your desired upgrade path.
This is the rolling release PPA. It will always upgrade your installation and you will always receive the latest-and-greatest eCAL version.
sudo add-apt-repository ppa:ecal/ecal-latest
sudo apt-get update
sudo apt-get install ecal
Also check out this PPA on Launchpad!
This PPA will always stay on eCAL 5.13. You will receive patches as long as eCAL 5.13 is supported. If you want to upgrade to a new eCAL Version, you will have to manually add the new PPA.
At the moment, eCAL 5.13 is the latest supported version.
sudo add-apt-repository ppa:ecal/ecal-5.13
sudo apt-get update
sudo apt-get install ecal
Also check out this PPA on Launchpad!
This PPA will always stay on eCAL 5.12. You will receive patches as long as eCAL 5.12 is supported. If you want to upgrade to a new eCAL Version, you will have to manually add the new PPA.
At the moment, eCAL 5.12 is the supported legacy-version. Support will be dropped when the next eCAL Version is released.
sudo add-apt-repository ppa:ecal/ecal-5.12
sudo apt-get update
sudo apt-get install ecal
Also check out this PPA on Launchpad!
This PPA will always stay on eCAL 5.11. If you want to upgrade to a new eCAL Version, you will have to manually add the new PPA.
eCAL 5.11 is not supported any more and will not receive patches. You can still use the PPA to install the latest eCAL 5.11. Please consider upgrading to a newer version.
sudo add-apt-repository ppa:ecal/ecal-5.11
sudo apt-get update
sudo apt-get install ecal
Also check out this PPA on Launchpad!
2.2.2. Manually install eCAL from a .deb file#
Warning
We usually recommend installing from a PPA (see above).
Choose your desired eCAL Version from the eCAL Download Archive.
Install the eCAL Dependencies:
Ubuntu 18.04:
sudo apt update sudo apt install libc6 libcurl4 libgcc1 libhdf5-100 libprotobuf10 libqt5core5a libqt5gui5 libqt5widgets5 libqt5svg5 libstdc++6 sysstat ifstat libqwt-qt5-6 libyaml-cpp0.5v5
Ubuntu 20.04:
sudo apt update sudo apt install libc6 libcurl4 libgcc-s1 libhdf5-103 libprotobuf17 libqt5core5a libqt5gui5 libqt5widgets5 libqt5svg5 libstdc++6 sysstat ifstat libqwt-qt5-6 libyaml-cpp0.6
Ubuntu 22.04:
sudo apt update sudo apt install libc6 libcurl4 libgcc-s1 libhdf5-103 libprotobuf23 libqt5core5a libqt5gui5 libqt5widgets5 libqt5svg5 libstdc++6 sysstat ifstat libqwt-qt5-6 libyaml-cpp0.7
Install the debian package:
sudo dpkg -i ecal_*.deb