Installer SatMe PC

Installer SatMe-PC sous Linux

English version · Sous Windows : plus bas · Ce que fait SatMe-PC : SatMe-PC

SatMe-PC, c'est toute la station dans un navigateur. Un seul paquet, satme-pc.tar, pour Debian, Ubuntu, Linux Mint, Raspberry Pi OS… Rien à compiler.

Le plus simple : l'installation guidée

curl -fsSL https://raw.githubusercontent.com/f4ioz/SatMe/main/installe-satme.sh -o installe-satme.sh
bash installe-satme.sh

Il regarde ce qui est branché (adaptateurs du poste ou du rotor, clé RTL-SDR, MiniTiouner) et coche ce qui va avec ; vous choisissez, il installe, puis lance SatMe-PC et ouvre la page. Le relancer pour mettre à jour. bash installe-satme.sh --oui prend ce qu'il a détecté sans rien demander.

• La case Page ouverte aux autres machines du réseau écrit reseau=true dans le fichier de démarrage de SatMe-PC, plus sur sa ligne de commande : Réglages › Démarrage peut ainsi la changer ensuite. Décochée, le fichier est laissé tel quel.
• Le lanceur ~/satme/lance-satme.sh (celui du raccourci) lit le port de la page dans ce même fichier (8090 sinon) : un port changé dans Réglages › Démarrage est ouvert au bon endroit.
• Un lanceur fait par une version plus ancienne du script mettait --reseau sur la ligne de commande, qui passe avant les réglages de la page : relancer bash installe-satme.sh refait les lanceurs (lance-satme.sh, et satme-pc.service si Lancer SatMe-PC avec la session est cochée).

Les étapes ci-dessous font la même chose à la main.

1. Java

SatMe-PC demande Java 17 ou plus récent :

sudo apt install default-jre
java -version

2. Télécharger et lancer

cd ~
curl -LO https://github.com/f4ioz/SatMe/releases/latest/download/satme-pc.tar
curl -LO https://github.com/f4ioz/SatMe/releases/latest/download/SHA256SUMS
sha256sum --ignore-missing -c SHA256SUMS
tar xf satme-pc.tar
~/satme/bin/satme

Puis ouvrir http://localhost:8090/ dans le navigateur. Le premier lancement télécharge les éléments orbitaux (depuis gp.f4ioz.fr) : quelques secondes.

sha256sum doit dire satme-pc.tar: OK ; sinon, télécharger à nouveau.

