12. Tes fichiers

12.1 Deux dossiers

Dossier	Contenu	Qui y touche
Le dossier du programme (là où tu as extrait le zip)	`AstroTools.exe`, ses `.dll`, `Ressources\` (icône, modèle de `config.ini`), `en\` (textes anglais)	personne : il est remplacé à chaque mise à jour
`%LocalAppData%\AstroTools\`	tes données et tes réglages	AstroTools, et toi si tu veux

%LocalAppData% est en général C:\Users\<toi>\AppData\Local. Pour ouvrir le dossier : Fichier > Ouvrir le dossier des données, ou tape %LocalAppData%\AstroTools dans la barre d'adresse de l'Explorateur.

AstroTools n'écrit jamais dans le dossier du programme : il marche sans droits d'administrateur, et une mise à jour ne touche pas à tes données.

Les fichiers des séances d'acquisition sont ailleurs, dans le répertoire de sortie que tu choisis (par défaut Documents\AstroTools\Acquisitions) : voir chapitre 14, section 14.6.

12.2 Le contenu de `%LocalAppData%\AstroTools\`

Fichier	Contenu	Modifié par
`equipment.json`	ton matériel et tes configurations (chapitre 3)	la page Matériel, à chaque modification
`sources.json`	tes sources, leurs appareils et la description des champs (chapitres 5 à 8)	le bouton Enregistrer des pages Sources et Champs
`sources_copies\`	les 5 dernières versions de `sources.json` (section 12.4)	le bouton Enregistrer, juste avant d'écrire
`filters.json`	tes sélections de champs (chapitre 9)	l'éditeur de sélections
`config.ini`	quelques réglages techniques (section 12.3)	toi, par Fichier > Modifier config.ini…
`prefs.dat`	langue, thème, taille et position de la fenêtre (et de chaque fenêtre de graphique), dernières vue et pages, dernière sélection de la page Calculs, dernier choix de la page Champs	AstroTools, à la fermeture. Fichier chiffré pour ton compte Windows : il ne se modifie pas à la main
`Graphs\`	tes configurations de graphiques, `g-0001.json`…, et la version d'avant en `.bak` (chapitre 15)	l'éditeur de la page Plots, à chaque Enregistrer
`Logs\`	le journal, un fichier par jour (chapitre 11)	AstroTools

Les fichiers .json sont des fichiers texte lisibles (UTF-8, accents en clair) : tu peux les ouvrir dans le Bloc-notes pour regarder. Ne les modifie qu'AstroTools fermé, et garde une copie avant.

AstroTools écrit chaque fichier dans un fichier temporaire, puis remplace l'ancien : une coupure de courant pendant l'écriture ne laisse jamais un fichier à moitié écrit.

12.3 `config.ini`

Fichier > Modifier config.ini… ouvre le fichier dans le Bloc-notes. La barre d'état rappelle que les modifications sont prises en compte au prochain démarrage.

[Window]
; Taille initiale de la fenêtre, en pixels
Width = 1100
Height = 700

[Log]
; DEBUG, INFO, WARN, ERROR ou OFF
Level = INFO
; Fichiers de log plus vieux que ce nombre de jours supprimés (0 = tout garder)
RetentionDays = 10

[GnuPlot]
; Chemin complet de gnuplot.exe, pour le graphique de la page Acquisition
ExePath = C:\Program Files\gnuplot\bin\gnuplot.exe

Le séparateur décimal est toujours le point.
Une valeur fausse (Width = abc, Level = BAVARD) n'empêche rien : AstroTools prend sa valeur par défaut et écrit un WARN dans la console.
Langue, thème et matériel ne sont pas dans ce fichier : ils se changent depuis l'application.
Le config.ini du dossier du programme (Ressources\config.ini) n'est qu'un modèle : il est copié dans %LocalAppData%\AstroTools\ quand la copie manque. Le modifier ne change rien pour toi. Si tu supprimes ta copie, elle est recréée à partir du modèle au prochain démarrage (ou tout de suite par Fichier > Modifier config.ini…).

12.4 Sauvegarder

Pour mettre tes réglages à l'abri : AstroTools fermé, copie tout le dossier %LocalAppData%\AstroTools\ (par exemple en AstroTools_sauve_2026-10-25 sur une clé). Pour restaurer : AstroTools fermé, remets les fichiers en place.

Les fichiers importants sont equipment.json, sources.json et filters.json : ce sont tes heures de saisie.

Les copies automatiques de `sources.json`

À chaque Enregistrer des pages Sources et Champs, AstroTools garde d'abord l'ancienne version de sources.json dans le dossier sources_copies, sous un nom daté : sources_2026-10-30_09-15-02.json (date et heure de l'enregistrement). Les 5 dernières sont gardées, les plus anciennes s'effacent toutes seules. Un enregistrement qui ne change rien ne fait pas de copie.

Pour revenir à une version précédente (sources abîmées, champs perdus) :

ferme AstroTools ;
ouvre %LocalAppData%\AstroTools\ dans l'Explorateur (tape-le dans la barre d'adresse) ;
renomme sources.json en sources_abime.json, pour le garder au cas où ;
dans sources_copies, copie la version voulue (la date dit de quand elle est) et colle-la dans %LocalAppData%\AstroTools\ ;
renomme-la en sources.json, puis relance AstroTools.

Ces copies ne remplacent pas la sauvegarde complète ci-dessus : elles restent sur le même disque.

12.5 Repartir de zéro

AstroTools fermé, renomme le dossier %LocalAppData%\AstroTools (par exemple en AstroTools_old), puis relance AstroTools : c'est un premier démarrage (chapitre 1, section 1.3). Pour revenir en arrière, supprime le nouveau dossier et redonne son nom à l'ancien.