We maintain Siril binaries in many operating systems, but in general only for the official releases. If your operating system has no binary version or if you want to customize it, you will have to build it from source.
Installing Siril from binaries
apt install siril
Ubuntu & Linux Mint
sudo apt-get install siril
On Ubuntu 16.04 and Linux Mint 18.X, for a newer and less stable version that the one provided on official repositories, there is a PPA:
sudo add-apt-repository ppa:lock042/siril sudo apt-get update sudo apt-get install siril
Mac OS X
Installation via Homebrew (recommended method since 0.9.5)
An official installer for Mac exists, see the download page. This is the way to install siril from source, to test the latest development version for example.
- Removing Siril from macport if exists
If Siril was already installed via macport, uninstall it (if not, go directly to next step):
cd siril sudo make uninstall
It is also recommended to uninstall macports. To do it, visit this page: https://guide.macports.org/chunked/installing.macports.uninstalling.html
- Installation of Homebrew
More details are listed on Homebrew website: https://brew.sh/
First, install XCode via the App Store (free software) and install the command line tools by typing in a Terminal window:
Then, you can install Homebrew.
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
The script explains what it will do and then pauses before it does it.
- Installation of Siril
Copy the following line in the terminal :
brew install siril
When a new version of Siril is available, copy this line to the terminal:
brew upgrade siril
and download the new
Installation from source
Installation from source is recommended if you want the latest features, if the past release is getting old or if you want to participate in improving Siril. Many users are reporting tweaks they would like, and we often implement them rapidly, so that would be one way to benefit from them. The other way is to use the Ubuntu PPA repository, which is updated with intermediate versions more often.
The sources are stored on a git repository, you can download them with this command the first time:
git clone https://gitlab.com/free-astro/siril.git cd siril git submodule update --init
And update it the following times by typing
git pull in the base directory.
Below is a list of dependencies. Siril can be compiled either using autotools or meson. The autotools ways is well known in the unix world, once the source has been downloaded and the prerequisites have been installed, the general way to build it is as such:
./autogen.sh make make install
possibly with superuser privileges.
You may want to pass specific options to the compiler, for example like that if you want optimisation and installation in /opt instead of the default /usr/local:
CFLAGS='-mtune=native -O3' ./autogen.sh --prefix=/opt
To launch Siril, the command name is
The other, newer (since version 0.99.4), way is to use meson and ninja:
mkdir _build meson --buildtype release _build cd _build ninja ninja install
Siril depends on a number of libraries, most of which should be available in your operating system if it is recent enough. The names of the packages specific to operating systems are listed in each section below. Mandatory dependencies are:
- gtk+3 (Graphical user interface library), at least version 3.20
- cfitsio (FITS images support)
- fftw (Discrete Fourier Transform library)
- gsl (The GNU Scientific Library), version 1 or 2 starting with release 0.9.1 or SVN revision 1040
- libconfig (Structured configuration files support)
- OpenCV and a C++ compiler for some image operations
- Exiv2 to manage image metadata.
- libjson-glib from GNOME, to parse JSON text for update checking and more soon.
Note: even if Siril can run in console since version 0.9.9, it is still linked against the graphical libraries, so you still need GTK+ to compile and run it.
Optional dependencies are:
- libraw, libtiff, libjpeg, libpng, libheif for RAW, TIFF, JPEG, PNG and HEIF images import and export. The libraries are detected at compilation-time.
- FFMS2 for film native support as image sequences. It also allows frames to be extracted from many kinds of film, for other purposes than astronomy. Versions < 2.20 have an annoying bug. It is recommended to install the latest version.
- ffmpeg (or libav), providing libavformat, libavutil (>= 55.20), libavcodec, libswscale and libswresample for mp4 sequence export
- libcurl for new Siril release checking online.
- gnuplot for photometry graph creation (not required at compilation time)
To install from source, you will have to install the base development packages:
git, autoconf, automake, libtool, intltool, pkg-tools, make, cmake, gcc, g++
The compilers gcc and g++ from this list can be replaced by clang and clang++ (we use them for development), probably others as well.
The autotools packages (autoconf, automake, probably some others) can be replaced by meson.
Installing on Debian
For a desktop system, the next stable is probably the better choice, called Debian testing, currently version 10 with codename Buster. Otherwise, Siril should still work with Debian 8 Jessie and 9 Stretch. You may want to build a .deb package instead of using a non-packaged version, in that case see this help. In particular, to install dependencies, you can use the command:
apt build-dep siril
Otherwise, here is the list of packages for the current version:
- Packages required for the build system:
autoconf automake make gcc g++ libtool intltool pkg-config
- List of packages for mandatory dependencies:
libfftw3-dev libgsl-dev libcfitsio-dev libgtk-3-dev libconfig-dev libopencv-dev
- List of packages for optional dependencies:
libcurl4-gnutls-dev libpng-dev libjpeg-dev libtiff5-dev libraw-dev libavformat-dev libavutil-dev libavcodec-dev libswscale-dev libswresample-dev
for film input (AVI and others) support:
Note that libtiff5 is incompatible with OpenCV in debian 7, in that case you need to install libtiff4 instead. And in debian 8,
libjpeg8-dev has been replaced by
libjpeg62-turbo-dev, which is also installed by
For debian 10 and siril 1.0, here's a complete list of packages to install to build from git (adding git, cmake, libexiv2-dev):
git autoconf automake make gcc g++ libtool intltool pkg-config cmake libfftw3-dev libgsl-dev libcfitsio-dev libgtk-3-dev libconfig-dev libopencv-dev libcurl4-gnutls-dev libpng-dev libjpeg-dev libtiff5-dev libraw-dev libavformat-dev libavutil-dev libavcodec-dev libswscale-dev libswresample-dev libexiv2-dev
For the float branch, and soon the master, a submodule must be initialised before calling autogen:
$ git submodule update --init
Installing on Ubuntu & Linux Mint
A list of dependencies has been reported, for building the executable from source. Use the following command to install all of them:
- Ubuntu 14.04 & Linux Mint 17.X
sudo apt-get -y install automake autoconf build-essential intltool libgtk-3-dev fftw3-dev libgsl0-dev libcfitsio3-dev libconfig-dev libtiff-dev libjpeg-dev libraw-dev libffms2-dev libopencv-dev libcurl4-gnutls-dev
- Ubuntu 16.04 & Linux Mint 18.X
sudo apt-get -y install automake autoconf build-essential intltool libgtk-3-dev fftw3-dev libgsl-dev libcfitsio3-dev libconfig-dev libtiff-dev libjpeg-dev libraw-dev libffms2-dev libopencv-dev libcurl4-gnutls-dev
- Ubuntu 18.04, 20.04 & Linux Mint 19.X (for Siril 0.99 and above)
sudo apt -y install automake autoconf build-essential intltool libgtk-3-dev libfftw3-dev libgsl-dev libcfitsio-dev libconfig-dev libtiff-dev libjpeg-dev libraw-dev libffms2-dev libopencv-dev libcurl4-gnutls-dev libexiv2-dev cmake gnome-icon-theme git libjson-glib-dev
Then proceed with the normal procedure:
./autogen.sh make sudo make install
Installing on Fedora
dnf install intltool libconfig-devel gtk3-devel fftw3-devel gsl-devel cfitsio-devel LibRaw-devel opencv-devel curl-devel autoconf automake
Then proceed with the normal procedure:
and, with superuser privileges
Installing on Arch Linux
Vincent maintains a release-based AUR package and a development version AUR package for Siril. Download the PKGBUILD or the repository, install dependencies, run makepkg to build the package and pacman -U to install it.
pacman -S base-devel cmake git intltool gtk3 fftw cfitsio gsl libconfig opencv exiv2 libheif libraw
Installing on FreeBSD 10
The list of dependencies is basically the same as for other OS, below are a list for build dependencies and a list of Siril dependencies:
pkg install autotools gmake pkgconf libtool intltool gettext libconfig gtk3 fftw3 gsl cfitsio libraw opencv curl
The only package not available as binary is ffms2, for film files handling, you will need to compile it from source.
Compilation and the software are working fine with the default clang (
cc) compiler. As clang 3.8 appeared in FreeBSD 10 with OpenMP support (clang38 in pkg), Siril can be compiled with it using the following configure command:
C=clang38 CXX=clang++38 LD=clang++38 LDFLAGS='-L/usr/local/llvm38/lib' ./autogen.sh
It is also possible to install gcc 4.8 or gcc 5 in FreeBSD. Make sure to link with the OS official compiler however, cc or c++ and not gcc or g++, otherwise the generated binary will be incorrect. That's also why the
-lgomp is required to link it:
CC=gcc5 LDFLAGS="-Wl,-rpath=/usr/local/lib/gcc5 -L/usr/local/lib/gcc5 -lgomp" ./autogen.sh
Installing on Mac OS X
Deprecated method, via macport
Install XCode via the App Store (free software).
Install XQuartz via http://xquartz.macosforge.org/landing/ (free software)
Install the command line tools by typing in a Terminal window:
Install the MacPorts software (free): http://www.macports.org (Follow the installation instructions on this site.)
The following is done in a Terminal window. One should first install some libraries:
sudo port install gcc49 sudo port install automake sudo port install autoconf sudo port install gtk3 sudo port install gnome-themes-standard sudo port install librsvg sudo port install cfitsio sudo port install fftw-3 sudo port install gsl sudo port install libconfig-hr sudo port install gnome-font-viewer
Now we want to make available multithreading in cfitsio: In the following directory:
Edit the file: Portfile
Change the line
configure.cflags -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64
configure.cflags -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_REENTRANT
sudo port uninstall cfitsio sudo port -s install cfitsio
Also install some optional dependencies (recommanded):
sudo port install libraw sudo port install tiff sudo port install libpng sudo port install opencv
Now you can manually install
libjpeg (if you want to work with JPEG files):
curl --remote-name http://www.ijg.org/files/jpegsrc.v9a.tar.gz tar -xzvf jpegsrc.v9a.tar.gz cd jpeg-9a ./configure --prefix=/usr/local make sudo make install
Now you can manually install giflib (if you want to be able to export GIF files) which is too old in macport: Download giflib sources at this url:
and put the file in your home directory
tar -jxvf giflib-5.1.2.tar.bz2 cd giflib-5.1.2 ./configure make sudo make install
Install the ffms2 library which is not present in MacPorts. Download it here: https://github.com/FFMS/ffms2, in the ffms2 folder, type from the terminal:
./configure --prefix=/opt/local make sudo make install
Download the SIRIL sources:
git clone https://gitlab.com/free-astro/siril.git
In the terminal go to the siril folder:
Generate the configure file by typing:
To install Siril, use the usual:
sudo make install
Installing on Windows
These instructions are made for compiling on Windows with MSYS2 distribution using MinGW. MSYS2 requires 64 bit Windows 7 or newer, and does not work with FAT filesystems.
Download MSYS2 64bit, a software distribution and building platform for Windows and run the installer - "x86_64" for 64-bit. When asked, specify the directory where MSYS2 64bit will be installed.
Run MSYS2 directly from the installer or later "MSYS2 MinGW 64 bit" from Start menu or shortcut.
First, update the package database and core system packages by typing (for more info about pacman see this page):
Installing dependencies: Note: automake is the legacy (stable) build method, now being replaced by meson (experimental) build system.
pacman -S --needed base-devel mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake git automake mingw-w64-x86_64-meson mingw-w64-x86_64-ninja mingw-w64-x86_64-gtk3 mingw-w64-x86_64-cfitsio mingw-w64-x86_64-fftw mingw-w64-x86_64-gsl mingw-w64-x86_64-libconfig mingw-w64-x86_64-opencv mingw-w64-x86_64-exiv2 mingw-w64-x86_64-json-glib
Warning: meson will need a restart of MSYS2 to be usable.
Also install some optional dependencies (recommended):
pacman -S mingw-w64-x86_64-libraw mingw-w64-x86_64-libheif mingw-w64-x86_64-ffms2 mingw-w64-x86_64-curl
Building Siril from source:
The source code is stored on a gitlab repository, you can download it with this command the first time:
git clone https://gitlab.com/free-astro/siril.git cd siril git submodule update --init
Now, meson and ninja are the official way to build siril on Windows: Generate the build system and compile the code by typing:
meson _build ninja -C _build install
To launch your build of Siril:
Run MSYS2 64bit and type siril's command name:
You can also create a shortcut to siril.exe to start it, the default location is /mingw64/bin/.
To update your version:
Run MSYS2 64bit then
pacman -Syu cd siril git pull --recurse-submodules meson _build ninja -C _build install
If git pull does not show any change, there is no need to rebuild by running the make command. Otherwise, it will update your build.
After that just launch the build by typing siril