diff --git a/docs/canvas-pilot/changelog.md b/docs/canvas-pilot/changelog.md
index 46d18ff..7189f5f 100644
--- a/docs/canvas-pilot/changelog.md
+++ b/docs/canvas-pilot/changelog.md
@@ -4,6 +4,10 @@
## Unreleased
+- Added a French quick-start pilot with English fallback links and an explicit
+ unverified machine-translation notice. Screenshots and application labels remain
+ English; the source revision and update workflow are recorded for maintenance.
+
- Recorded the multi-screen design task, including shared layers, alignment and
automatic/custom proportional scaling. Existing-feature testing and a visual-only
prototype precede implementation; application behavior is unchanged.
diff --git a/docs/canvas-pilot/guide/fr/quickstart.md b/docs/canvas-pilot/guide/fr/quickstart.md
new file mode 100644
index 0000000..43a1437
--- /dev/null
+++ b/docs/canvas-pilot/guide/fr/quickstart.md
@@ -0,0 +1,114 @@
+
+
+# Démarrage rapide : votre première composition
+
+**Français** · [English — version de référence](../quickstart.md)
+
+> **Traduction automatique non vérifiée.** Cette page n’a pas été relue ni validée
+> par une personne francophone. Le [manuel anglais](../../introduction.md) fait
+> référence et peut évoluer avant cette traduction. En cas de doute ou de différence,
+> consultez la version anglaise. Seul ce démarrage rapide est traduit pour le moment.
+> L’application et les captures restent en anglais ; les noms des commandes sont
+> conservés tels qu’ils apparaissent à l’écran. Les liens vers les autres chapitres
+> mènent à des pages en anglais.
+
+
+
+Créez une composition simple avec les calques **Slides** (diapositives) et
+**Presenter** (présentateur), enregistrez un projet modifiable, puis exportez sa
+géométrie. Ce tutoriel utilise le canevas Full HD par défaut et fonctionne hors
+ligne : aucun processeur vidéo n’est nécessaire.
+
+## 1. Ouvrir une nouvelle composition
+
+Suivez d’abord les [instructions d’installation et de mise à jour (en anglais)](../install.md),
+puis lancez Canvas Pilot. Si vous travaillez depuis les sources du projet, exécutez
+cette commande à la racine du dépôt :
+
+```sh
+cargo run --locked -p canvas-pilot
+```
+
+Consultez la [configuration de développement (en anglais)](../../../development/README.md)
+si vous avez besoin des outils de compilation. Si une composition précédente a été
+restaurée, enregistrez le travail à conserver, puis choisissez
+**Project → New project…** et confirmez.
+
+Le canevas par défaut mesure **1920 × 1080** et contient les calques **Slides** et
+**Presenter**. Conservez cette résolution pour ce tutoriel.
+
+
+
+*Capture de l’interface en anglais, réutilisée sans modification.*
+
+## 2. Placer et dimensionner les calques
+
+1. Cliquez sur **Presenter** dans la liste **Layers** ou sur le canevas.
+2. Faites glisser le calque pour le déplacer. Faites glisser une poignée d’angle
+ pour le redimensionner ; laissez **Keep aspect ratio when resizing** coché
+ pour conserver ses proportions.
+3. Pour un placement précis, utilisez les champs de position de l’inspecteur.
+ Vérifiez d’abord le coin de référence choisi : **From right** mesure la distance
+ depuis le bord droit, et non depuis le bord gauche.
+4. Sélectionnez **Slides** et placez-le à côté du présentateur. Utilisez **Undo**
+ pour annuler un déplacement ou un redimensionnement qui ne vous convient pas.
+
+Le champ de résolution du calque ouvre **Layer properties**, où vous pouvez saisir
+une largeur et une hauteur exactes. Conservez les dimensions par défaut si vous
+souhaitez seulement essayer le placement.
+
+## 3. Essayer le cadrage du contenu
+
+Avec **Presenter** sélectionné, ouvrez **Layer properties → Crop**. La mire de la
+source montre comment le contenu s’inscrit dans le rectangle visible du calque.
+Faites glisser le contenu pour ajuster sa position ou utilisez les poignées de
+recadrage pour modifier son zoom.
+
+Le rectangle visible du calque reste fixe pendant le recadrage. Utilisez
+**Reset crop** pour retrouver le cadrage par défaut, puis revenez à l’onglet
+**Layer** pour terminer. Vous pouvez ignorer cette étape si seules les positions
+des rectangles vous intéressent.
+
+## 4. Enregistrer le projet modifiable
+
+Appliquez les modifications de propriétés en attente, puis choisissez
+**Project → Save project…** et enregistrez le fichier sous
+`first-layout.pilot.json`. C’est ce fichier qu’il faut rouvrir pour poursuivre
+l’édition : il conserve le projet, notamment les réglages des sources, le recadrage
+et les images de référence.
+
+Utilisez **Project → Open project…** pour le charger ultérieurement.
+
+## 5. Exporter la géométrie des calques
+
+Choisissez **Project → Export → Export layers…**, sélectionnez **SVG** et
+**All layers**, puis cliquez sur **Export…** et enregistrez le fichier. Pour exporter
+uniquement les rectangles des calques, laissez désactivées les images d’arrière-plan
+et les images de substitution. Le SVG peut être ouvert dans un éditeur vectoriel.
+
+Comparez les possibilités des fichiers et du presse-papiers dans le
+[tableau des fonctionnalités par format (en anglais)](../format-matrix.md)
+avant de choisir un format d’échange.
+
+Conservez aussi le projet `.pilot.json` : un export de géométrie ne garde pas tous
+les réglages de l’éditeur. Le [catalogue de modèles (en anglais)](../../../templates/canvas-pilot/catalog.md)
+propose des compositions équivalentes dans chaque format pris en charge si vous
+préférez commencer dans une autre application.
+
+## Poursuivre avec le guide avancé
+
+Vous disposez maintenant d’un projet modifiable et d’un export de géométrie.
+Choisissez la prochaine étape parmi ces chapitres **en anglais** :
+
+- [Organiser et aligner les calques](../editing.md), avec les dossiers et les sélections multiples.
+- [Ajouter des images de référence et ajuster la vue du canevas](../canvas.md).
+- [Régler les formats des sources et le recadrage](../formats-and-crop.md).
+- [Importer une géométrie existante ou choisir les éléments à exporter](../files.md).
+- [Connecter un Eikos 4K et vérifier les transferts de calques](../device.md).
+ L’envoi vers un appareil est une action explicite ; l’édition locale ordinaire
+ n’envoie aucune modification.
+
+Le [guide avancé (en anglais)](../overview.md) donne aussi accès aux réglages,
+aux contrats de compatibilité et aux détails des vérifications matérielles.
+
+
diff --git a/docs/canvas-pilot/guide/quickstart.md b/docs/canvas-pilot/guide/quickstart.md
index f0761d6..4e6449e 100644
--- a/docs/canvas-pilot/guide/quickstart.md
+++ b/docs/canvas-pilot/guide/quickstart.md
@@ -1,5 +1,7 @@
# Quick start: your first layout
+**English — authoritative version** · [Français — traduction automatique non vérifiée](fr/quickstart.md)
+
[Introduction](../introduction.md) · [Advanced guide](overview.md) · [Starter files](../../templates/canvas-pilot/catalog.md)
Make a simple Slides + Presenter layout, save an editable project, and export its
diff --git a/docs/canvas-pilot/introduction.md b/docs/canvas-pilot/introduction.md
index fd803cc..c978a29 100644
--- a/docs/canvas-pilot/introduction.md
+++ b/docs/canvas-pilot/introduction.md
@@ -14,6 +14,9 @@ a supported Midra 4K or Aquilon / LivePremier device when you are ready to revie
[Install and update](guide/install.md) · [Quick start](guide/quickstart.md) · [Advanced guide](guide/overview.md) · [Starter files for all formats](../templates/canvas-pilot/catalog.md) · [Changelog](changelog.md)
+[Démarrage rapide en français — traduction automatique non vérifiée](guide/fr/quickstart.md).
+The rest of the manual remains in English, the authoritative source.
+
## Start a layout
Run the desktop app from the repository root:
diff --git a/docs/canvas-pilot/plan.md b/docs/canvas-pilot/plan.md
index ee556ca..4a3a438 100644
--- a/docs/canvas-pilot/plan.md
+++ b/docs/canvas-pilot/plan.md
@@ -104,7 +104,9 @@ Publication is pending an issue-enabled token; the current token lacks
- [ ] **Localization: book first, application second.** Follow the
[localization roadmap](../development/localization.md) for language selection,
translation workflow, publishing, UI catalogs and compatibility checks. Detailed
- tasks and acceptance criteria live there; no translations are shipped yet.
+ tasks and acceptance criteria live there. A French quick-start pilot is available
+ as an unverified machine translation; the rest of the book and application remain
+ English. Human review and broader localization are still pending.
- [ ] **Video showcase, manual and optional chapter demonstrations.** Record a
short showcase for the README and book introduction, then a guided video manual
diff --git a/docs/development/localization.md b/docs/development/localization.md
index 03780b7..52aa69c 100644
--- a/docs/development/localization.md
+++ b/docs/development/localization.md
@@ -2,13 +2,44 @@
[Development](README.md) · [Project plan](../canvas-pilot/plan.md)
-Deliver the translated **book first**, then the **application**. This is a task
-list, not an announcement of available languages. Keep detailed completion status
-here and the overall milestone in the project plan.
+## Current pilot: French quick start only
-English remains the source language. French is the suggested first translation
-for proving the workflow; confirm the initial languages before starting translation.
-Keep the process small enough to maintain without a dedicated translation service.
+The [French quick start](../canvas-pilot/guide/fr/quickstart.md) is an explicitly
+unverified machine translation, requested as a small first step. English remains
+authoritative. No application translation, screenshot changes or human review is
+claimed. The rest of the manual remains English, with explicit fallback links.
+
+For this one-chapter pilot, use translated Markdown in `guide/fr/` and the existing
+mdBook build. The summary and reciprocal chapter links expose the language choice;
+a `lang="fr"` wrapper identifies French content while the book navigation stays
+English. The warning appears in the chapter and print view. Existing assets and
+English URLs remain unchanged. Do not duplicate the whole book for this pilot.
+
+The translation comment records the English source commit. When updating the English
+quick start, compare it with that revision, update the French text (or visibly mark
+it outdated), and advance the recorded revision only after translating the changes.
+For the initial source revision:
+
+```sh
+git diff 1ac01cbf65dbad206f5b989f24924333e688f646 -- docs/canvas-pilot/guide/quickstart.md
+```
+
+The initial difference is only the new reciprocal language link. Human review remains
+pending; build/link checks are not linguistic verification. Keep the visible warning
+until an actual review establishes a new status. Run the pinned manual build after
+updates and check French accents, links, screenshots, search and print output.
+
+For a larger translation effort, evaluate
+[mdbook-i18n-helpers / gettext](https://github.com/google/mdbook-i18n-helpers/blob/main/i18n-helpers/USAGE.md)
+for extracting messages and tracking changed translations. mdBook's
+[language setting](https://rust-lang.github.io/mdBook/format/configuration/general.html)
+sets book language metadata; it does not manage translation freshness. Separate
+language builds and a full language selector remain future work. Do not introduce
+both Markdown and gettext as competing maintained translation sources.
+
+The checklist below describes that broader future work. The pilot intentionally
+ships without a reviewer, with the explicit warning above; the later reviewed-book
+publication criteria do not describe its current status.
## 1. Localize the book
diff --git a/docs/manuals/canvas-pilot/SUMMARY.md b/docs/manuals/canvas-pilot/SUMMARY.md
index 6482eb2..1f57e46 100644
--- a/docs/manuals/canvas-pilot/SUMMARY.md
+++ b/docs/manuals/canvas-pilot/SUMMARY.md
@@ -6,6 +6,7 @@
- [Install and update](../../canvas-pilot/guide/install.md)
- [Your first layout](../../canvas-pilot/guide/quickstart.md)
+ - [Français — démarrage rapide (non vérifié)](../../canvas-pilot/guide/fr/quickstart.md)
- [Starter files for every format](../../templates/canvas-pilot/catalog.md)
# Using Canvas Pilot