The following instructions are only applicable to desktop Linux. For Raspberry PI,
download the daily-built Raspberry PI package
.
1. Ubuntu
Packages are already available for
Ubuntu 16.04 or newer ONLY as Ekos now depends on KDE Frameworks 5.10+:
Ubuntu 16.04+: x86, x64, and ARMHF versions avaiable:
$ sudo apt-add-repository ppa:mutlaqja/ppa
$ sudo apt-get update
If you have Ubuntu 16.04 or higher, you can install kstars-bleeding which will install KStars, Ekos, libindi, and
all 3rd party drivers.
$ sudo apt-get -y install kstars-bleeding indi-bin indi-full
It is highly recommended to install the debug symbols as well to help diagnosing any issues with KStars/Ekos$ sudo apt-get install -y kstars-bleeding-dbg indi-dbg
<em>If you plan to use the CCD Simulator, you should download the General Star Catalog (GSC) as it is used to generate the simulated star maps</em>
$ sudo apt-get install gsc
2. Building INDI from Source
To build libindi, first install the following packages:
$ sudo apt-get -y install libnova-dev libcfitsio-dev libusb-1.0-0-dev zlib1g-dev libgsl-dev build-essential cmake git libjpeg-dev libcurl4-gnutls-dev libtheora-dev libfftw3-dev
Now that all the prerequisites are installed, you are ready to build libindi:
mkdir -p ~/Projects/build/indi-core
cd ~/Projects
git clone --depth=1 https://github.com/indilib/indi.git
cd build/indi-core
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug ~/Projects/indi
sudo make install
To update the libindi source code in the future, just go libindi source directory (e.g. ~/Projects/libindi) and type
git pull. After the code is updated, go to the build/libindi directory and run
sudo make install.
3. Building 3rd party INDI drivers
Some INDI drivers are only available as 3rd party modules (such as EQMod and all CCD drivers). To build and install 3rd party drivers:
sudo apt-get -y install libnova-dev libcfitsio-dev libusb-1.0-0-dev zlib1g-dev libgsl-dev build-essential cmake git libjpeg-dev libcurl4-gnutls-dev libtiff-dev libfftw3-dev libftdi-dev libgps-dev libraw-dev libdc1394-22-dev libgphoto2-dev libboost-dev libboost-regex-dev librtlsdr-dev liblimesuite-dev libftdi1-dev libavcodec-dev libavdevice-dev
After installation of the packages is complete, then:
cd ~/Projects
git clone --depth=1 https://github.com/indilib/indi-3rdparty.git
mkdir -p build/indi-eqmod
cd build/indi-eqmod
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug ~/Projects/indi-3rdparty/indi-eqmod
Then follow the detailed instructions in README.
4. Building KStars from Source
Assuming you built and installed libindi as instructed above, you can proceed to build KStars from source. You need to install the following packages:
Now that all the prerequisites are installed, you are ready to build KStars:
$ mkdir ~/Projects/build/kstars
$ cd ~/Projects
$ git clone git://anongit.kde.org/kstars.git
$ cd build/kstars
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug ~/Projects/kstars
$ make
$ sudo make install
To update the KStars source code in the future, just go KStars source directory (~/Projects/kstars) and type
git pull. After the code is updated, go to the build/kstars directory and run
sudo make install.