Guide utilisateur d’Itinera Studio
Itinera Studio est un journal de parcours pour Mac. Il réunit des journées, des activités, des traces GPS, des moments, des notes, des photos et des observations météo. L’onglet Voyages permet de raconter un trajet sur plusieurs journées ; Explorateur sert à préparer et à comparer des itinéraires.
Ce guide décrit les fonctions présentes dans Itinera Studio 0.9. Les intitulés cités correspondent à l’interface française ; certains peuvent varier légèrement selon la largeur de la fenêtre et les réglages de langue. L’application requiert macOS 15.7 ou une version ultérieure.
1. Premiers pas
Au premier lancement, Itinera Studio ouvre sa bibliothèque locale et affiche le Journal. Sélectionnez une journée existante dans la colonne de gauche, ou cliquez sur l’icône calendrier avec un + en bas de cette colonne pour ouvrir la journée d’aujourd’hui. Si elle n’existe pas, l’application crée une journée vide. Une journée peut rester vide : il n’est pas nécessaire d’y ajouter une activité immédiatement.
Pour commencer avec une trace, cliquez sur l’icône d’importation en bas de la colonne de gauche et choisissez un fichier .gpx. Après l’import, la journée correspondante s’ouvre. Pour consigner une activité sans fichier GPS, sélectionnez une journée et utilisez le bouton + dans son en-tête.
Les onglets de l’application sont :
| Onglet | Utilité |
|---|---|
| Journal | Consulter les journées, leurs activités, la carte, la chronologie et les contenus associés. |
| Voyages | Regrouper des activités de plusieurs journées et organiser des escales. |
| Explorateur | Créer, éditer, classer et associer des itinéraires. |
| Diagnostics | Contrôles et opérations de maintenance ; cet onglet n’apparaît que dans les builds Debug. |
La barre supérieure et la colonne de gauche gardent un fond sombre. L’image de nature derrière le contenu du Journal est décorative ; elle ne représente pas votre parcours.
2. Comprendre l’écran Journal
La colonne de gauche présente, de haut en bas, la recherche, le filtre par tags, un calendrier, des voyages et les journées récentes. Un cercle rouge sur une date du calendrier signale qu’une journée existe ; un clic sur cette date l’ouvre. Un clic sur une date sans journée ne crée rien. Les flèches du calendrier changent de mois.
Lorsqu’une journée est ouverte, la partie centrale montre sa carte récapitulative et sa chronologie. Chaque carte de la chronologie représente une activité ou un moment ; cliquez dessus pour ouvrir l’activité. La colonne de droite réunit la note du jour, les photos de l’activité sélectionnée ou de la journée, un résumé du contenu et, lorsqu’un élément est sélectionné, ses détails. Le bouton de fermeture de la sélection dans cette colonne permet de retrouver l’aperçu général.
Le bouton + de l’en-tête de journée crée une activité. Les deux flèches voisines parcourent les journées. Si la journée n’a pas de trace, la carte l’indique ; les activités et les moments restent consultables dans la chronologie. Le bouton de rafraîchissement de la carte recharge les traces affichées.
La note du jour se trouve en haut de la colonne de droite. Cliquez sur Ajouter une note du jour ou sur l’icône de modification pour écrire ou modifier le texte. Elle est distincte des notes attachées à un moment précis d’une activité.
3. Créer, rechercher et supprimer une journée
Créer ou ouvrir aujourd’hui
Cliquez sur l’icône calendrier avec un + en bas à gauche. Si la journée d’aujourd’hui existe, elle est simplement sélectionnée ; sinon, un cadre de journée vide est créé. Vous pourrez y ajouter plus tard une activité, une note ou des contenus.
Retrouver une journée
Saisissez un mot dans Rechercher des journées, en haut de la colonne de gauche. La recherche peut porter sur le titre ou le récit d’une journée, sa date affichée, le titre ou les détails d’une activité, ainsi que le titre ou le texte d’une note. Les résultats montrent les journées correspondantes, avec un extrait pertinent lorsqu’il est disponible. Effacez la recherche avec le bouton × pour revenir à la liste normale.
Le menu des tags filtre les journées par tag appliqué à la journée ou à l’une de ses activités. Choisissez Tous les tags pour retirer ce filtre. La recherche et le filtre peuvent être utilisés ensemble. La liste des journées récentes est chargée progressivement ; la recherche permet aussi de retrouver des journées plus anciennes.
Supprimer une journée
Sélectionnez-la, puis utilisez la corbeille en bas de la colonne de gauche ou Supprimer la journée… dans son menu contextuel. L’application présente le contenu concerné avant la confirmation. La suppression d’une journée et de ses contenus est une action distincte du retrait d’une activité d’un voyage : vérifiez le récapitulatif avant de confirmer.
4. Créer et modifier une activité
Dans une journée, cliquez sur + ou utilisez Maj ⇧ + Commande ⌘ + A. Renseignez le titre, le type et l’état. Les heures de début et de fin ne sont demandées que si vous activez respectivement Heure de début connue et Heure de fin connue. Vous pouvez aussi saisir des détails facultatifs. Cliquez sur Enregistrer l’activité.
Une activité créée manuellement n’a pas nécessairement de trace GPS. Elle peut néanmoins recevoir des moments et d’autres contenus. La carte, la distance et la lecture de position ne s’affichent que si des données appropriées existent.
Pour modifier une activité existante, ouvrez-la depuis la chronologie et cliquez sur l’icône crayon de son en-tête. Le menu placé à côté de la date permet de passer à une autre activité de la même journée ou de revenir à la vue générale. La corbeille de l’en-tête et le menu Actions proposent sa suppression après confirmation. La suppression d’une activité est différente de son simple retrait d’un voyage.
5. Importer un fichier GPX ou Itinera Companion
Importer un GPX
- Cliquez sur l’icône d’importation en bas à gauche.
- Choisissez un fichier
.gpx. - Si le fichier ne fournit aucun horaire exploitable, choisissez la journée à laquelle rattacher l’activité.
- Si le même fichier a déjà été importé, décidez explicitement si vous souhaitez l’importer de nouveau.
- Attendez la fin du traitement ; la journée importée s’ouvre ensuite dans le Journal.
Un GPX contenant plusieurs traces peut créer plusieurs traces sous une même activité. Itinera Studio conserve le document source. Les traces dépourvues d’horodatage restent visibles sur la carte, mais ne permettent pas toujours une lecture animée. Les routes et points de passage GPX ne sont pas automatiquement convertis en itinéraires du volet Explorateur lors d’un import d’activité ordinaire.
Importer un document d’Itinera Companion
Depuis Itinera Companion sur iPhone, exportez une activité au format .itineraactivity, puis transférez ce document sur le Mac avec la méthode de partage de votre choix. Dans Itinera Studio, utilisez la même icône d’importation et sélectionnez ce fichier. L’application le vérifie, l’intègre au Journal et ouvre l’activité créée ou déjà présente.
Le document est chiffré. Son ouverture exige que la clé personnelle utilisée par Companion soit disponible sur le Mac via le même trousseau iCloud. Si la vérification ou l’accès à la clé échoue, l’activité n’est pas importée ; consultez le message affiché. Les données GPS et biométriques prises en charge sont intégrées, tandis que certaines valeurs de l’original peuvent rester conservées dans le document source sans être encore affichées séparément.
6. Lire une trace et explorer la carte
Ouvrez une activité qui possède une trace. La carte montre le parcours et, selon les données, les positions liées aux photos et à la météo. Dans son coin supérieur droit :
- 2D/3D incline ou redresse la carte ; la 3D dépend du relief et de la caméra disponibles à cet endroit.
- Calques choisit le fond Plan ou Satellite et affiche ou masque les traces GPS, les itinéraires associés, les portions hors itinéraire, les photos et la météo selon leur disponibilité.
- Agrandir donne plus de place à la carte ; le même bouton revient à la vue normale. La touche Échap quitte aussi la carte agrandie.
La lecture démarre avec le bouton lecture en bas à gauche de la carte. Sous la carte, le curseur permet d’aller à un instant précis ; le menu de vitesse change la vitesse de défilement. Suivre recentre la carte sur la position lue ; Activité entière laisse visible l’ensemble du parcours. Les courbes d’altitude, de vitesse et, si elle existe, de fréquence cardiaque se synchronisent avec la lecture. Le menu Affichage permet de choisir les contenus visibles et d’ouvrir Toutes les données de la chronologie.
La lecture requiert une chronologie utilisable. Si une trace n’a pas d’horodatages exploitables, l’application affiche la trace mais signale que la lecture est indisponible. Une activité sans GPS peut disposer d’une lecture narrative fondée sur ses moments horodatés, sans position sur la carte.
Sous les commandes et les graphiques se trouve l’encart repliable Itinéraire prévu. Il rassemble les informations sur la trace et l’itinéraire associé. Si l’écart entre les deux est sensible, son titre devient Itinéraire sensiblement différent ; il peut alors présenter les écarts constatés. Repliez l’encart pour libérer de l’espace.
7. Enrichir une activité : moments, notes, photos, météo et fréquence cardiaque
Les rubriques de données sous la carte suivent la chronologie de l’activité. Leur disponibilité dépend des horaires présents. Ouvrez le menu Affichage des commandes de lecture pour montrer ou cacher Notes, Photos, Météo et Fréquence cardiaque.
Moments et notes
Un moment est un repère temporel d’une activité. Ouvrez Tous les moments pour les parcourir, modifier leur heure, leur ajouter du contenu ou les supprimer. Vous pouvez y ajouter une note, des photos, une observation météo ou une mesure de fréquence cardiaque. Une note possède un titre facultatif et un texte ; l’éditeur propose une prévisualisation de la mise en forme Markdown. Les commandes Précédent et Suivant des rubriques sautent entre les éléments de même type.
La note du jour, elle, s’applique à l’ensemble de la journée. Utilisez-la pour un récit général, puis réservez les notes de moments aux événements situés dans le temps.
Photos
Dans la rubrique Photos, cliquez sur Ajouter des photos et choisissez-les dans Photos. Vous pouvez en sélectionner plusieurs à la fois. Selon le contexte, elles sont rattachées au moment sélectionné ou à l’instant courant de la lecture. Le bouton Toutes les photos ouvre la liste complète ; une carte photo peut aussi proposer de changer son placement ou de retirer sa référence de l’activité. Le panneau de droite du Journal affiche les photos de l’activité choisie et, sans activité ciblée, celles de la journée.
Si macOS demande l’accès à Photos, autorisez l’accès aux images que vous souhaitez associer. Une photo devenue indisponible dans la photothèque peut apparaître comme indisponible dans Itinera Studio.
Météo
Cliquez sur Ajouter une observation météo. Saisissez une condition, une température, le vent et un lieu si vous les connaissez, ou utilisez Proposer la météo lorsque le lieu et la disponibilité du service le permettent. Vérifiez la proposition avant de l’enregistrer ; l’observation conserve alors l’indication de sa source. Une saisie manuelle reste possible. L’utilisation de la position actuelle peut demander l’autorisation de localisation de macOS.
Fréquence cardiaque
La rubrique correspondante montre les données présentes et permet d’ajouter une mesure ponctuelle à l’instant choisi. Entrez une valeur en battements par minute et enregistrez-la. Les séries importées depuis Companion peuvent également être affichées dans les graphiques lorsqu’elles sont disponibles.
8. Créer et éditer un itinéraire
Une trace est le parcours enregistré ; un itinéraire est un parcours que vous pouvez préparer, modifier et associer à une activité.
Dans Explorateur, cliquez sur Nouvel itinéraire (ou Maj ⇧ + Commande ⌘ + R) pour créer un brouillon. Vous pouvez aussi ouvrir une activité avec une trace et choisir Actions → Créer un itinéraire à partir de cette trace. La création dérivée ne modifie pas la trace d’origine.
Sélectionnez un itinéraire dans la liste de gauche pour afficher son état, sa géométrie, sa provenance, ses tags et les activités associées. Les commandes Renommer, Modifier et Supprimer se trouvent en haut de sa fiche. Le menu de tags de la liste filtre les itinéraires.
Modifier ouvre un éditeur occupant la vue. Choisissez Ajouter puis cliquez sur la carte pour placer un départ, une arrivée et, si nécessaire, des points intermédiaires. En mode Déplacer, sélectionnez un point et cliquez sur sa nouvelle position. La liste latérale permet de sélectionner un point, de le verrouiller ou de le supprimer. Annuler et Rétablir concernent les changements de géométrie dans cette session ; Quitter l’éditeur abandonne la session après confirmation si elle contient des modifications non enregistrées. Enregistrer l’itinéraire conserve les changements.
Une géométrie dérivée d’une trace peut contenir de nombreux échantillons GPS sans points de passage éditables. L’éditeur distingue ces échantillons des points que vous ajoutez ; ne créez un nouveau départ et une nouvelle arrivée que si vous souhaitez remplacer la géométrie actuelle.
Depuis le menu Actions d’une activité, utilisez Associer un itinéraire puis choisissez son rôle, notamment prévu lorsqu’il s’agit du trajet envisagé. L’activité peut alors afficher les deux tracés et, si les données le permettent, une comparaison des écarts. Supprimer l’itinéraire ne supprime pas sa trace source.
9. Organiser un voyage
Dans Voyages, cliquez sur Nouveau voyage (ou Maj ⇧ + Commande ⌘ + V), donnez-lui un nom et une description, puis enregistrez. Sélectionnez-le dans la liste pour voir son résumé, sa carte et son récit. Ajouter des activités permet de choisir des activités déjà présentes dans le Journal, y compris sur plusieurs journées. Retirer une activité du voyage la conserve dans le Journal.
Un voyage peut comprendre des escales avec nom, description, dates d’arrivée et de départ et position. Les descriptions d’escale acceptent Markdown et disposent d’un aperçu. La carte peut être affichée en vue Monde ou Détaillée ; sa poignée permet d’en régler la hauteur, et un double-clic sur cette poignée rétablit la hauteur initiale. La sélection d’une escale relie carte et récit.
Pour partir d’un fichier de voyage, cliquez sur Importer un GPX de voyage… dans l’en-tête du voyage. Examinez l’aperçu avant publication : il liste les traces et les points de passage proposés comme escales. Confirmez les dates sans ambiguïté, choisissez une autre proposition pour les cas ambigus ou saisissez une date manuellement. Le filtre et la recherche aident à retrouver les escales à vérifier. Cliquez sur Publier dans le voyage lorsque les éléments souhaités sont confirmés. Rien n’est publié tant que cette action n’est pas effectuée. Pour un GPX déjà importé, vous pouvez réutiliser les traces existantes ou demander une nouvelle importation. Examiner les escales non publiées permet de reprendre plus tard les points restants.
Une escale peut être rapprochée d’une activité du Journal ; l’interface propose aussi de poursuivre dans le Journal pour créer l’activité correspondante. Modifier la date d’arrivée d’une escale liée peut déplacer une activité limitée à la date vers la journée correspondante : lisez l’indication de l’éditeur avant de sauvegarder. Supprimer un voyage conserve les journées et activités du Journal.
10. Utiliser les tags
Dans le Journal, cliquez sur Nouveau tag près du filtre en haut de la colonne de gauche, saisissez un nom et créez-le. Vous pouvez affecter des tags aux activités et aux itinéraires depuis leurs barres ou menus dédiés. Le filtre du Journal retrouve les journées dont une activité porte le tag ; il tient aussi compte des tags déjà affectés directement à une journée. Dans Explorateur, le filtre par tag limite la liste des itinéraires.
Un tag sert au classement transversal : il ne déplace pas une activité et ne crée pas de voyage. Retirer un tag d’un élément ne supprime pas cet élément.
11. Sauvegarder et restaurer la bibliothèque
Le bouton sauvegarde en bas de la colonne de gauche ouvre Sauvegarde et restauration de la bibliothèque. Choisissez Créer une sauvegarde…, indiquez un emplacement hors de la bibliothèque active et attendez la confirmation. Itinera Studio crée un dossier .itinerabackup vérifié. Conservez plusieurs sauvegardes, de préférence sur un autre disque, et ne modifiez pas le contenu de ces dossiers à la main.
Pour restaurer, cliquez sur Restaurer une sauvegarde… et choisissez le dossier de sauvegarde. L’application valide son contenu, restaure dans un nouveau dossier sans écraser la bibliothèque en cours, puis tente de redémarrer sur la copie restaurée. Si le redémarrage automatique échoue, quittez et relancez Itinera Studio selon le message affiché. Gardez l’ancienne bibliothèque et la sauvegarde jusqu’à avoir vérifié la copie restaurée.
Une sauvegarde de bibliothèque n’est ni un export d’activité .itineraactivity, ni un GPX. La suppression de caches techniques n’efface pas les journées sauvegardées, mais elle ne remplace pas une sauvegarde.
12. Régler l’affichage
Ouvrez Itinera Studio → Réglages…. Vous pouvez choisir la langue de l’application (système, français ou anglais), les unités de distance, de dénivelé et de température, le format de l’heure et celui des coordonnées GPS. La rubrique À propos affiche la version de l’application ainsi que les numéros techniques du schéma de données et du stockage ; ces derniers ne sont pas le numéro de version commerciale.
Ces préférences sont enregistrées sur ce Mac. Le fond Plan/Satellite et les calques de la carte se règlent dans le menu de la carte d’activité. L’apparence Liquid Glass et sa transparence dépendent aussi des réglages d’apparence de macOS.
13. Données personnelles et limites
La bibliothèque d’Itinera Studio est locale au Mac ; elle n’est pas synchronisée automatiquement avec l’iPhone ni avec un compte en ligne. Un document .itineraactivity se transfère explicitement depuis Companion. Sa clé personnelle peut être partagée entre vos appareils par le trousseau iCloud, ce qui est distinct d’une synchronisation de la bibliothèque. Les requêtes de météo proposée utilisent le service météo d’Apple ; la saisie manuelle n’en dépend pas.
Les photos choisies dans Photos sont liées à l’activité par des références. Conservez donc les originaux dans votre photothèque si vous souhaitez qu’ils restent visibles. L’accès aux photos et, le cas échéant, à la position actuelle est régi par les autorisations macOS. Vous pouvez consulter ou modifier ces autorisations dans les Réglages Système du Mac.
Un GPX peut décrire le trajet sans fournir toutes les données nécessaires à l’animation, aux graphiques ou aux comparaisons d’itinéraires. Les informations absentes ne sont pas inventées. Itinera Studio est un journal et un outil d’exploration ; les valeurs de santé affichées ne constituent pas une interprétation médicale.
14. Résoudre les problèmes courants
| Situation | Vérification ou action |
|---|---|
| La journée cherchée n’apparaît pas | Effacez la recherche et choisissez Tous les tags. Parcourez aussi les mois du calendrier. |
| La carte d’une journée est vide | Vérifiez qu’une activité de cette journée possède une trace ; une activité manuelle peut n’avoir aucun GPS. |
| La lecture est indisponible | Vérifiez les horodatages de la trace. Sans chronologie exploitable, le parcours peut être affiché sans animation. |
| La 3D semble peu visible | Déplacez ou zoomez la carte vers une zone de relief ; le rendu dépend des données cartographiques disponibles. |
| Une photo n’apparaît plus | Vérifiez son accès dans Photos et les autorisations macOS. |
| La météo proposée est indisponible | Vérifiez le lieu, la connexion et les autorisations éventuelles ; vous pouvez saisir l’observation manuellement. |
Un .itineraactivity ne s’ouvre pas |
Vérifiez qu’il provient de votre Companion et que la clé personnelle est accessible par le trousseau iCloud sur le Mac. |
| La restauration ne semble pas ouverte | Suivez le message affiché, puis relancez l’application ; la restauration a lieu dans un nouveau dossier. |
| L’onglet Diagnostics n’est pas visible | C’est normal dans une version Release. Dans un build Debug, le menu Développement → Afficher l’onglet Diagnostics permet aussi de le masquer. |
Dans un build Debug, Diagnostics est destiné aux utilisateurs avertis. Contrôle rapide vérifie notamment la présence des fichiers et les liens des données ; Contrôle complet vérifie aussi leurs empreintes et peut durer plus longtemps. Reprendre les suppressions termine les suppressions techniques déjà en attente. Purger les caches efface des fichiers temporaires reconstructibles. Exporter le rapport… crée un rapport JSON expurgé ; Créer une sauvegarde… conserve une copie vérifiée. N’utilisez les actions de maintenance que si vous en comprenez l’effet.
15. Glossaire et raccourcis
| Terme | Sens dans Itinera Studio |
|---|---|
| Bibliothèque | Ensemble local de vos journées, activités, itinéraires, voyages et fichiers associés. |
| Journée | Cadre daté qui regroupe les activités, la note du jour et les contenus consultés ensemble. |
| Activité | Sortie ou événement, avec ou sans trace GPS. |
| Trace | Géométrie GPS enregistrée ou importée, conservée comme source du parcours effectué. |
| Moment | Repère temporel d’une activité auquel on peut rattacher du contenu. |
| Itinéraire | Parcours préparé ou dérivé d’une trace, éditable et associable à une activité. |
| Escale | Étape datée et localisée d’un voyage. |
| Tag | Étiquette de classement et de filtrage. |
| Raccourci | Action |
|---|---|
| Maj ⇧ + Commande ⌘ + A | Nouvelle activité dans la journée ouverte. |
| Maj ⇧ + Commande ⌘ + V | Nouveau voyage. |
| Maj ⇧ + Commande ⌘ + R | Nouvel itinéraire dans Explorateur. |
| Maj ⇧ + Commande ⌘ + G | Nouveau tag dans le Journal. |
| Commande ⌘ + Z / Maj ⇧ + Commande ⌘ + Z | Annuler / rétablir dans l’éditeur d’itinéraire. |
| Échap | Quitter une carte agrandie ou fermer l’éditeur selon le contexte. |
Les boutons à icône seule affichent une aide au survol du pointeur. Si une commande paraît indisponible, vérifiez la sélection en cours : plusieurs actions demandent une journée, une activité, un moment, une trace ou un itinéraire préalablement sélectionné.