(Marked this version for translation)
(Marked this version for translation)
 
(130 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<languages />
 
<languages />
 
<translate>
 
<translate>
 +
 +
<!--T:98-->
 +
We maintain Siril binaries in many operating systems, but in general only for the official releases, like the last one: [[Siril:0.9.9|0.9.9]]. If your operating system has no binary version, you will have to build it [[#Installation_from_source|from source]] yourself.
 +
 
=Installing Siril from binaries= <!--T:1-->
 
=Installing Siril from binaries= <!--T:1-->
  
<!--T:40-->
+
==Debian[[File:Debian_logo.png|48px|frameless|link=|middle]]== <!--T:78-->
Siril is currently available as binaries only for the released packages like [[Siril:0.9.1|0.9.1]]. The binary package is available on Debian [https://packages.debian.org/stretch/siril testing] and [https://packages.debian.org/sid/siril unstable], on many architectures. It is also available on Ubuntu [http://packages.ubuntu.com/vivid/siril wily] and [http://packages.ubuntu.com/vivid/siril vivid].
+
The binary package is available on Debian [https://packages.debian.org/stretch/siril testing] and [https://packages.debian.org/sid/siril unstable].
 +
It should be installed via repositories, with superuser privileges:
 +
    apt install siril
 +
 
 +
==Ubuntu & Linux Mint[[File:Ubuntu_logo.png|48px|frameless|link=|middle]][[File:LMint_logo.png|48px|frameless|link=|middle]]== <!--T:80-->
 +
===Official repositories===
 +
    sudo apt-get install siril
 +
===PPA repositories===
 +
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
  
<!--T:42-->
+
==Mac OS X[[File:OSX_logo.png|48px|frameless|link=|middle]]== <!--T:91-->
For other operating systems, please use the source method below. '''Windows is completely unsupported'''. If you can, consider making an installation process or a package for your operating system. A Mac OS X binary package may become available in the coming weeks.
+
 
 +
===Installation via Homebrew (recommended method since 0.9.5)=== <!--T:83-->
 +
 
 +
<!--T:117-->
 +
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.
 +
 
 +
<!--T:118-->
 +
*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
 +
 
 +
<!--T:89-->
 +
It is also recommended to uninstall macports. To do it, visit this page: https://guide.macports.org/chunked/installing.macports.uninstalling.html
 +
 
 +
<!--T:90-->
 +
*Installation of Homebrew
 +
More details are listed on Homebrew website: https://brew.sh/
 +
 
 +
<!--T:84-->
 +
First, install XCode via the App Store (free software) and install the command line tools by typing in a Terminal window:
 +
    xcode-select --install
 +
 
 +
<!--T:85-->
 +
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.
 +
 
 +
<!--T:86-->
 +
*Installation of Siril
 +
Copy the following line in the terminal :
 +
    brew install siril
 +
 
 +
<!--T:97-->
 +
*Updates
 +
When a new version of Siril is available, copy this line to the terminal:
 +
    brew upgrade siril
 +
and download the new <code>.app</code> file.
 +
 
 +
<!--T:96-->
 +
Enjoy!!
 +
 
 +
<!--T:87-->
 +
[[File:Siril_on_MacOS_brew.png|600px]]
  
 
=Installation from source= <!--T:43-->
 
=Installation from source= <!--T:43-->
 
+
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.
<!--T:44-->
 
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 very rapidly, so that would be the only way to benefit from it.
 
  
 
<!--T:45-->
 
<!--T:45-->
The sources are stored on a subversion repository, you can download them with this command the first time:
+
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
<!--T:46-->
 
<tt>svn co https://free-astro.org/svn/siril/branches/0.9/ siril</tt>
 
  
 
<!--T:47-->
 
<!--T:47-->
And update it the following times by typing <tt>svn up</tt> in the base directory.
+
And update it the following times by typing <code>git pull</code> in the base directory.
  
 
<!--T:48-->
 
<!--T:48-->
Below is a list of dependencies. Siril relies on the autotools compilation configuration system and once the source has been downloaded and the system is ready, the general way to build it is as such:
+
Below is a list of dependencies. Siril relies on the autotools compilation configuration system and once the source has been downloaded and the prerequisites have been installed, the general way to build it is as such:
 
+
    ./autogen.sh
<!--T:49-->
+
    make
<tt>$ autoreconf -fi<br/>
+
    make install
$ ./configure<br/>
+
possibly with superuser privileges.
$ make<br/>
 
$ make install</tt> possibly with superuser privileges.
 
  
 
<!--T:50-->
 
<!--T:50-->
 
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:
 
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 -O2' ./autogen.sh --prefix=/opt
<!--T:51-->
 
<tt>CFLAGS='-mtune=native -O2' ./configure --prefix=/opt</tt>
 
 
 
<!--T:52-->
 
 
To launch Siril, the command name is <code>siril</code>.
 
To launch Siril, the command name is <code>siril</code>.
  
 
==Dependencies== <!--T:53-->
 
==Dependencies== <!--T:53-->
 
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:
 
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:
* [http://www.gtk.org/ gtk+-3.6] (Graphical user interface library)
+
* [http://www.gtk.org/ gtk+3] (Graphical user interface library), at least version 3.16
 
* [http://heasarc.nasa.gov/fitsio/fitsio.html cfitsio] (FITS images support)
 
* [http://heasarc.nasa.gov/fitsio/fitsio.html cfitsio] (FITS images support)
 
* [http://www.fftw.org/ fftw] (Discrete Fourier Transform library)
 
* [http://www.fftw.org/ fftw] (Discrete Fourier Transform library)
* [http://www.gnu.org/software/gsl/ gsl-1.*] (The GNU Scientific Library), version 2 is supported starting with release 0.9.1 and SVN revision 1040.
+
* [http://www.gnu.org/software/gsl/ gsl] (The GNU Scientific Library), version 1 or 2 starting with release 0.9.1 or SVN revision 1040.
* [http://www.hyperrealm.com/libconfig/ libconfig]++ (Structured configuration files support)
+
* [https://hyperrealm.github.io/libconfig/ libconfig] (Structured configuration files support)
 +
* [http://opencv.org/ OpenCV] and a C++ compiler for some image operations.
 +
 
 +
<!--T:99-->
 +
''Note:'' even if Siril [[Siril:0.9.9|0.9.9]] can run in console, it is still always linked against the graphical libraries. So you still need GTK and X11 or wayland client to compile and run it.
  
 
<!--T:54-->
 
<!--T:54-->
 
Optional dependencies are:
 
Optional dependencies are:
* [http://www.libraw.org/ libraw], [http://www.libtiff.org/ libtiff], [http://libjpeg.sourceforge.net/ libjpeg], [http://libpng.sourceforge.net/index.html libpng] for RAW, TIFF, JPEG and PNG images import and export. The libraries are detected at compilation-time.
+
* [http://www.libraw.org/ libraw], [http://www.libtiff.org/ libtiff], [http://libjpeg.sourceforge.net/ libjpeg], [http://libpng.sourceforge.net/index.html libpng] for RAW, TIFF, JPE, PNG and images import and export. The libraries are detected at compilation-time.
 
* [https://github.com/FFMS/ffms2 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 recommanded to install the last version.
 
* [https://github.com/FFMS/ffms2 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 recommanded to install the last version.
* [http://opencv.org/ OpenCV] and a C++ compiler for some image operations.
+
* [https://www.ffmpeg.org/ ffmpeg] (or libav), providing libavformat, libavutil (>= 55.20), libavcodec, libswscale and libswresample for mp4 sequence export
 +
* [https://curl.haxx.se/libcurl/ libcurl] for new Siril release checking online.
 +
* [http://www.gnuplot.info gnuplot] for photometry graph creation (not required at compilation time)
  
 
===Build dependencies=== <!--T:55-->
 
===Build dependencies=== <!--T:55-->
To install from source, you will have to install the base development packages: <tt>autoconf, automake, libtool, pkg-tools, make, gcc</tt> and optionally <tt>g++</tt> if you wish to use OpenCV. You'll probably want <tt>subversion</tt> too, to download the latest version on the source repository.
+
To install from source, you will have to install the base development packages:
 
+
    autoconf, automake, libtool, intltool, pkg-tools, make, gcc, g++
<!--T:3-->
+
You'll probably want <code>git</code> or <code>subversion</code> too, to download the latest version on the source repository. The compilers gcc and g++ from this list can be replaced by clang and clang++ (we use them for development), probably others as well.
Siril is developed with Arch Linux, which has all latest packages versions, and under Debian testing. This allows us to verify a large range of package versions.
 
  
==Installing on Debian== <!--T:4-->
+
==Installing on Debian[[File:Debian_logo.png|48px|frameless|link=|middle]]== <!--T:4-->
 
+
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 [https://wiki.debian.org/BuildingTutorial this help]. In particular, to install dependencies, you can use the command:
<!--T:5-->
+
    apt build-dep siril
Debian 6 doesn't have GTK+ version 3, and Debian 7 has partial support for all the features we use in GTK+ (version 3.4 while our minimum is supposed to be 3.4). You can still make it work with Debian 7 but Debian 8, codename ''Jessie'' is recommended. For a desktop system, the next stable is probably the better choice, called Debian testing, currently version 9 with codename ''Stretch''.
 
  
 
<!--T:56-->
 
<!--T:56-->
 +
Otherwise, here is the list of packages for the current version:
 
* Packages required for the build system:
 
* Packages required for the build system:
<tt>autoconf automake make gcc libtool pkg-config</tt>
+
    autoconf automake make gcc libtool intltool pkg-config
  
 
<!--T:57-->
 
<!--T:57-->
 
* List of packages for mandatory dependencies:
 
* List of packages for mandatory dependencies:
<tt>libfftw3-dev libgsl0-dev libcfitsio3-dev libgtk-3-dev libconfig++-dev</tt>
+
    libfftw3-dev libgsl-dev libcfitsio-dev libgtk-3-dev libconfig-dev libopencv-dev
  
 
<!--T:58-->
 
<!--T:58-->
 
* List of packages for optional dependencies:
 
* List of packages for optional dependencies:
<tt>libpng-dev libjpeg-dev libtiff5-dev libraw-dev</tt>, for film (AVI and others) support: <tt>libffms2-dev</tt>, and for image resizing, rotation and others: <tt>libopencv-dev and g++</tt>.
+
    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: <code>libffms2-dev</code>.
  
 
<!--T:14-->
 
<!--T:14-->
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 libtiff5-dev.
+
Note that libtiff5 is incompatible with OpenCV in debian 7, in that case you need to install libtiff4 instead. And in debian 8, <code>libjpeg8-dev</code> has been replaced by <code>libjpeg62-turbo-dev</code>, which is also installed by <code>libtiff5-dev</code>.
 
 
==Installing on Ubuntu== <!--T:16-->
 
 
 
<!--T:17-->
 
A list of dependencies has been reported for Ubuntu 14.10, for building the executable from source. Use the following command to install all of them:
 
  
<!--T:18-->
+
==Installing on Ubuntu & Linux Mint [[File:Ubuntu_logo.png|48px|frameless|link=|middle]][[File:LMint_logo.png|48px|frameless|link=|middle]]== <!--T:16-->
<tt>sudo apt-get -y install automake autoconf build-essential libgtk-3-dev fftw3-dev libgsl0-dev libcfitsio3-dev libconfig++-dev libtiff-dev libjpeg-dev libraw-dev libffms2-dev libopencv-dev</tt>
+
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 & Linux Mint 19.X
 +
    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
  
 
<!--T:19-->
 
<!--T:19-->
Then proceed with the normal procedure, and use <tt>sudo make install</tt> to install Siril.
+
Then proceed with the normal procedure:
 +
    ./autogen.sh
 +
    make
 +
    sudo make install
  
==Installing on Arch Linux== <!--T:20-->
+
==Installing on Fedora[[File:Fedora_logo.png|48px|frameless|link=|middle]]== <!--T:81-->
 +
    dnf install intltool libconfig-devel gtk3-devel fftw3-devel gsl-devel cfitsio-devel LibRaw-devel opencv-devel curl-devel autoconf automake
  
<!--T:21-->
+
<!--T:82-->
[[User:Vincent|Vincent]] maintains an [https://aur.archlinux.org/packages/siril/ AUR package] for Siril. Download the tarball, run makepkg to build the package and pacman -U to install the package.
+
Then proceed with the normal procedure:
 +
    ./autogen.sh
 +
    make
 +
and, with superuser privileges
 +
    make install
  
==Installing on FreeBSD 10== <!--T:59-->
+
==Installing on Arch Linux[[File:Arch_logo.png|48px|frameless|link=|middle]]== <!--T:21-->
 +
[[User:Vincent|Vincent]] maintains a [https://aur.archlinux.org/packages/siril/ release-based AUR package] and a [https://aur.archlinux.org/packages/siril-git/ 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.
  
<!--T:60-->
+
==Installing on FreeBSD 10[[File:FreeBSD_logo.png|48px|frameless|link=|middle]]== <!--T:60-->
 
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:
 
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:
  
 
<!--T:61-->
 
<!--T:61-->
<tt>$ pkg install autotools gmake pkgconf libtool</tt>
+
    pkg install autotools gmake pkgconf libtool intltool gettext libconfig gtk3 fftw3 gsl cfitsio libraw opencv curl
 
 
<!--T:62-->
 
<tt>$ pkg install libconfig gtk3 fftw3 gsl cfitsio libraw opencv</tt>
 
  
 
<!--T:63-->
 
<!--T:63-->
Line 112: Line 173:
  
 
<!--T:64-->
 
<!--T:64-->
Compilation and the software are working fine with the default clang (<tt>cc</tt>) compiler. However, in its current version, clang does not support OpenMP, the language extension / library that we use for parallelism, which means Siril will probably be slower than if compiled with gcc, for stacking in particular.
+
Compilation and the software are working fine with the default clang (<code>cc</code>) 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
  
 
<!--T:65-->
 
<!--T:65-->
It is possible to install gcc48 or gcc5 in FreeBSD and pass the options to configure to compile the C files with it, as shown below. 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 <tt>-lgomp</tt> is required to link it.
+
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 <code>-lgomp</code> is required to link it:
  
 
<!--T:66-->
 
<!--T:66-->
<tt>$ CC=gcc5 LDFLAGS="-Wl,-rpath=/usr/local/lib/gcc5 -L/usr/local/lib/gcc5 -lgomp" ./configure</tt>
+
    CC=gcc5 LDFLAGS="-Wl,-rpath=/usr/local/lib/gcc5 -L/usr/local/lib/gcc5 -lgomp" ./autogen.sh
 +
 
 +
<!--T:75-->
 +
[[File:Siril_on_FreeBSD.png|600px]]
  
==Installing on Mac OS X== <!--T:22-->
+
==Installing on Mac OS X[[File:OSX_logo.png|48px|frameless|link=|middle]]== <!--T:22-->
This is an installation procedure for Siril under Mac OS X 10.10 (Yosemite).
+
 
 +
===Deprecated method, via macport=== <!--T:88-->
  
 
<!--T:23-->
 
<!--T:23-->
Line 130: Line 196:
  
 
<!--T:25-->
 
<!--T:25-->
Install the command line tools by typing in a Terminal window: <tt>xcode-select --install</tt>
+
Install the command line tools by typing in a Terminal window: <code>xcode-select --install</code>
  
 
<!--T:26-->
 
<!--T:26-->
Line 137: Line 203:
 
<!--T:27-->
 
<!--T:27-->
 
The following is done in a Terminal window. One should first install some libraries:
 
The following is done in a Terminal window. One should first install some libraries:
<br />
+
    sudo port install gcc49
<tt>sudo port install gcc49
+
    sudo port install automake
<br />
+
    sudo port install autoconf
sudo port install automake
+
    sudo port install gtk3
<br />
+
    sudo port install gnome-themes-standard
sudo port install autoconf
+
    sudo port install librsvg
<br />
+
    sudo port install cfitsio
sudo port install gtk3
+
    sudo port install fftw-3
<br />
+
    sudo port install gsl
sudo port install gnome-themes-standard
+
    sudo port install libconfig-hr
<br />
+
    sudo port install gnome-font-viewer
sudo port install librsvg
 
<br />
 
sudo port install cfitsio
 
<br />
 
sudo port install fftw-3
 
<br />
 
sudo port install gsl
 
<br />
 
sudo port install libconfig-hr
 
<br />
 
sudo port install gnome-font-viewer</tt>
 
  
 
<!--T:68-->
 
<!--T:68-->
 
Now we want to make available multithreading in cfitsio:
 
Now we want to make available multithreading in cfitsio:
 
In the following directory:
 
In the following directory:
<br />
+
    /opt/local/var/macports/sources/rsync.macports.org/release/tarballs/ports/science/cfitsio
<tt>
 
/opt/local/var/macports/sources/rsync.macports.org/release/tarballs/ports/science/cfitsio
 
</tt>
 
  
 
<!--T:69-->
 
<!--T:69-->
Line 174: Line 226:
 
<!--T:70-->
 
<!--T:70-->
 
Change the line
 
Change the line
<br />
+
    configure.cflags    -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64
<tt>configure.cflags    -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64</tt><br />
 
 
by
 
by
<br />
+
    configure.cflags    -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_REENTRANT
<tt>configure.cflags    -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_REENTRANT</tt><br />
 
  
 
<!--T:71-->
 
<!--T:71-->
 
Then:
 
Then:
<br />
+
    sudo port uninstall cfitsio
<tt>sudo port uninstal cfitsio
+
    sudo port -s install cfitsio
<br />sudo port -s install cfitsio
 
</tt>
 
  
 
<!--T:28-->
 
<!--T:28-->
 
Also install some optional dependencies (recommanded):
 
Also install some optional dependencies (recommanded):
<br /><tt>
+
    sudo port install libraw
sudo port install libraw
+
    sudo port install tiff
<br />
+
    sudo port install libpng
sudo port install tiff
+
    sudo port install opencv
<br />
 
sudo port install libpng
 
<br />
 
sudo port install opencv</tt>
 
<br />
 
  
 
<!--T:39-->
 
<!--T:39-->
Now you can manually install libjpeg (if you want to work with JPEG files):
+
Now you can manually install <code>libjpeg</code> (if you want to work with JPEG files):
<br />
+
    curl --remote-name http://www.ijg.org/files/jpegsrc.v9a.tar.gz
<tt>curl --remote-name http://www.ijg.org/files/jpegsrc.v9a.tar.gz
+
    tar -xzvf jpegsrc.v9a.tar.gz
<br />
+
    cd jpeg-9a
tar -xzvf jpegsrc.v9a.tar.gz
+
    ./configure --prefix=/usr/local
<br />
+
    make
cd jpeg-9a
+
    sudo make install
<br />
 
./configure --prefix=/usr/local
 
<br />
 
make
 
<br />
 
sudo make install</tt>
 
  
 
<!--T:72-->
 
<!--T:72-->
 
Now you can manually install giflib (if you want to be able to export GIF files) which is too old in macport:
 
Now you can manually install giflib (if you want to be able to export GIF files) which is too old in macport:
<br />
 
 
Download giflib sources at this url:
 
Download giflib sources at this url:
<br />
+
    https://sourceforge.net/projects/giflib/
<tt>https://sourceforge.net/projects/giflib/
+
and put the file in your home directory
<br />
+
    tar -jxvf giflib-5.1.2.tar.bz2
and put the file in your home directory<br />
+
    cd giflib-5.1.2
tar -jxvf giflib-5.1.2.tar.bz2
+
    ./configure
<br />
+
    make
cd giflib-5.1.2
+
    sudo make install
<br />
 
./configure
 
<br />
 
make
 
<br />
 
sudo make install</tt>
 
  
 
<!--T:29-->
 
<!--T:29-->
 
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:
 
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:
<tt>./configure --prefix=/opt/local<br />
+
    ./configure --prefix=/opt/local
make<br />
+
    make
sudo make install</tt>
+
    sudo make install
 
 
 
Download the SIRIL sources:
 
Download the SIRIL sources:
 +
    svn co https://free-astro.org/svn/siril/branches/0.9/ siril
 +
In the terminal go to the siril folder:
 +
    cd siril
 +
Generate the configure file by typing:
 +
    ./autogen.sh
 +
    make
 +
To install Siril, use the usual:
 +
    sudo make install
 +
Launch Siril:
 +
    siril
 +
Enjoy!
 +
 +
<!--T:38-->
 +
[[File:Siril_on_MacOS.png|600px]]
  
<!--T:30-->
+
== Installing on Windows == <!--T:100-->
<tt>svn co https://free-astro.org/svn/siril/branches/0.9/ siril</tt>
 
  
<!--T:32-->
+
<!--T:101-->
In the terminal go to the siril folder:
+
A tutorial has been made for compilation on Windows with MSYS2. It does not work with FAT filesystems and windows XP, and not very well with 32-bit systems.
 +
 
 +
<!--T:102-->
 +
[https://www.msys2.org/ Download MSYS2 64bit], a software distro 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.
 +
 
 +
<!--T:103-->
 +
Don't run MSYS2 from the installer, close it and run MSYS2 64bit (MINGW64BIT) from Start menu or shortcut.
 +
 
 +
<!--T:104-->
 +
First, update the package database and core system packages by typing (for more info about pacman see [https://wiki.archlinux.org/index.php/pacman this page]):
 +
 
 +
    <!--T:105-->
 +
pacman -Syu
 +
 
 +
<!--T:106-->
 +
'''Installing dependencies:'''
 +
 
 +
    <!--T:107-->
 +
pacman -S --needed base-devel mingw-w64-x86_64-toolchain git
 +
    pacman -S mingw-w64-x86_64-fftw
 +
    pacman -S mingw-w64-x86_64-gsl
 +
    pacman -S mingw-w64-x86_64-cfitsio
 +
    pacman -S mingw-w64-x86_64-gtk3
 +
    pacman -S mingw-w64-x86_64-libconfig
 +
    pacman -S mingw-w64-x86_64-opencv
 +
    pacman -S mingw-w64-x86_64-libraw
 +
    pacman -S mingw-w64-x86_64-ffms2
 +
    pacman -S mingw-w64-x86_64-curl
 +
 
 +
<!--T:108-->
 +
'''Building Siril from source:'''
 +
 
 +
<!--T:109-->
 +
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
  
<!--T:33-->
+
<!--T:110-->
<tt>cd siril</tt>
+
In the terminal go to the siril folder:
 +
    cd siril
 +
Generate the build system and compile the code by typing:
 +
    ./autogen.sh
 +
    make
 +
To install Siril, use the usual:
 +
    make install
  
<!--T:34-->
+
<!--T:111-->
Generate the configure file by typing:
+
'''To launch your build of Siril:'''
  
<!--T:35-->
+
<!--T:112-->
<tt>autoreconf -fi</tt>
+
Run MSYS2 64bit and type siril's command name:
 +
    siril
  
<!--T:67-->
+
<!--T:113-->
Then run
+
You can also create a shortcut to siril.exe to start it, the default location is /mingw64/bin/.
<br /><tt>./configure</tt>
 
<br /><tt>make</tt>
 
<br />To install Siril, use the usual:
 
  
<!--T:36-->
+
<!--T:114-->
<tt>sudo make install</tt>
+
'''To update your version:'''
 
 
Launch Siril:
 
  
<!--T:37-->
+
<!--T:115-->
<tt>siril</tt>
+
Run MSYS2 64bit then
 
+
    cd siril
Enjoy!
+
    git pull
 +
    make install
  
<!--T:38-->
+
<!--T:116-->
[[File:Siril_on_MacOS.png|600px]]
+
If ''git pull'' does not show any change, there is no need to type ''make install''. Otherwise, it will update your build.
  
 
</translate>
 
</translate>

Latest revision as of 10:47, 12 September 2019

Other languages:
English • ‎français • ‎italiano

We maintain Siril binaries in many operating systems, but in general only for the official releases, like the last one: 0.9.9. If your operating system has no binary version, you will have to build it from source yourself.

Installing Siril from binaries

DebianDebian logo.png

The binary package is available on Debian testing and unstable. It should be installed via repositories, with superuser privileges:

   apt install siril

Ubuntu & Linux MintUbuntu logo.pngLMint logo.png

Official repositories

   sudo apt-get install siril

PPA repositories

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 XOSX logo.png

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:

   xcode-select --install

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
  • Updates

When a new version of Siril is available, copy this line to the terminal:

   brew upgrade siril

and download the new .app file.

Enjoy!!

Siril on MacOS brew.png

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

And update it the following times by typing git pull in the base directory.

Below is a list of dependencies. Siril relies on the autotools compilation configuration system and 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 -O2' ./autogen.sh --prefix=/opt

To launch Siril, the command name is siril.

Dependencies

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.16
  • 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.

Note: even if Siril 0.9.9 can run in console, it is still always linked against the graphical libraries. So you still need GTK and X11 or wayland client to compile and run it.

Optional dependencies are:

  • libraw, libtiff, libjpeg, libpng for RAW, TIFF, JPE, PNG and 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 recommanded to install the last 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)

Build dependencies

To install from source, you will have to install the base development packages:

    autoconf, automake, libtool, intltool, pkg-tools, make, gcc, g++

You'll probably want git or subversion too, to download the latest version on the source repository. The compilers gcc and g++ from this list can be replaced by clang and clang++ (we use them for development), probably others as well.

Installing on DebianDebian logo.png

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 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: libffms2-dev.

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 libtiff5-dev.

Installing on Ubuntu & Linux Mint Ubuntu logo.pngLMint logo.png

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 & Linux Mint 19.X
   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

Then proceed with the normal procedure:

   ./autogen.sh
   make
   sudo make install

Installing on FedoraFedora logo.png

   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:

   ./autogen.sh
   make

and, with superuser privileges

   make install

Installing on Arch LinuxArch logo.png

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.

Installing on FreeBSD 10FreeBSD logo.png

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

Siril on FreeBSD.png

Installing on Mac OS XOSX logo.png

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: xcode-select --install

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:

   /opt/local/var/macports/sources/rsync.macports.org/release/tarballs/ports/science/cfitsio

Edit the file: Portfile

Change the line

   configure.cflags    -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64

by

   configure.cflags    -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_REENTRANT

Then:

   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:

   https://sourceforge.net/projects/giflib/

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:

   svn co https://free-astro.org/svn/siril/branches/0.9/ siril

In the terminal go to the siril folder:

   cd siril

Generate the configure file by typing:

   ./autogen.sh
   make

To install Siril, use the usual:

   sudo make install

Launch Siril:

   siril

Enjoy!

Siril on MacOS.png

Installing on Windows

A tutorial has been made for compilation on Windows with MSYS2. It does not work with FAT filesystems and windows XP, and not very well with 32-bit systems.

Download MSYS2 64bit, a software distro 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.

Don't run MSYS2 from the installer, close it and run MSYS2 64bit (MINGW64BIT) from Start menu or shortcut.

First, update the package database and core system packages by typing (for more info about pacman see this page):

   pacman -Syu

Installing dependencies:

   pacman -S --needed base-devel mingw-w64-x86_64-toolchain git
   pacman -S mingw-w64-x86_64-fftw
   pacman -S mingw-w64-x86_64-gsl
   pacman -S mingw-w64-x86_64-cfitsio
   pacman -S mingw-w64-x86_64-gtk3
   pacman -S mingw-w64-x86_64-libconfig
   pacman -S mingw-w64-x86_64-opencv
   pacman -S mingw-w64-x86_64-libraw
   pacman -S mingw-w64-x86_64-ffms2
   pacman -S 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

In the terminal go to the siril folder:

   cd siril

Generate the build system and compile the code by typing:

   ./autogen.sh
   make

To install Siril, use the usual:

   make install

To launch your build of Siril:

Run MSYS2 64bit and type siril's command name:

   siril

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

   cd siril
   git pull
   make install

If git pull does not show any change, there is no need to type make install. Otherwise, it will update your build.