Option	Effet
--port 8090	le port de la page
--reseau	la page ouverte aux autres machines du réseau ; sans elle, ce PC seulement
--dossier DIR	où sont gardés réglages, carnet, journal et enregistrements (~/.satme d'origine)
--local	ce PC seulement, même si le fichier de démarrage dit reseau=true
--version	la version installée

Au premier lancement, la configuration rapide s'ouvre dans la page (indicatif, locator, heure, langue, réseau et port) ; voir Prise en main.

Les options de démarrage : ligne de commande, fichier, Réglages

--reseau, --port et --dossier se règlent aussi dans la page, Réglages › Démarrage, qui les écrit dans un fichier de démarrage lu au lancement :

• ~/.config/satme/satme-pc.properties (ou $XDG_CONFIG_HOME/satme/satme-pc.properties si XDG_CONFIG_HOME est défini) sous Linux et macOS ;
• %APPDATA%\SatMe\satme-pc.properties sous Windows.

Des lignes port=8090, reseau=true, dossier=/chemin, modifiables à la main SatMe-PC arrêté. L'ordre : la ligne de commande passe avant le fichier, le fichier avant les valeurs par défaut (ce PC seulement, port 8090, ~/.satme). Une option laissée dans un lanceur l'emporte donc sur la page : l'enlever pour que Réglages › Démarrage compte. Le détail : Options de démarrage.

3. Ce que demande chaque fonction

N'installer que ce qui sert.

Pour	Installer
Poste (CAT) ou rotor sur un port série/USB	être dans le groupe dialout : sudo usermod -aG dialout $USER, puis se déconnecter et se reconnecter
Vidéos, GIF, enregistrements du téléphone, images DATV	sudo apt install ffmpeg
Clé RTL-SDR (SDR, radiosondes, METEOR, panorama QO-100)	sudo apt install rtl-sdr (SatMe-PC lance rtl_tcp lui-même)
DATV avec un MiniTiouner branché sur ce PC	LongMynd et sa règle udev, plus bas — ou un SatMe-Node près de l'antenne
Le téléphone rejoint par QR code	le pare-feu doit laisser passer le port de la page + 1 : sudo ufw allow from 192.168.0.0/16 to any port 8091 proto tcp (seulement si ufw est actif)

Rien ne s'ouvre tout seul : un port série ne s'ouvre que choisi et « Connecter » cliqué, RTS/DTR restent bas, et aucun ordre d'émission n'est jamais envoyé. Commencer avec le poste et le rotor simulés.

DATV sur ce PC

sudo apt install build-essential libusb-1.0-0-dev libasound2-dev
cd ~ && curl -L https://github.com/BritishAmateurTelevisionClub/longmynd/archive/refs/heads/master.tar.gz | tar xz
make -C longmynd-master && mkdir -p ~/longmynd && cp longmynd-master/longmynd ~/longmynd/
echo 'SUBSYSTEMS=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6010", ATTRS{product}=="MiniTiouner*", MODE:="0666"' | sudo tee /etc/udev/rules.d/60-satme-minitiouner.rules
sudo udevadm control --reload-rules && sudo udevadm trigger

Débrancher puis rebrancher le MiniTiouner. SatMe-PC trouve LongMynd dans ~/longmynd/ (ou dans le PATH). Branché, le MiniTiouner apparaît aussi comme deux ports série (/dev/ttyUSB…) : ne jamais les choisir comme port du poste ou du rotor.

4. Le lancer avec la session (facultatif)

Le plus simple : Réglages › Sauvegarde › Déploiement › ⤓ satme-pc.service (Linux) donne l'unité toute faite, les commandes pour l'installer en tête du fichier (voir Lancer SatMe-PC avec la session). Ou à la main :

mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/satme-pc.service <<'EOF'
[Unit]
Description=SatMe-PC

[Service]
ExecStart=%h/satme/bin/satme
Restart=on-failure

[Install]
WantedBy=default.target
EOF
systemctl --user daemon-reload
systemctl --user enable --now satme-pc

Les options viennent du fichier de démarrage (Réglages › Démarrage) : pas besoin de --reseau sur la ligne ExecStart. Facultatif, loginctl enable-linger $USER : lancé dès l'allumage, sans ouvrir de session. Après un changement dans Réglages › Démarrage : systemctl --user restart satme-pc (le bouton Redémarrer SatMe-PC n'est pas proposé sous systemd).

5. Mettre à jour, désinstaller

• Mettre à jour : relancer bash installe-satme.sh, ou les mêmes commandes qu'à l'étape 2 (arrêter SatMe-PC d'abord). Réglages, carnet, journal et enregistrements restent dans ~/.satme. SatMe-PC dit lui-même qu'une version plus récente est publiée : un badge ⬆ 2026.10.NN dans le bandeau (voir Une nouvelle version) ; il ne télécharge ni n'installe rien tout seul.
• Désinstaller : rm -rf ~/satme (et ~/.satme pour effacer aussi vos données).

Sous Windows : les données à l'abri

Sous Windows, SatMe-PC vient tout en un (Java, ffmpeg, rtl_tcp) : satme-pc-windows.msi, l'installateur (pour votre compte, sans droits d'administrateur), ou satme-pc-windows.zip, la même chose sans installation. Les étapes : Installer SatMe-PC sous Windows.

