Documentation

Introduction

Obscura Trace est une application macOS qui inventorie vos disques de photos, repère les doublons et vous aide à consolider vos archives vers un nouvel…

Know where every photo lives.

Obscura Trace est une application macOS qui inventorie vos disques de photos, repère les doublons et vous aide à consolider vos archives vers un nouvel emplacement, sans jamais rien détruire sans votre accord.

Ce guide explique comment vous en servir, écran par écran, avec les libellés exacts que vous verrez. Il décrit l’application telle qu’elle est aujourd’hui, pas telle qu’elle sera : quand une fonction n’existe pas encore, le guide le dit.

Version actuelle : 0.1.0, signée et notarisée, publiée le 4 octobre 2026, téléchargeable depuis l’espace membre Obscura : https://profil.obscuraflow.app/. Voir Installation et premier lancement.

À qui s’adresse ce guide

  • Aux photographes qui ont accumulé des disques externes, des copies de cartes mémoire et des exports, et veulent savoir ce qu’ils possèdent vraiment.
  • Aux archivistes et iconographes qui doivent consolider un fonds sans perdre un seul original ni un seul fichier de retouche (XMP).
  • Aucune compétence technique n’est nécessaire pour les chapitres 1 à 7. Le chapitre 8, sur la ligne de commande, s’adresse aux utilisateurs avancés.

Les promesses de sécurité, en clair

Obscura Trace manipule des archives irremplaçables. Il est conçu comme un logiciel de sauvegarde, pas comme un simple utilitaire de fichiers. Concrètement :

  1. Rien n’est supprimé sans votre accord. L’analyse et le Centre de revue ne font que lire vos fichiers et noter vos décisions dans le catalogue. Dans l’application, seul le Centre de transfert peut écrire sur un disque, et uniquement après un écran de confirmation que vous validez.
  2. La Corbeille par défaut. Quand vous déplacez des photos, les originaux vont à la Corbeille du disque, d’où vous pouvez les récupérer. L’application ne vide jamais la Corbeille. La suppression définitive existe, mais elle est désactivée par défaut, doit être autorisée dans les Réglages et acceptée à nouveau pour chaque transfert.
  3. Copie, puis vérification, puis seulement retrait. Un déplacement est toujours une copie suivie d’une vérification du contenu (empreinte SHA-256) ; l’original n’est retiré qu’une fois la copie vérifiée. Un fichier en cours de copie porte un nom temporaire (.obscura-part) et ne prend jamais son nom final avant d’être vérifié.
  4. Rien n’est écrasé en silence. Si un fichier du même nom existe déjà à la destination, l’application compare par défaut les contenus ; s’ils diffèrent, l’opération est mise de côté et rien n’est écrasé. Le remplacement n’a lieu que si vous l’avez explicitement demandé, et l’ancienne version va à la Corbeille.
  5. Tout est journalisé, avant d’agir. Chaque opération sur un fichier est inscrite dans un journal avant d’être effectuée. Si le disque est débranché ou si le Mac s’éteint, la reprise sait exactement où elle en était. Un historique lisible des opérations est affiché dans l’écran Activité.
  6. Fonctionnement 100 % local. Vos photos, vos métadonnées et votre catalogue ne quittent jamais votre Mac. Aucun moteur d’analyse n’utilise le réseau. La seule connexion possible est la recherche de mises à jour, désactivée par défaut, qui ne consulte que la liste des versions publiées.

Sommaire

ChapitreContenu
01 — Installation et premier lancementConfiguration requise, installation, ouverture du catalogue, accès aux disques, mises à jour
02 — Tour de l’interfaceLa fenêtre, la barre latérale, les menus, les états d’un écran
03 — Analyser une sourceL’Assistant de scan : sources, types de fichiers, exclusions, analyses, démarrage ; pause, reprise, annulation
04 — Tableau de bord et ActivitéLire les totaux, suivre l’historique des opérations
05 — Revoir les doublonsLe Centre de revue : filtres, groupes, master recommandé, confiance, décisions
06 — Transférer et consoliderLe Centre de transfert : simulation, plan, collisions, confirmation, exécution, reprise, rapport, manifeste
07 — RéglagesSuppression définitive, emplacement du catalogue, mises à jour
08 — La ligne de commande obscuraPour utilisateurs avancés : réglages, revue, plan, exécution, reprise, renommage par lots
09 — Comprendre les notionsDoublon exact ou visuel, master, confiance, compagnons, volumes faibles, déplacements détectés
10 — Que faire si…Disque débranché, application quittée, exFAT, NAS (SMB, AFP), fichiers illisibles, messages d’erreur
11 — Vos données : emplacement, sauvegarde, réinitialisationCatalogue, manifestes, préférences ; sauvegarder ou repartir de zéro
12 — FAQ, limites actuelles et glossaireQuestions fréquentes, ce qui n’est pas encore livré, vocabulaire

Conventions de ce guide

  • Les libellés entre guillemets « … » sont ceux de l’application, recopiés du code source.
  • Les captures d’écran (images/) sont prises sur l’application réelle, avec un fonds de démonstration, par make screenshots : elles se régénèrent à chaque évolution de l’interface. Deux emplacements restent marqués en commentaire : la fenêtre du DMG et le menu des mises à jour, qu’aucun scénario ne capture encore.