Siril - Siril 1.0.3

Before the month of June comes to an end, we had to release a new version in order to keep the cruising rhythm started after the release of version 1.0.

Downloads #

Siril 1.0.3 is distributed for the 3 most common platforms (Windows, MacOS, GNU / Linux). Check out the downloads page.

But of course, as Siril is a free software, you can build from the sources, available through the installation page.

So what’s new #

This version 1.0.3 has very few new features as it is above all a stabilization version of the 1.0.2 released last month. It contains mainly bug (and crash!!) fixes reported by users and reported on this page. However, once again, a new tool has been added: the generalized hyperbolic transformation.

Of course, despite all our efforts, bugs may still exist. If you think you have found one, please reach out to us through the forum. Even better, do file a bug report there if you see it is not already listed as a known bug.

The generalized hyperbolic transformation #

Adrian Knagg-Baugh is the main author of the generalized hyperbolic transformation implementation in Siril. Indeed, starting from a discussion on the forum of astrobin, David Payne, an amateur astrophotographer, elaborated a whole series of equations using the PixelMath tool of PixInsight. Their purpose was to simplify the stretching applicable to a linear image. These equations, based on hyperbolic stretching, are perfectly suited to the stretching of astronomical linear images:

  • They are piecewise continuous, which makes the result look natural.
  • Their first derivative is always positive which will avoid spike and backwards stretch situation that can arise with curves.
  • The equations are normalized between 0 and 1 which avoids clipping pixels and thus losing information.

Based on this work, a second contributor, Mike Cranfield, developed a script for the same software based on this suite of equations. This simplified and improved the work started.

Then Adrian coded the tool for Siril. The tool is offered in a simplified version in 1.0.3 but will exist in a much more complete implementation in the future 1.2.0, which is in very active development.

Dialog of the tool as presented in the version 1.0.3 of Siril. Example of the same image processed on one hand with the histogram transformation tool and on the other hand with the generalized hyperbolic transformation. Note that the latter preserves the size of the stars and the center of the galaxies. All the controls present in the dialog allow a fine adjustment of the image. A word about the future #

Siril is in a phase that it has never known before: 3 developers are working hard on new features and on a complete redesign of several points. There may be as many changes, if not more, between 1.2.0 and 1.0.0 as there were between 0.9.12 and 1.0.0. The version currently under development is numbered 1.1.0. The second number, when it is odd, means that the version is said to be unstable. There are currently many changes and it would not make much sense to list them all here. However, we can list the main new features that will be present in this future version which release date is not yet known:

  • Livestacking
  • Refactoring of the registration part with lots of new options
  • Making siril completely usable from command line, even for stacked image processing
  • Astrometry and color calibration completely revised and corrected
  • Libraw is no longer used for demosaicing images, only for decoding the raw file

Contributors: Contributors to this release are: Cyril Richard, Cécile Melis, Vincent Hourdin, Adrian Knagg-Baugh, Mike Cranfield and David Payne. We also want to thank all the beta testers and especially Fred Denjean, for his gift to find bugs.

Donate #

Developing software is fun, but it also takes up nearly all of our spare time. If you like Siril and would like to support us in continuing development you’re welcome to donate a small amount of your choice.

This is a companion discussion topic for the original entry at

OSC_Preprocessing.ssf error
“The script you are executing requires a newer version of Siril to run (1.1.0), aborting.”

Can not run the script. I changed the required line in the script to 1.0.0

You probably uses wrong scripts.

You need to use the ones provided with the 1.0.3.

This is the best way to have scripts that fail.

Originally the script had “requires 0.99.4”
After I upgraded Siril to 1.0.3 the script has “requires 1.1.0”

If the upgrade is only to 1.0.3 and the script has “requires 1.1.0” it will not run because Siril is not at version 1.1.0 yet. scripts/OSC_Preprocessing.ssf · master · FA / Siril · GitLab

I tried to look through the Siril Github repository to see which line of code is used to check the version of Siril but could not find it.

Yes changing the the line “requires 1.1.0” or similar line in any program can cause issues, but in this case changing this line to 1.0.0 temporarily fixed the issue.

No scripts in 1.0.3 need 1.1.0 as you can see here: scripts · 1.0.3 · FA / Siril · GitLab

So you got scripts from another way but not with the official package. And if you really use the 1.0.3, a lot of commands in the scripts won’t work.


I do have two folders I store scripts. The second folder is modified version of the standard scripts. The installer updated my modified version of the OSC script I use. For me this was an unexpected result of running the installer. The second folder was synced with the master branch and not the 1.0.3 branch, but there is no .git folder in my second Siril script folder that would instruct Git to sync with the master branch.

I have the official scripts, but don’t know why the installer synced with the master branch to my second script folder. I don’t want my custom scripts to get updated again. This might be a Gitlab sync issue and not an issue with Siril, but what lines of code in the installer might trigger a Git pull or similar action to sync with the master branch instead of v1.0.3?

Hi, None. There is no pulling scripts though git involved in the installer script (I’m assuming Windows), see there: build/windows/installer/siril64.iss · 1.0 · FA / Siril · GitLab
We just copy the ones present in the branch being built (1.0 for v1.0.3) to C:\Program Files\SiriL\scripts


Thanks for the info. Definitely something I did, but I don’t know what I did. I will rename my modified scripts and rerun the installer to see if it happens again.
Once again thank you for your help.

Good work and a big thanks to the Siril team. GHT works a charm. On the left is using asinh, histogram stretch and on the right is using GHT.