Aller au contenu

Le Sentier — les vidéos

Le Sentier est une série de courtes vidéos, une par fonctionnalité, à mi-chemin entre la démonstration et la documentation. Chaque vidéo est une étape : un dossard au départ, des ravitos (les chapitres, cliquables sur le profil altimétrique du lecteur) et une arche d'arrivée qui renvoie vers la page de documentation correspondante.

On y suit Camille, une athlète fictive qui prépare le Trail des Crêtes (42 km, 2 100 m D+). Toutes les données montrées sont inventées.

Dans le lecteur

Narration en français ou en anglais (sélecteur de langue), sous-titres (bouton ou touche c), espace pour lecture/pause, flèches pour ±5 s. Le tableau de bord n'existe qu'en français : les versions anglaises gardent ses captures, légendées en anglais.

Ligne de départ

Étape 01 · 1 min 45

Ligne de départ

Du git clone au premier /today : installation, authentification Garmin, /coach-setup et /coach-doctor en moins de deux minutes.

Regarder · English (1 min 43) · La documentation

Le réveil du traileur

Étape 02 · 1 min 19

Le réveil du traileur

HRV, FC de repos et readiness lues ensemble chaque matin : le verdict, sa raison, et comment régler le bilan.

Regarder · English (1 min 18) · La documentation

Le plan qui sait dire non

Étape 03 · 1 min 46

Le plan qui sait dire non

Sept garde-fous calculés relisent la semaine avant son écriture et son envoi au calendrier Garmin : un second avis déterministe et testé.

Regarder · English (1 min 42) · La documentation

Parler à son coach

Étape 04 · 1 min 33

Parler à son coach

Le chat du tableau de bord : trace des outils, carte d'approbation, politique de permissions, budget et fournisseurs.

Regarder · English (1 min 37) · La documentation

Tour du propriétaire

Étape 05 · 1 min 29

Tour du propriétaire

Visite guidée du tableau de bord local, en lecture seule : une question par vue (ancien design, avant la 1.4).

Regarder · English (1 min 26) · La documentation

La course, segment par segment

Étape 06 · 1 min 43

La course, segment par segment

Du GPX au plan de course : allures par segment, énergie, matériel obligatoire, montre, puis débrief plan contre réalisé.

Regarder · English (1 min 41) · La documentation

Disséquer une sortie

Étape 07 · 1 min 39

Disséquer une sortie

Une sortie trail passée au scalpel : FIT, zones, allure ajustée, dérive, montées, durabilité, HRR, énergie, comparaison.

Regarder · English (1 min 40) · La documentation

Ravito

Étape 08 · 1 min 43

Ravito

Une phrase libre devient des données : le modèle extrait, le script calcule, et ne devine jamais un produit.

Regarder · English (1 min 44) · La documentation

Usure

Étape 09 · 1 min 47

Usure

Du kilométrage à l'inspection photo : alerte de seuil, verdict en quatre couleurs, indices de foulée (jamais un diagnostic), foulée mesurée, kits et bilan de carrière.

Regarder · English (1 min 42) · La documentation

Le coach dans la poche

Étape 10 · 1 min 40

Le coach dans la poche

La machine coach, la synchronisation automatique (horaires ou veille), la notification push, Remote Control et les commandes courtes, le tableau de bord mobile, et ce qui n'est pas possible.

Regarder · English (1 min 37) · La documentation

Trois voix, une décision

Étape 11 · 1 min 46

Trois voix, une décision

La même décision dite par trois styles de coaching : le ton, la fermeté et la longueur se règlent, jamais le verdict.

Regarder · English (1 min 43) · La documentation

Vos données, votre sentier

Étape 12 · 1 min 42

Vos données, votre sentier

Vos données restent des fichiers Markdown chez vous : un bloc validé, un index jetable, un tableau de bord local, et ce qui quitte la machine.

Regarder · English (1 min 43) · La documentation

Nouvelles portes d'entrée

Étape 13 · 1 min 49

Nouvelles portes d'entrée

Strava comme troisième source de données, retours en un geste par Telegram sans aucun modèle, et deux options à activer soi-même : le contexte du cycle et les apports poussés vers Garmin.

Regarder · English (1 min 53) · La documentation

La nuit, la roche et le roadbook

Étape 14 · 1 min 49

La nuit, la roche et le roadbook

