Installer¶

Télécharger¶

Les paquets de chaque version sont sur la page des versions, construits par GitHub à partir des sources de cette version :

Chacun contient aussi la ligne de commande, sioul. Ces premiers paquets ont été construits et testés par GitHub, mais peu de personnes les ont encore lancés : un mot dans les tickets GitHub aide.

Ressources nécessaires¶

Mesuré le 4 octobre 2026 sur un ordinateur Linux à 8 cœurs, pendant cinq minutes, Sioul et tous les processus qu’il lance comptés ensemble (la mémoire en PSS : chaque page partagée comptée une fois) :

• Les sites sont la part lourde. Chacun gardé ouvert coûte ce que coûte un onglet de navigateur, 100 à 350 Mo, et le processeur qu’utilise sa page : une messagerie qui se tient à jour toute seule est la plus active.
• Disque : environ 4 Mo lus et écrits en cinq minutes.
• Fenêtre fermée, le veilleur des rappels (Paramètres ▸ Rappels et notifications) prend 10 Mo et presque pas de processeur.
• Ce qu’il faut prévoir : 4 Go de mémoire pour Sioul et quelques sites à côté de vos autres programmes, 8 Go pour garder beaucoup de sites ouverts ; n’importe quel processeur des dix dernières années.

La mesure peut être refaite sur n’importe quel ordinateur : tools/measure-load.py dans les sources (building.md, en anglais).

Ou le construire à partir de ses sources¶

La suite de cette page construit Sioul à partir de ses sources : pour les distributions Linux qui n’ont pas encore de paquet, et pour suivre les derniers changements.

Ce qu’il faut¶

• Rust 1.89 ou plus récent, avec Cargo.
• Un compilateur C++ : la fenêtre est en partie écrite en C++.
• Les fichiers de développement de D-Bus, sur Linux : pour le trousseau du système, où vont les mots de passe, et pour les notifications.
• Qt 6.9 ou plus récent (Sioul est construit et utilisé avec Qt 6.11), avec ces modules : Qt Declarative (QML et Qt Quick), Qt WebEngine avec Qt WebChannel et Qt PDF, Qt Multimedia, Qt Positioning, Qt Location et Qt Image Formats.

En option, et installables plus tard :

• ClamAV, pour faire vérifier les pièces jointes avant qu’elles s’ouvrent. Sans lui, Sioul vous dit qu’un fichier ne sera pas vérifié, et demande avant de l’ouvrir.
• Tesseract et Poppler, pour lire le courrier papier que vous scannez. Sans eux, les scans attendent, non lus. Voir Les papiers et les lettres.

Sur Linux¶

Les paquets¶

sudo dnf install git rust cargo gcc-c++ dbus-devel \
    qt6-qtbase-devel qt6-qtdeclarative-devel qt6-qtwebengine-devel \
    qt6-qtwebchannel-devel qt6-qtpdf-devel qt6-qtpositioning-devel \
    qt6-qtmultimedia qt6-qtlocation qt6-qtimageformats

sudo dnf install clamav clamav-update
sudo freshclam
sudo systemctl enable --now clamav-freshclam

sudo dnf install tesseract tesseract-langpack-fra poppler-utils

Sioul est développé sur Fedora : les autres systèmes n’ont pas été essayés. S’il manque un module, la construction s’arrête, ou la fenêtre ne s’ouvre pas et Qt nomme le module manquant dans ses messages (QT_FORCE_STDERR_LOGGING=1 sioul-app les affiche dans le terminal). Un mot dans les tickets GitHub aide alors la personne suivante.

Construire¶

git clone https://github.com/aurelienpierre/sioul.git
cd sioul
cargo build --release
cargo build --release -p sioul-app

La première ligne cargo build construit sioul, la ligne de commande ; la seconde construit sioul-app, la fenêtre. La première construction télécharge et compile quelques centaines de bibliothèques : elle prend un moment, et quelques gigaoctets de disque.

Dans votre menu d’applications¶

install -Dm755 target/release/sioul-app ~/.local/bin/sioul-app
install -Dm755 target/release/sioul ~/.local/bin/sioul
install -Dm644 data/com.aurelienpierre.Sioul.desktop ~/.local/share/applications/com.aurelienpierre.Sioul.desktop
install -Dm644 data/com.aurelienpierre.Sioul.metainfo.xml ~/.local/share/metainfo/com.aurelienpierre.Sioul.metainfo.xml
mkdir -p ~/.local/share/icons && cp -r data/icons/hicolor ~/.local/share/icons/

Sioul apparaît alors dans votre menu d’applications sous le nom « Sioul ». La ligne de commande sioul vaut la peine d’être installée aussi : les rappels s’en servent quand la fenêtre est fermée (Paramètres).

Mettre à jour¶

Dans le dossier sioul : git pull, puis à nouveau les deux lignes cargo build et les trois lignes install. Vos réglages et vos données sont gardés à part du programme, dans vos propres dossiers : ils restent tels quels.

L’essayer d’abord sur du courrier inventé¶

Depuis le dossier sioul, la ligne de commande peut montrer le Porche sur quelques messages inventés, sans aucun compte :

cargo run -q -- --config examples/demo.toml porch

Sur Windows¶

Pas encore essayé. Les étapes, pour qui veut :

1. Rust, par rustup, avec les outils de construction de Microsoft (MSVC).
2. Qt 6.9 ou plus récent depuis l’installateur en ligne de Qt, pour MSVC 2022 64 bits, avec les modules ci-dessus, et le dossier bin de Qt dans votre PATH.
3. cargo build --release -p sioul-app.
4. windeployqt --release --qmldir crates\sioul-app\qml target\release\sioul-app.exe rassemble Qt à côté du programme. packaging\windows\sioul.iss fait un installateur avec Inno Setup.

Sur Windows, les pièces jointes sont vérifiées par Microsoft Defender, par son interface d’analyse (Antimalware Scan Interface). Les rappels ne viennent que tant que la fenêtre est ouverte.

Sur macOS¶

Pas encore essayé. Les étapes sont dans packaging/macos/README.md (en anglais) : Qt 6.9 ou plus récent depuis l’installateur en ligne de Qt, Rust depuis rustup, puis cargo build --release -p sioul-app -p sioul-cli et un paquet fait avec macdeployqt ; la construction automatique sur GitHub peut faire le même .dmg quand on la lance à la main. ClamAV depuis Homebrew (brew install clamav) vérifie les pièces jointes quand il est là. Le paquet n’est pas encore signé : macOS vous demande de confirmer la première ouverture (clic droit, Ouvrir).

Ensuite¶

Premiers pas : ajouter votre courrier, vos agendas et contacts, Google, et les sites que vous consultez.