View source for Siril:scripts

<languages />
<translate>
<!--T:21-->
<span style="color: #ff0090; font-weight: bold; text-align: center; margin: 2em; font-size: 125%;">This page is now deprecated. Please refer to the new documentation at [https://siril.readthedocs.io/en/stable/Scripts.html siril.readthedocs.io].</span>

<!--T:19-->
__FORCETOC__

=Siril scripts= <!--T:2-->

<!--T:20-->
Since its early days, Siril can take user inputs as textual [[Siril:Commands|commands]], from the command line. Recently, [[Siril:Commands#Commands_history|more commands have been added]], enabling for a basic automated processing of images. Commands can be stored in a file that we call '''script''', and they are executed one after the other. Some commands can be used in scripts, some cannot, this is indicated in the help of the command line from the graphical user interface of Siril.

<!--T:3-->
Since release [[Siril:0.9.9|0.9.9]], Siril can execute scripts from a file. Since [[Siril:0.9.10|0.9.10]], [[Siril:Commands|commands]] can also be taken from a [[Siril:Commands#Command_stream_.28pipe.29|named pipe]] and more recently from the standard input too.

<!--T:5-->
==Using scripts==
There are three ways to run a script:
* from the graphical user interface, using the '''@''' keyword on the command line, followed by the script name in the current working directory, as explained [[Siril:Commands#Introduction|here]],
* from the graphical user interface, using the Scripts menu,
* from the command line interface (<tt>siril-cli</tt> executable), using argument <tt>-s</tt> followed by the script's path (see the [https://siril.org/docs/man/ man page] for more info).

<!--T:6-->
The scripts menu only appears if some scripts have been found in the script search directories defined either by default or by the user in the preference menu.

<!--T:11-->
[[File:Scripts_EN.jpg]]

<!--T:13-->
'''If you don't see the Scripts menu (or if you don't see the default scripts in the list):'''

<!--T:14-->
Please use the following procedure:
* click on the 'Burger' icon then on 'Preferences'
[[File:Menu-Preferences_EN.jpg]]
* click on the 'Scripts' section 
* delete the 2 lines in the field as described below
* click on 'Apply'
* close and restart Siril
[[File:Preferences-Scripts_EN.jpg]]

<!--T:8-->
==Getting scripts==
* Since release [[Siril:0.9.10|0.9.10]], scripts are provided with the installation.
* Since release [[Siril:0.99.4|0.99.4]], a new command 'convert' allows the execution of universal scripts that are available for DSLR (RAW files) and astronomy cameras (FITS files).


<!--T:15-->
'''Default scripts (automatically installed with Siril):'''

<!--T:9-->
* [https://gitlab.com/free-astro/siril/-/blob/master/scripts/Mono_Preprocessing.ssf Mono_Preprocessing.ssf]: script for monochrome DSLR or Astro camera preprocessing, uses biases, flats and darks, registers and stacks the images. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a monochrome file named result.fit.
* [https://gitlab.com/free-astro/siril/-/blob/master/scripts/OSC_Preprocessing.ssf OSC_Preprocessing.ssf]: same script as above but for One-Shot Color (OSC) DSLR or Astro camera. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a RGB file named result.fit.
* [https://gitlab.com/free-astro/siril/-/blob/master/3rdparty/scripts/en/OSC_Preprocessing_WithDrizzle.ssf OSC_Preprocessing_WithDrizzle.ssf]: same script as above with resize of images by 2x2. Beware, this script takes much more time and disk space. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a RGB file named result.fit.
* [https://gitlab.com/free-astro/siril/-/blob/master/scripts/OSC_Extract_Ha.ssf OSC_Extract_Ha.ssf]: script for OSC DSLR or astro camera preprocessing, for use with Ha filter or dual-band filter. This script extracts the Ha layer of the color image. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a monochrome file named Ha_result.fit.
* [https://gitlab.com/free-astro/siril/-/blob/master/scripts/OSC_Extract_HaOIII.ssf OSC_Extract_HaOIII.ssf]: same script as above, but extracts Ha and OIII layers of the color image. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get 2 monochrome files named Ha_result.fit and OIII_result.fit. You can also use the menu 'Image Processing' then 'RGB compositing' and put Ha_result in Red layer and OIII_result in Green and Blue layers to get an HOO image.


<!--T:16-->
'''Other scripts:'''

<!--T:18-->
* [https://free-astro.org/images/4/4b/Mono_Preprocessing_WithoutFlat.ssf Mono_Preprocessing_WithoutFlat.ssf]: preprocess monochrome images without bias nor flat. Added 2020/10/17
* [https://free-astro.org/images/7/71/Mono_Preprocessing_WithoutDark.ssf Mono_Preprocessing_WithoutDark.ssf]: preprocess monochrome images without dark. Added 2020/10/17
* [https://free-astro.org/images/9/95/Mono_Preprocessing_WithoutDBF.ssf Mono_Preprocessing_WithoutDBF.ssf]: preprocess monochrome images without dark, bias nor flat. Added 2020/09/01
* [https://free-astro.org/images/f/f2/Mono_Preprocessing_withbackgroundextraction.ssf Mono_Preprocessing_withbackgroundextraction.ssf]: preprocess monochrome images with background extraction on each image. Added 2021/07/18. 
* [https://free-astro.org/images/e/ea/OSC_Preprocessing_WithoutFlat.ssf OSC_Preprocessing_WithoutFlat.ssf]: preprocess color images without bias nor flat. Added 2020/10/17
* [https://free-astro.org/images/1/1a/OSC_Preprocessing_WithoutDark.ssf OSC_Preprocessing_WithoutDark.ssf]: preprocess color images without dark. Added 2020/10/17
* [https://free-astro.org/images/a/a4/OSC_Preprocessing_WithoutDBF.ssf OSC_Preprocessing_WithoutDBF.ssf]: preprocess color images without dark, bias nor flat. Added 2020/09/01 
* [https://free-astro.org/images/d/dd/OSC_Startrail.ssf OSC_Startrail.ssf]: preprocess color images and build a star-trail. Added 2020/09/01. 
* [https://free-astro.org/images/0/06/OSC_Preprocessing_withbackgroundextraction.ssf OSC_Preprocessing_withbackgroundextraction.ssf]: preprocess color images with background extraction on each image. Added 2021/07/18. 


<!--T:10-->
We encourage users creating their own scripts to publish them and make a link in this page with a basic description of what they do.

<!--T:17-->
We also suggest users to use [https://gitlab.com/free-astro/sirilic Sirilic] to generate scripts or to provide a more suited way to manage all the files for multi-session processing.

</translate>