Screenshots for script buttons, live mode, macro recorder and the merged features documented today (from the PRs' own captures; recovery-dialog path masked)

aligning_items.md

@@ -114,6 +114,8 @@ Each of these commands, and *Aligner sur la grille*, has its own icon in the
 menu, the right-click menu, command search and the shortcut bar
 ([PR #1153](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1153), merged 2026-09-29).
 
+![Command search for 'align' and 'centrer' in light and dark palettes, each Align command with its icon](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/align-icons-command-search.png)
+
 With a single item selected the six commands are greyed out; only Snap to
 grid is available. A single group counts as one item, however many things
 are in it.

assistant_live_mode.md

@@ -67,6 +67,8 @@ The tools are kept apart so one can never be taken for the other.
 
    So a setting you forgot about can never leave the door open silently.
 
+   ![The startup warning: live mode is on, each action is undone with Ctrl+Z, the Arrêter button cuts the connection; buttons Désactiver, Pas pour cette session and Continuer](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/live-mode-warning.png)
+
 With the setting off, QElectroTech opens nothing at all and behaves exactly as
 it does without this feature; the `qet_live_*` tools answer that live mode is
 off and do nothing. When they cannot connect, they say which of the three
@@ -94,6 +96,8 @@ lists every action, newest first: the time, ✓ or ✗, and its undo step's name
 Hover an entry, or double-click it, for the details: the error, what the
 script logged, and the script itself.
 
+![The Assistant panel during a test session (ask-first unticked): a list of timed actions with ticks and crosses — screenshot, undo_last refused, show_folio, a refused diagrameditor.delete_selection, zoom_fit — and below it the status bar reading 'Mode direct : ✓ screenshot à 10:36:25' with the Arrêter button](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/live-mode-dock.png)
+
 At the top: *Demander avant d'exécuter un script écrit par l'assistant* (*Ask
 before running a script the assistant wrote*), **ticked at every start**. While
 it is ticked, a script the assistant wrote on the spot is shown to you first,
@@ -106,6 +110,8 @@ run a script*):
 | *Refuser* (*Refuse*) | nothing happens; the assistant is told you refused |
 | *Toujours pour cette session* (*Always this session*) | runs it and stops asking until the next start |
 
+![The ask-first box: the assistant's one-line script that adds a text on the sheet on screen, with Toujours pour cette session, Refuser and Exécuter](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/live-mode-ask-first.png)
+
 Stored scripts — the **[script buttons](script_buttons)** you already have —
 run without asking: you put them there.
 

collection_browser.md

@@ -41,6 +41,8 @@ forme de liste triée* (*Show search results as a ranked list*) in
 **Configurer QElectroTech > Général** ([PR #1083](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1083)). The search then
 filters the tree as it did before, with the tree's own keyboard navigation.
 
+![Searching 'diode' two ways: on the left the ranked list (Diode, diode-tube, Diode bridge…), on the right the filtered tree, opened down to Electric > All-pole > Electronics and semiconductors > Diode](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/collections-search-list-vs-tree.png)
+
 ---
 
 ## 2. The three collections, and which ones you can actually edit
@@ -160,6 +162,8 @@ ready to drag onto a cabinet layout sheet.
 - The entry is hidden when no selected symbol has both values.
 - Like anything embedded, the thumbnails travel inside the `.qet` file.
 
+![A selection's right-click menu with Générer une vignette d'armoire below Créer un template](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/cabinet-thumbnail-menu.png)
+
 Since [PR #1170](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1170) (merged 2026-09-29); discussion
 [#602](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/602).
 

element_editor.md

@@ -197,6 +197,8 @@ another width and height, for example the size of one cell or of the space a
 symbol usually gets. Both settings are remembered between sessions; the frame
 is off by default.
 
+![The symbol editor with a relay symbol in the middle of a large dashed blue frame; the frame toggle is checked on the toolbar](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/element-editor-background-frame.png)
+
 The frame is only drawn on screen. It is not saved in the symbol, and it does
 not appear in an SVG export.
 

faq.md

@@ -287,6 +287,8 @@ At the next start after a crash, a window titled **Fichiers de restauration**
 newest, marked *(la plus récente)* (*most recent*), is selected; pick an older
 one if the newest is the broken one. The copies you did not pick are deleted.
 
+![The Fichiers de restauration window: one project listed, with a drop-down set to its newest copy, marked (la plus récente), and Cancel and OK buttons](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/faq-recovery-files.png)
+
 A copy that cannot be read gives a warning instead of crashing QElectroTech
 again ([PR #1031](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1031)).
 

macro_recorder.md

@@ -53,6 +53,8 @@ QElectroTech answers. So the recording is saved where the assistant's
    (*Recording: N steps*) with an **Arrêter** (*Stop*) button.
 4. Stop: **Arrêter**, or the same menu entry, which is ticked while recording.
 
+![The status bar while recording: a red dot, 'Enregistrement : 1 étape(s)', and the Arrêter button](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/macro-recorder-status.png)
+
 A box, *Macro enregistrée* (*Macro recorded*), gives the recording's name
 (*Macro du 02/10/2026 14:30*), its number of steps and its folder:
 
@@ -62,6 +64,8 @@ A box, *Macro enregistrée* (*Macro recorded*), gives the recording's name
 | *Ouvrir le dossier* (*Open the folder*) | opens the recording's folder |
 | *Fermer* (*Close*) | closes the box; the recording stays saved |
 
+![The Macro enregistrée box: the recording's name and step count, the folder it was saved in, and the buttons Ouvrir le dossier, Fermer and Copier la demande pour l'assistant](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/macro-recorder-box.png)
+
 Recording needs no setting: it only writes files. Turning it into a script
 does — see below.
 

preferences.md

@@ -194,6 +194,8 @@ From the **Configuration** menu, below *Configurer QElectroTech*:
 | **Enregistrer la configuration sous...** (*Save configuration as*) | saves every setting to a `.conf` file |
 | **Charger une configuration...** (*Load configuration*) | replaces your settings with a saved file, then **closes QElectroTech**; start it again to use them |
 
+![The Configuration menu: Afficher, Passer en mode plein écran, Configurer QElectroTech, then Enregistrer la configuration sous… and Charger une configuration…](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/preferences-configuration-menu.png)
+
 Use it to keep one set of settings per customer or drawing standard, to move
 your settings to another computer, or to keep a copy before trying something.
 The file is plain text in ini format, the same on every system.
@@ -218,6 +220,10 @@ their fixed size. Since [PR #1165](https://github.com/qelectrotech/qelectrotech-
 fixed the PLC input/output table's *Type* column showing as light grey boxes
 under a dark system theme.
 
+| Before | After |
+|---|---|
+| ![PLC input/output table under a dark system theme, Type column drawn as light grey boxes](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/preferences-plc-table-dark-before.png) | ![The same table after the fix, Type column dark like the others](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/preferences-plc-table-dark-after.png) |
+
 ---
 
 See also: **[Project XML](project_XML)** · **[Linking elements](element_linking)** ·

script_buttons.md

@@ -117,6 +117,8 @@ broken.js: unknown header key @shortcutt* (*Ignored*), so you can see which
 line is wrong. A misspelt shortcut that silently did nothing would be harder
 to find.
 
+![The Projet > Scripts menu: a stored script with its icon, then a greyed entry 'Ignoré : broken.js: unknown header key @shortcutt', then Gérer les scripts, Exécuter un script and Ouvrir le dossier des scripts (captured before the macro recorder entry was added)](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/script-buttons-menu.png)
+
 A file name becomes the script's id: `add-revision-note.js` is
 `diagrameditor.script.add-revision-note` in the shortcut settings.
 
@@ -146,6 +148,8 @@ Below the scripts, the **Projet > Scripts** menu holds:
 | *Exécuter un script...* (*Run script*) | run any `.js` file once, as before — it moves here from the *Projet* menu |
 | *Ouvrir le dossier des scripts* | open the scripts folder |
 
+![The Scripts toolbar after the arrange buttons: one script with an SVG page icon, one with an orange initials tile reading HL](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/script-buttons-toolbar.png)
+
 ### One click, one Ctrl+Z
 
 > **Status: pending** — [PR #1219](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1219).
@@ -183,6 +187,8 @@ scripts with their icons on the left, and edits the selected one on the right.
 
 Below the fields is the script's text, a plain text editor.
 
+![The Gérer les scripts window: three scripts listed with their icons on the left; on the right the Nom, Icône (pick.svg, with a blue triangle preview), Info-bulle, Raccourci and Actif fields, the script text, and the Nouveau, Supprimer, Tester, Enregistrer, Ouvrir le dossier and Fermer buttons](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/script-buttons-manager.png)
+
 | Button | Does |
 |---|---|
 | *Nouveau* (*New*) | starts a script called *Nouveau script* from a template |