Installation sur Microsoft Windows

Installation avec l'installeur

La méthode recommandée pour installer Siril est d'utiliser le programme d'installation fourni qui vous guidera pas à pas.

Premier écran du programme d'installation, vous devez accepter les termes du contrat de licence pour continuer.

Dernier écran de l'installateur. Vous pouvez choisir de lancer Siril immédiatement après l'installation, et d'ouvrir le tutoriel expliquant les premières étapes.

L'assistant d'installation de Siril installera tous les fichiers nécessaires au bon endroit et à la fin vous aurez le choix de créer ou non un raccourci sur le bureau.

Note

Siril sera installé dans C:\Program Files\Siril. Si vous n'avez pas les droits pour installer dans ce dossier, veuillez utiliser la version portable à la place (voir Installation de la version binaire portable.)

Installation de la version binaire portable

Si vous souhaitez utiliser Siril sans installer toutes sortes de fichiers sur votre ordinateur (par exemple si vous n'avez pas les droits d'administrateur sur la machine), il est recommandé d'utiliser la version portable. Elle se présente sous la forme d'un fichier zip, qu'il vous suffit d'extraire à l'endroit de votre choix, puis d'aller dans le dossier bin pour lancer siril.exe. Vous pouvez également créer un raccourci sur votre bureau pour faciliter le lancement de l'application.

Avertissement

Attention, en aucun cas vous ne devez déplacer le fichier exe , ou tout autre fichier. Sinon Siril ne fonctionnera pas.

Compiler sur Windows avec Msys2

These instructions are made for compiling on Windows with MSYS2 using the UCRT64 toolchain. MSYS2 requires 64-bit Windows 10 or newer, and does not work with FAT filesystems.

Note

Starting with Siril 1.4.2, UCRT64 is the only supported build environment on Windows. The MinGW64 environment, previously supported as an alternative, has been deprecated by the MSYS2 project on March 15th, 2025. Several Siril dependencies have already been removed from the MinGW64 package index, and more are expected to follow. All future releases of Siril will be built exclusively with UCRT64.

If you are using the installer or portable binaries provided on the Siril website, this change is transparent to you. If you are building Siril from sources, you must use the UCRT64 environment.

Using UCRT64 also increases the number of files that can be handled in a sequence to 8192.

Download MSYS2 64bit, a software distribution and building platform for Windows, and run the x86_64 installer for 64-bit. When asked, specify the directory where MSYS2 will be installed.

Run MSYS2 directly from the installer, or later MSYS2 MinGW UCRT x64 from the Start menu or a shortcut.

Avertissement

Make sure to launch the UCRT x64 shell (the icon at the top of the terminal window should be yellow).

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

pacman -Syu

Installation des dépendances

Pour installer les dépendances, entrez la commande suivante :

curl -s -o siril-deps.sh https://gitlab.com/free-astro/siril/-/raw/master/build/windows/native-gitlab-ci/siril-deps.sh
bash siril-deps.sh

Note

The link above points to the latest version of the dependencies installation script. We have had a tendency in the past not to remove any dependencies (rather to add more), so even if you want to build the stable branch, you should be okay using the latest dependencies script. In case a dependency is missing for a specific version, you can always check the script from the corresponding tag in the GitLab repository.

Construire à partir de la source

The source code is hosted on GitLab. Download it with the following command:

git clone https://gitlab.com/free-astro/siril.git
cd siril
git submodule update --init

Generate the build system and compile the code:

meson setup _build --buildtype release
ninja -C _build install

To launch your build of Siril, open an MSYS2 UCRT64 shell and type:

siril

You can also create a shortcut to siril.exe, located by default at C:\msys2\ucrt64\bin\.

To update your version, open an MSYS2 UCRT64 shell, then:

pacman -Syu
cd siril
git pull --recurse-submodules
meson setup _build --reconfigure
ninja -C _build && ninja -C _build install

If git pull does not show any changes, there is no need to rebuild. Otherwise, the above commands will update your build. Then launch Siril with:

siril

Avertissement

Starting with Siril 1.3.6, you will need to have Python installed on your system if you build from sources. The first time you launch a self-built Siril, you must do so from a native Windows environment, not from the MSYS2 shell, in order for Siril to detect the Windows Python installation rather than the MSYS2 one (a notification will appear in the console if this step is skipped, and the sirilpy module will not be initialized). This is a one-time requirement. Once the virtual environment has been set up, you can start Siril from the MSYS2 shell as usual.

To launch Siril in a Windows environment, either open a Windows terminal and run C:\msys2\ucrt64\bin\siril.exe, or locate this file in Explorer and double-click it.