Préparer un ultra : la nuit calculée sur place (crépuscule, frontale, heure d'hiver), le dénivelé corrigé par un modèle de terrain, la technicité du sentier, puis le roadbook imprimable avec passages, barrières et matériel obligatoire.

Regarder · English (1 min 54) · La documentation

Construire son bloc

Étape 15 · 1 min 48

Construire son bloc

Un bloc d'entraînement qui ne s'invente plus : gabarits de périodisation, squelette semaine par semaine relu par les garde-fous, frise du bloc sur le tableau de bord, renforcement par phase et prévention ciblée.

Regarder · English (1 min 53) · La documentation

L'allure juste

Étape 16 · 1 min 48

L'allure juste

La pente, la durée et la chaleur ramenées à une allure juste : modèle de Kay et carte GAP, courbe allure-durée et vitesse critique, cibles de séance en pourcentage de cette vitesse, puis ralenties par la chaleur, FC inchangée.

Regarder · English (1 min 57) · La documentation

Avant, après

Étape 17 · 1 min 57

Avant, après

Regarder devant et derrière, sans jamais inventer : forme projetée jusqu'au jour J et affûtage chiffré, pénalité d'altitude du plan de course, ce qui a suivi chaque décision du coach, puis le débrief qui propose des coefficients personnels.

Regarder · English (2 min 11) · La documentation

Sans terminal

Étape 18 · 1 min 39

Sans terminal

L'application macOS : un questionnaire à la place des lignes de commande, le chat intégré ou votre assistant habituel, des données qui restent chez vous, une synchronisation qui n'écrit jamais chez Garmin, et la pesée du matin lue en lecture seule.

Regarder · English (1 min 46) · La documentation

Le home trainer, à votre mesure

Étape 19 · 1 min 27

Le home trainer, à votre mesure

Un parcours MyWhoosh qui tient dans la durée de la séance : puissance calibrée sur vos propres séances, catalogue des parcours, modèle de temps à ±10 %, nom du parcours sur la montre, calendrier MyWhoosh proposé, carte Home trainer du tableau de bord.

Regarder · English (1 min 29) · La documentation

Quelle course, et quand ?

Étape 20 · 1 min 49

Quelle course, et quand ?

L'agent directeur sportif : l'historique réel avant toute recherche, la faisabilité dite d'emblée, des courses sourcées sur le web et jamais inventées, un calendrier de saison calculé, l'avis médical qui l'emporte, et un objectif proposé sans jamais être écrit à votre place.

Regarder · English (2 min 02) · La documentation

Zéro euro pour démarrer

Étape 21 · 1 min 49

Zéro euro pour démarrer

Quelle IA pour le coach ? Celle que vous payez déjà, sinon l'essai gratuit OpenRouter : une option à l'installation, une connexion en un clic sans clé à copier, puis ses limites dites honnêtement (quota, confidentialité) et le passage à « 10 $ une fois ».

Regarder · English (1 min 55) · La documentation

Une autre montre

Étape 22 · 1 min 45

Une autre montre

Camille passe à une montre COROS : le MCP officiel par un relais local et une seule connexion pour toutes les IA, le même bilan matinal avec une récupération COROS nommée sans conversion, les séances envoyées à la montre après un « oui », la fiche Pace Strategy à recopier le jour J, et les limites dites franchement.

Regarder · English (1 min 49) · La documentation

La paire suivante

Étape 23 · 1 min 38

La paire suivante

Une paire arrive en fin de vie : fiche de caractéristiques sourcée, retours de chaussant, profil d'usage, plages cibles par des règles à preuves et commande /shoes (continuité d'abord, veto médical, confort qui décide) — sans achat, sans prix, sans promesse de prévention.

Regarder · English (1 min 51) · La documentation

Le nouveau roadbook

Étape 24 · 1 min 43

Le nouveau roadbook

Le tableau de bord se lit comme le roadbook d'une course : profil du bloc, feuille de ravito du jour avec le verdict en grand, semaine sur une ligne par séance, navigation rail ou barre du bas, application installable, données qui restent chez vous.

Regarder · English (1 min 47) · La documentation

Votre IA, votre forfait

Étape 25 · 1 min 43

Votre IA, votre forfait

Vous payez déjà ChatGPT ou GitHub Copilot ? Utilisez-le : une option à l'installation, une connexion unique, un coût « inclus dans votre forfait », le choix explicite de la synchronisation, puis le diagnostic « Tester la connexion » quand quelque chose ne répond plus.

Regarder · English (1 min 52) · La documentation

Comment c'est fait

Aucun fichier vidéo n'est stocké : chaque image est dessinée en JavaScript sur un canvas, à partir du seul temps écoulé. Une vidéo se lit, se met en pause et se parcourt comme une vraie, mais pèse quelques dizaines de kilo-octets (plus sa piste de voix).

Élément Où Rôle
Moteur docs/video/engine/ Lecteur, profil altimétrique, dossard, arche d'arrivée, outils de dessin
Script docs/video/<étape>/script.json Découpage en scènes et texte dit, en français et en anglais
Scènes docs/video/<étape>/scenes.js Le dessin de chaque scène, calé sur les répliques
Voix audio/<langue>.m4a, timing.js, subs.<langue>.vtt Générés par scripts/video_narration.py
Captures docs/video/shots/ Le vrai tableau de bord, servi sur l'espace de travail fictif de Camille

