Onglet Config — réglages, services, cartes, hors-ligne
Le poste de réglage central de VoyagePilot : langue et mode nuit, connexions aux services (IA, instruments du bord, AIS, API météo), cartes marines hors-ligne et préparation du mode déconnecté.
Où la trouver
Barre latérale › Conf (icône engrenage, tout en bas de la liste des onglets).
L'onglet « Conf » regroupe tout ce qui touche au paramétrage de l'app. Il se subdivise en quatre sous-onglets affichés en haut du panneau : General, Services, Charts et Offline. Toutes vos données restent stockées localement dans le navigateur (« All data stored locally in your browser ») — aucun serveur central.
Hiérarchie
Conf
├── General
│ ├── Language (English / Français)
│ ├── Night Mode (Active / Off + curseur Brightness)
│ ├── Engine & Fuel (conso L/h, tirant d'eau m)
│ ├── Route d'abri (intervalle surveillance météo)
│ ├── Save / Reset
│ └── Version VoyagePilot
├── Services
│ ├── AI → AI / LLM · Exa AI · SearXNG
│ ├── Boat → Signal K (+ découverte réseau) · PyPilot · AIS · NMEA / Axiom
│ ├── APIs → Overpass · Tidal (UKHO) · OpenWeatherMap · Windy · WorldTides
│ └── Diagnostics → état des services de fond + conflits de ports (bureau seulement)
├── Charts
│ ├── SHOM (clé API cartes France)
│ └── Cartes hors-ligne (MBTiles)
│ ├── Library (bibliothèque importée)
│ ├── Catalog (catalogue téléchargeable)
│ ├── Download (tuiles le long de la route)
│ └── ENC (cartes vectorielles S-57)
└── Offline
├── Validation de couverture
├── Stockage / statistiques de cache
├── Préparer le mode hors-ligne
├── Export / Import sauvegarde
└── Vider tous les caches
General
Language (langue)
À quoi ça sert : bascule toute l'interface entre l'anglais et le français. Comment l'utiliser : 1. Cliquez sur English ou Français. 2. Le changement est immédiat et mémorisé pour les prochains démarrages. Options & réglages :
| Bouton | Effet |
|---|---|
| English | Interface en anglais |
| Français | Interface en français |
Astuces & limites : le choix s'applique aussi aux données localisées (routes, destinations, descriptions Sea-Seek). Le bouton actif est surligné en doré.
Night Mode (mode nuit)
À quoi ça sert : applique une dominante rouge atténuée sur tout l'écran pour préserver la vision nocturne au poste de barre. Comment l'utiliser : 1. Cliquez sur le bouton Off : il passe à Active (rouge). 2. Un curseur Brightness (luminosité) apparaît alors. 3. Réglez la luminosité entre 10 % et 80 % selon l'obscurité du carré. Options & réglages :
| Réglage | Plage | Effet |
|---|---|---|
| Bouton Active / Off | — | Active ou coupe la teinte nuit |
| Brightness | 10 % à 80 % (pas de 5 %) | Atténue l'écran ; valeur par défaut 45 % |
Astuces & limites : le curseur n'est visible que lorsque le mode nuit est actif. À utiliser dès la tombée du jour pour ne pas vous éblouir.
Engine & Fuel (moteur & carburant)
À quoi ça sert : renseigne la consommation moteur et le tirant d'eau du bateau, utilisés pour les estimations de carburant et l'alarme de profondeur des instruments. Comment l'utiliser : 1. Saisissez la consommation au moteur dans Fuel consumption (L/h). 2. Saisissez le tirant d'eau dans Keel depth (m). 3. Cliquez sur Save en bas du sous-onglet pour mémoriser. Options & réglages :
| Champ | Exemple | Effet |
|---|---|---|
| Fuel consumption (L/h) | 4.5 | Conso horaire au moteur, sert aux calculs d'autonomie carburant |
| Keel depth (m) | 1.8 | Tirant d'eau, sert à l'alarme de sonde sur les instruments |
Astuces & limites : ces deux champs sont vides par défaut. Le tirant d'eau alimente l'alarme de profondeur ; renseignez-le précisément (quille comprise).
Route d'abri
À quoi ça sert : définit la fréquence à laquelle l'app vérifie les alertes météo le long de votre route active pour la fonction de route de repli. Comment l'utiliser : 1. Saisissez un nombre de minutes dans Intervalle surveillance météo (min). 2. La valeur est enregistrée automatiquement à la saisie. Options & réglages :
| Champ | Plage | Effet |
|---|---|---|
| Intervalle surveillance météo (min) | 5 à 360 (pas de 5) | Fréquence de contrôle des alertes météo sur la route active ; défaut 60 min |
Astuces & limites : un intervalle court rafraîchit plus souvent mais sollicite davantage la connexion. Voir l'onglet Route d'abri pour l'usage complet.
Save / Reset
À quoi ça sert : enregistre tous les champs texte/numériques du panneau, ou les remet aux valeurs par défaut. Comment l'utiliser : 1. Cliquez sur Save : le bouton devient vert et affiche Saved! pendant 2 secondes. 2. Le bouton fléché à côté (Reset to default) remet l'ensemble des champs de réglage à leurs valeurs d'usine. Options & réglages : - Save — enregistre langue, endpoints et clés API saisis. - Reset (flèche circulaire) — restaure toutes les valeurs par défaut (à confirmer ensuite par Save si besoin).
Astuces & limites : le mode nuit, la langue et la Route d'abri sont enregistrés instantanément ; les autres champs (moteur, services, clés) ne sont mémorisés qu'au clic sur Save.
Version
À quoi ça sert : affiche le numéro de version installé, ex. VoyagePilot v0.1.20, suivi du rappel que toutes les données sont locales.
Services
Le sous-onglet Services propose lui-même quatre rubriques en haut : AI, Boat, APIs et Diagnostics. Chaque champ dispose d'un bouton flèche (Reset to default) qui restaure sa valeur par défaut. Un bouton Save commun en bas enregistre l'ensemble.
AI — IA & recherche
À quoi ça sert : configure le moteur de langage (LLM) qui alimente l'agent de navigation et l'analyse de route, ainsi que les services de recherche web qui enrichissent les POI. Comment l'utiliser : 1. Renseignez l'API Endpoint et le Model de votre serveur LLM compatible OpenAI. 2. Optionnellement, ajoutez une clé Exa et/ou une instance SearXNG pour l'enrichissement. 3. Cliquez sur Save. Options & réglages :
| Section | Champ | Rôle |
|---|---|---|
| AI / LLM | API Endpoint | Endpoint compatible OpenAI pour l'analyse de route (http://host:port/v1) |
| AI / LLM | Model | Nom du modèle servi par l'API (ex. qwen3.5-9b) |
| Exa AI (POI Enrichment) | Exa API Key | Recherche web IA avec images pour enrichir les POI ; bascule sur SearXNG si vide |
| SearXNG (AI Enrichment) | SearXNG Instance URL | Métamoteur gratuit sans clé, ancre l'enrichissement IA sur des données web |
Astuces & limites : le LLM doit exposer une API compatible OpenAI. Exa requiert une clé (dashboard.exa.ai) ; à défaut, SearXNG (auto-hébergé ou instance publique) prend le relais sans clé. Voir Agent IA.
Boat — instruments du bord
À quoi ça sert : relie VoyagePilot aux équipements du bateau : serveur Signal K (données instruments), pilote PyPilot, trafic AIS et passerelle NMEA vers un Axiom. Comment l'utiliser : 1. Saisissez l'adresse de votre Signal K Server, ou utilisez la découverte automatique (voir ci-dessous). 2. Renseignez si besoin PyPilot Server, les paramètres AIS et l'URL de la passerelle NMEA. 3. Cliquez sur Save. Options & réglages :
| Section | Champ | Rôle |
|---|---|---|
| Signal K (Boat Instruments) | Signal K Server | Serveur Signal K du bord pour données live : GPS, vent, sonde, batteries (http://192.168.1.100:3000) |
| PyPilot (Open-Source Autopilot) | PyPilot Server | Contrôle du pilote PyPilot : réglage PID, calibration compas, suivi servo (ws://192.168.1.100:23322) |
| AIS Vessel Traffic | AISStream.io API Key (real-time) | Clé gratuite aisstream.io pour l'AIS temps réel via WebSocket, avec traînées de navires |
| AIS Vessel Traffic | AIS API Endpoint (polling fallback) | API JSON de positions de navires, utilisée à défaut de clé WebSocket |
| NMEA / Raymarine Axiom | NMEA Bridge URL | Serveur passerelle local pour envoyer les routes vers un Axiom (http://localhost:3001) |
Découverte de serveurs Signal K (Discovered Servers) : sous le champ Signal K, l'app scanne le réseau local et liste les serveurs trouvés. Un bouton Refresh relance le scan. Si rien n'est trouvé, des pistes d'installation sont proposées (npm, image OpenPlotter pour Raspberry Pi, serveur de démo en ligne). Le bouton Connect remplit automatiquement le champ avec l'adresse du serveur choisi.
Astuces & limites : tous ces réglages sont optionnels. Signal K et PyPilot supposent un réseau de bord (Wi-Fi du bateau). La passerelle NMEA nécessite de lancer le script nmeaBridge côté serveur. La modification de ces champs est prise en compte sans recharger l'app.
APIs — services météo & ports externes
À quoi ça sert : configure les API externes optionnelles (la plupart gratuites avec quota) pour enrichir ports, courants de marée, indice UV et webcams. Comment l'utiliser : 1. Collez vos clés ou endpoints dans les champs voulus. 2. Cliquez sur Save. Options & réglages :
| Section | Champ | Rôle |
|---|---|---|
| Ports & Harbours (Overpass) | Overpass API endpoint | API Overpass pour les données de ports (par défaut overpass-api.de) |
| Tidal / Ocean Currents | UKHO Admiralty API Key | Clé Admiralty pour les courants de marée UK |
| OpenWeatherMap (UV Index) | API Key | Indice UV ; palier gratuit 1000 appels/jour (openweathermap.org) |
| Windy Webcams | Windy API Key | Webcams Windy ; palier gratuit limité (api.windy.com) |
| WorldTides (Global Tides) | WorldTides API Key | Marées mondiales ; palier gratuit (worldtides.info) |
Astuces & limites : Overpass est préconfiguré ; en cas de surcharge, basculez sur le miroir overpass.kumi.systems. Les autres clés sont facultatives : sans elles, les fonctionnalités correspondantes restent simplement indisponibles.
Diagnostics
À quoi ça sert : affiche en temps réel l'état des services de fond (Python, Node, binaires) et détecte les conflits de ports — pratique en cas de souci de démarrage du LLM, du RAG ou du serveur de tuiles. Comment l'utiliser : 1. Le panneau se rafraîchit automatiquement toutes les 5 secondes (bouton Refresh pour forcer). 2. Pour chaque service : Start (démarrer), Stop (arrêter) ou Restart (redémarrer). 3. Si un port est occupé par un processus étranger, un bouton Kill envoie un SIGTERM (confirmation demandée). Options & réglages :
| Élément | Rôle |
|---|---|
| État (Running / Starting / Stopped / Error / Unknown) | Statut courant du service |
| Ports / Active | Ports déclarés et port réellement utilisé |
| Start / Stop / Restart | Contrôle du cycle de vie du service |
| Bandeau de conflit | Signale deux services VoyagePilot réclamant le même port |
| Other listeners (not VoyagePilot) | Liste les processus tiers qui occupent un port attendu |
| Kill | Tue le processus bloquant (SIGTERM) après confirmation |
Astuces & limites : disponible uniquement dans l'application de bureau (« Available in the desktop build only »). En mode web, le panneau affiche ce message et reste inactif.
Charts (cartes)
SHOM (cartes marines France)
À quoi ça sert : active les cartes marines officielles du SHOM (WMS) pour les eaux françaises. Comment l'utiliser : 1. Collez votre clé GeoServices dans SHOM data.shom.fr API Key. 2. Cliquez sur Save. 3. Sélectionnez le style de carte « SHOM » pour les afficher. Options & réglages : - SHOM data.shom.fr API Key — clé d'accès aux cartes hydrographiques officielles françaises (data.shom.fr).
Astuces & limites : clé à obtenir gratuitement sur data.shom.fr. Sans sélection du fond « SHOM », la clé ne change rien à l'affichage.
Cartes hors-ligne (MBTiles)
À quoi ça sert : importer, télécharger et gérer des cartes marines au format MBTiles utilisables sans connexion, avec contrôle de la transparence et de l'ordre de superposition. Le panneau se découpe en quatre vues : Library, Catalog, Download, ENC.
Library (bibliothèque)
À quoi ça sert : liste, active et règle vos cartes déjà importées.
Comment l'utiliser :
1. Cliquez sur Import .mbtiles file pour ajouter un ou plusieurs fichiers (sélection multiple possible).
2. En version bureau, Scan folder monte tous les .mbtiles d'un dossier sur place, sans copie ni duplication.
3. Cliquez sur le nom d'une carte pour l'activer/désactiver (la carte est centrée à l'activation).
4. Pour une carte active, réglez la transparence avec le curseur et son ordre avec les flèches haut/bas.
Options & réglages :
| Élément | Rôle |
|---|---|
| Champ de recherche | Filtre par nom ou emprise |
| Filtre All / Active / Inactive | Affiche toutes les cartes, seulement les actives ou les inactives |
| Tri Layer / Date / Name / Size | Ordre d'affichage (ordre de calque, date, nom, taille) |
| Œil (Show / Hide) | Affiche ou masque la carte active sur la carte principale |
| Curseur d'opacité | Transparence de 0 % à 100 % |
| Flèches haut / bas | Ordre de superposition des calques |
| Corbeille | Supprime une carte |
| Delete all | Supprime toutes les cartes importées (confirmation demandée) |
Un bandeau résume le nombre de cartes, l'espace occupé et le nombre de cartes actives.
Catalog (catalogue)
À quoi ça sert : parcourt un catalogue de cartes prêtes à télécharger ou à ouvrir sur des sites externes.
Comment l'utiliser :
1. Recherchez et filtrez par source ou par tri (Region / Name / Size / Source).
2. Cliquez sur l'icône de téléchargement pour récupérer une carte directement.
3. Pour les cartes externes, cliquez sur le lien (icône lien externe) puis ré-importez le .mbtiles via le bouton d'import.
Options & réglages :
- Suggested for your route — cartes proposées automatiquement selon l'emprise de votre route active (jusqu'à 5).
- Filtre All sources et sélecteur de source.
- Indicateur $ pour les cartes payantes ; étiquette de format (ex. ENC) si différent de MBTiles.
Download (téléchargement de tuiles)
À quoi ça sert : pré-charge les tuiles de fond de carte le long de votre route active pour une consultation hors-ligne.
Comment l'utiliser :
1. Assurez-vous d'avoir une route active d'au moins 2 waypoints.
2. Cliquez sur un serveur de tuiles proposé pour lancer le pré-chargement (barre de progression).
3. Un serveur déjà téléchargé est marqué « cached » (vert).
Astuces & limites : nécessite un build de production (Service Worker actif) ; en mode développement, un avertissement vous invite à lancer npm run build && npm run preview. Des liens de sources MBTiles (The Chart Locker, OpenCPN, NOAA, communautaires) sont listés en bas.
ENC (cartes vectorielles S-57)
À quoi ça sert : télécharger et convertir des cartes vectorielles officielles S-57/S-52 (ENC) en tuiles vectorielles.
Comment l'utiliser :
1. Recherchez un pack ENC dans le catalogue.
2. En version bureau, cliquez sur Télécharger & Convertir : l'app télécharge, extrait, convertit puis monte la carte.
3. Les cartes converties apparaissent en haut, supprimables d'un clic.
Astuces & limites : la conversion ENC requiert l'application de bureau (GDAL + tippecanoe). En mode web, seule l'ouverture des liens externes est possible ; convertissez en ligne de commande puis importez le .mbtiles via Library.
Offline (mode hors-ligne)
À quoi ça sert : préparer l'app pour une navigation sans connexion (météo, GRIB, tuiles, zones marines), suivre l'état des caches et sauvegarder/restaurer vos données. Comment l'utiliser : 1. Vérifiez d'abord la validation de couverture (Ready for offline / Incomplete coverage). 2. Cliquez sur Prepare offline mode pour télécharger d'un coup tout le nécessaire le long de toutes vos routes. 3. Au besoin, exportez une sauvegarde avant un grand voyage. Options & réglages :
| Élément | Rôle |
|---|---|
| Indicateur Online / Offline | État de la connexion ; en hors-ligne, l'app utilise les données en cache |
| Validation de couverture | Coche/croix pour tuiles, prévisions, GRIB et zones marines (AMP) |
| Storage | Espace utilisé, quota, nombre de tuiles, cache météo, fichiers GRIB, AMP, PING, entrées Service Worker |
| Prepare offline mode | Télécharge prévisions 7 jours + grille GRIB + tuiles (zoom 6-14) + balises marines pour tous les couloirs de route |
| Export backup | Exporte un fichier JSON de sauvegarde (routes, polaires, journal, réglages) |
| Import backup | Réimporte un fichier de sauvegarde (recharger l'app ensuite) |
| Clear all caches | Vide tous les caches (tuiles, météo, enrichissements) ; vos données utilisateur sont préservées |
Astuces & limites : la préparation exige au moins une route de 2 waypoints ou plus ; sinon un message d'erreur s'affiche. La couverture météo est jugée suffisante à partir de 80 % des points couverts. Clear all caches ne touche pas à vos routes, polaires, journal de bord, clés API ni préférences. Préparez le mode hors-ligne tant que vous avez du réseau, avant d'appareiller.
Voir aussi
- Agent IA — utilise l'endpoint LLM configuré ici
- Route d'abri — utilise l'intervalle de surveillance météo
- Calques météo — données préchargées par le mode hors-ligne
- Instruments du bord — alimentés par Signal K et le tirant d'eau