• Installé par le MSI, SatMe-PC garde ses données dans %APPDATA%\SatMe (réglages, carnet, journal, enregistrements, satme-pc.log) — jamais dans le dossier du programme, que l'installateur remplace à chaque mise à jour.
• Une mise à jour n'efface plus rien de vos fichiers (depuis la 2026.10.34) : l'installateur ne retire que ses propres fichiers. Quitter SatMe-PC (icône près de l'horloge → Quitter), puis installer le nouveau .msi.
• Avant d'installer la 2026.10.34 par-dessus la 2026.10.33 ou une plus ancienne : si vous aviez posé un dossier donnees dans le dossier du programme, copiez-le d'abord ailleurs — l'ancien installateur le vide encore une dernière fois en se retirant.
• Un dossier donnees trouvé dans le dossier du programme est copié au démarrage dans %APPDATA%\SatMe (ou %APPDATA%\SatMe-portable-<date> si celui-ci sert déjà), vérifié, puis utilisé ; l'original est gardé et une fenêtre dit où sont vos données. Réglages › Démarrage refuse un dossier des données placé dans celui du programme.
• Le mode portable est celui du ZIP (une clé USB), pas de l'installateur : voir plus bas.
• Désinstaller : Paramètres → Applications → SatMe-PC → Désinstaller ; supprimer aussi %APPDATA%\SatMe pour effacer vos données.

SatMe-PC portable (sur une clé USB)

Un dossier donnees à côté du programme, et SatMe-PC y garde tous ses réglages et fichiers (carnet, journal, enregistrements, images, options de démarrage) ; rien n'est écrit ailleurs sur le PC. Idéal sur une clé USB. Le bandeau de la page affiche alors Portable (au survol : le dossier des données).

• Linux : décompresser satme-pc.tar sur la clé, puis créer satme/donnees, à côté de bin et lib ; lancer satme/bin/satme. Le PC doit avoir Java (étape 1).

  tar xf satme-pc.tar -C /media/$USER/MACLE
  mkdir /media/$USER/MACLE/satme/donnees
  /media/$USER/MACLE/satme/bin/satme
  

• Windows : décompresser satme-pc-windows.zip (Java et ffmpeg dedans), créer le dossier donnees dans SatMe-PC, à côté de SatMe-PC.exe, et lancer SatMe-PC.exe — le ZIP seulement : installé par le MSI, SatMe-PC garde ses données dans %APPDATA%\SatMe (voir plus haut). Voir sous Windows.

Sans dossier donnees, SatMe-PC fait comme d'habitude (~/.satme, %APPDATA%\SatMe).

Le compiler soi-même

git clone https://github.com/f4ioz/SatMe.git && cd SatMe
./gradlew :pc:installDist
pc/build/install/satme/bin/satme

Il faut un JDK 17 ou plus récent et le SDK Android (le projet contient aussi l'application du téléphone).

Pour les mainteneurs : publier une version

Les notes de version sont dans pc/NOUVEAUTES.md du dépôt : SatMe-PC les met dans sa fenêtre Quoi de neuf à la compilation, et la publication GitHub reprend la section de sa version.

1. Au fil des changements, écrire sous ## Prochaine version, en deux parties ### fr et ### en : des listes courtes, ce que l'utilisateur voit et où cliquer (Markdown simple).
2. Avant de poser l'étiquette, renommer ## Prochaine version en ## AAAA.MM.NN (le numéro de la version, par exemple ## 2026.10.28), remettre une section ## Prochaine version vide au-dessus, et faire le commit.
3. Pousser l'étiquette annotée satme-pc-AAAA.MM.NN :

   git tag -a satme-pc-2026.10.28 -m "SatMe-PC 2026.10.28"
   git push origin satme-pc-2026.10.28
   

   Le workflow satme-pc-release.yml fabrique satme-pc.tar, satme-pc-windows.msi et SHA256SUMS, et met la section ## AAAA.MM.NN de pc/NOUVEAUTES.md (ses parties fr et en) dans le texte de la publication GitHub, après les téléchargements — le texte que montre la fenêtre Nouvelle version de SatMe-PC. Sans cette section, un avertissement dans le workflow et pas de notes. La fenêtre Quoi de neuf saute la section ## Prochaine version tant qu'elle est vide.