La voix est une synthèse vocale locale (Kokoro, hors ligne) : ff_siwis en français, bm_george en anglais. Les mots qu'elle prononce mal se corrigent dans docs/video/lexicon.json, sans toucher aux sous-titres.

D'autres moteurs se choisissent avec --engine (le choix est noté dans timing.js) :

Moteur Où Lexique IPA [[…]] Prérequis
kokoro (défaut) local, ONNX oui modèle dans ~/.cache/kokoro-onnx
azure Azure AI Speech, palier gratuit F0 oui (SSML <phoneme>) AZURE_SPEECH_KEY, AZURE_SPEECH_REGION
edge mêmes voix Microsoft, sans compte non réseau ; point d'accès non officiel, pour écouter seulement
kyutai local, MLX (Apple Silicon) non ~4 Go téléchargés au premier lancement
chatterbox local, PyTorch, voix clonable non ~3 Go téléchargés au premier lancement

Un moteur sans IPA lit le mot d'origine, sauf entrée dédiée sous "<langue>@<moteur>" dans le lexique (ex. "fr@kyutai": {"readiness": "rédinesse"}). Pour comparer avant de choisir, --sample écrit l'extrait d'une scène hors de la série :

uv run --with kokoro-onnx --with soundfile scripts/video_narration.py bilan-matinal \
    --sample triptych --engine kyutai --voice fr=unmute-prod-website/developpeuse-3.wav --out /tmp/voix
# 1. l'espace de travail fictif de Camille, puis les captures du tableau de bord
python3 scripts/video_demo_workspace.py /tmp/camille
uv run --with playwright scripts/video_capture.py

# 2. la voix, le minutage et les sous-titres (modèle Kokoro dans ~/.cache/kokoro-onnx)
uv run --with kokoro-onnx --with soundfile scripts/video_narration.py garde-fous

# 3. la galerie de cette page et les vignettes
uv run --with playwright scripts/video_gallery.py --posters

# 4. un MP4 (voix + sous-titres désactivables), ou toute la série
uv run --with playwright scripts/render_video.py --episode garde-fous --lang en
uv run --with playwright scripts/render_video.py --episode all --burn-subs

Le palier B des tests vérifie que le minutage, la galerie et les vignettes sont à jour (python3 scripts/video_narration.py --check, python3 scripts/video_gallery.py --check).

Captures : deux designs, deux dossiers

scripts/video_capture.py capture un des deux designs du tableau de bord :

  • classic (défaut, explicite : le script force ?design=classic) : docs/video/shots/, utilisé par les épisodes 01 à 21. Ces captures sont gelées avec l'ancien design : tant qu'il existe (jusqu'à la 1.5), elles se régénèrent à l'identique ; après son retrait, ne jamais relancer cette commande sur docs/video/shots/.
  • roadbook (--design roadbook) : docs/video/shots-roadbook/, même format de manifeste, pour les nouveaux épisodes. Les cadres boxes visent les sélecteurs de l'ancien design : ils sont omis quand l'élément n'existe pas, à compléter épisode par épisode.
uv run --with playwright scripts/video_capture.py --design roadbook --only aujourdhui

Captures de la documentation

Les images de docs/assets/dashboard/ (README, pages du tableau de bord, vignettes) sont produites par scripts/docs_capture.py, jamais à la main : workspace fictif de Camille (variante --docs de scripts/video_demo_workspace.py, qui ajoute un ultra de 110 km et son lendemain, des tours de longueur variable, du matériel à contrôler, des efforts de seuil, la trace fictive du dimanche et deux fichiers volontairement hors contrat), design roadbook, thème clair (sauf sombre-forme), 1440 px @2x sur ordinateur, 390×844 @2x sur téléphone, WebP cwebp -q 82. Une ligne de la table SHOTS du script décrit chaque image (vue, format, découpe) ; les noms de fichiers ne changent pas, aucun lien non plus. Les images ne portent ni la version du moteur, ni le lien « Ancien design », ni le curseur de frappe du coach (feuille de style ajoutée à la capture), et le serveur ne vérifie pas les mises à jour (ARC_UPDATE_CHECK=off).

brew install webp                                  # cwebp
uv run --with playwright scripts/docs_capture.py --list                 # la table nom → vue
uv run --with playwright scripts/docs_capture.py                        # les 46 images
uv run --with playwright scripts/docs_capture.py --only seance,materiel # quelques-unes

Après un changement du design ou des vues, régénérez, regardez chaque image avant de la commiter et ajustez les légendes des pages qui les portent. Ne pas confondre avec les captures des vidéos (docs/video/shots/, ci-dessus).