Revision as of 18:34, 6 November 2013 by Vincent (talk | contribs) (Marked this version for translation)


Other languages: voir la page en français.

Siril is meant to be Iris for Linux (sirI-L). It is an astronomical image processing tool, able to convert, pre-process images, help aligning them automatically or manually, stack them and enhance final images. The manual alignment capability makes it well fitted for amateur astronomers having a low volume of images and bad quality images that automatic tools fail to align properly. This page is the page for the new version of Siril, legacy Sourceforge project and website are unmaintained.

The software has been updated to recent operating system libraries (mainly to GTK+3) and still under development and quite unstable. Many improvements have been done over the previous unmaintained version, including better handling of conversions, image sequences and errors, improving the GUI, and lots of bug fixes. As of November 2013, the command line is being reactivated; we are updating the commands so that they work with the new internal structures, and then add them in the GUI. Here is the list of commands currently available. New commands and features are also being developed.

Siril's works internally with FITS images, unsigned 16-bit per pixel and channel. All images you want to process with Siril thus needs to be converted, except for SER sequences which are converted on-the-fly, see the stacking tutorial page.

Siril stacking result.png


New features are being introduced quite regularly. Usual software features are explained with screen captures on the stacking tutorial page, and main features are:

  • Native image format support
    • unsigned 16-bit FITS files
    • SER files
    • AVI files soon
  • Image conversion (to the native FITS format only)
    • Supported input types: 8-bit and 16-bit BMP, TIFF, JPEG, PNG files, short movie files (like .AVI), NetPBM binary images, RAW DSLR images.
  • Image registration; supported methods:
    • Translation for one selected star alignment using FFT. This is not working fine at all. It appears that it works fine with good quality images (with nearly-round stars, not as bad as in the image above).
    • Manual translation with two preview renderings of the current image with reference frame in transparency.
    • Image rotation is not implemented yet, but is under consideration.
    • Using Theli is considered too, to align frames with a map (fixes image distortion, rotation, translation, according to many stars referenced by astrometry data).
  • Image stacking
    • Summing and median stacking.
  • Pre-processing of images with multi-channel offset, dark and flat images.
  • Enhancement of final images: lightness/contrast cursors on each layer, logarithmic scale, negative rendering and others.
  • The command line is being updated, see the list of available commands here.

Status of the new version (TODO and BUGS)

The more accurate information is available in the SVN log and in files available on the SVN, TODO and BUGS. It has a precise list of things to do and known bugs. Priority for next releases are re-enabling the automatic translation registration, adding support for wavelets and LRGB. If you want to contribute, you are welcome!

Stable packages for releases 0.9 and 1.0 will be created. A pre-release of 0.9, probably called 0.9b is expected to be out in a few weeks (December 2013), with many bugfixes and new features over what's already listed on the page: native AVI support and histogram display.

Dec 2, 2012: Version 61 begins the support for SER files (a frame sequence container) native use.

Oct 8, 2012: Version 54 is the first version actually able to stack (manually-)aligned images.

  • Only 3-channel colour images assigned to R, G and B are possible. Other assignations are to come, for LRGB or narrowband composition
  • FWHM function does not work properly (badly implemented, soon fixed using astrofocuser's code)
  • Automatic translation registration is not working well, but manual alignment can be done in a convenient way
  • Warning: RAW images appear darker than in rawstudio or other RAW images visualisation tool because no automatic color and gamma correction are used
  • Siril has light and contrast levels control with the common hi and lo cursors, but no gamma correction
  • Median stack is limited to 50 frames to limit out of memory likeliness

Siril registration previews.png

Compilation and installation

Siril is currently only released as source from its subversion base. There is a package for the Arch Linux system, built from the source, in AUR. For other OS, you need Subversion (svn command) to retrieve it and autotools and gcc to compile it. Mandatory dependencies are gtk+-3.4, cfitsio and fftw. Optional are dcraw, libtiff, libjpeg, libpng and mplayer for RAW, TIFF, JPEG, PNG and AVI import. dcraw and mplayer can be installed after Siril's install, the libraries are detected at compilation. We are considering the use of libraw instead of dcraw. A stable release, version 0.9, is expected to be made as soon as the command line and various new conversions are considered stable. In the meantime, to get the source, use the command:

svn co

(sorry for the bad certificate - this URL does not work for online source viewing with old web browsers). The source is read-only if you have no particular authorization. If you want to participate to Siril and be able to commit on the svn, send a message to user Vincent here.

Once you have got Siril's source code, it's easy to install it. Siril is managed with autotools, so it's simply built using ./configure and make. The configure file is not shipped to allow for better interoperability and should be generated using this command:

$ aclocal && autoconf && autoheader && automake --add-missing

Then run ./configure and make. To install Siril, use the usual:

$ make install

Default installation directory is probably /usr/local. To launch Siril, the command name is siril.