Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

docs(animations,transitions): document --kiosk

hugohe3f8b999fcdc3f
diff --git a/skills/ppt-master/references/animations.md b/skills/ppt-master/references/animations.md
index 9b40a9d1..3fdee500 100644
--- a/skills/ppt-master/references/animations.md
+++ b/skills/ppt-master/references/animations.md
@@ -14,7 +14,7 @@ Motion is several separate capabilities, not one dial; two of them are decided w
| A continuous action — slide-in, flip, camera push-in, progressive reveal, camera pan | **Morph: author the action as two static pages**, then select Morph and add explicit pairs when identity must be deterministic; there is no keyframe timeline anywhere — the difference between two editable slides *is* the animation | **Page authoring (Step 6), then motion post-processing** — §2.1, §3.1 |
| A static full-bleed page that should stop looking frozen | Slow `path_*` motion on a visually subordinate image or atmospheric layer | Post-processing; §4.1 |
| Carousel, counting numerals, parallax depth, click-to-reveal flip card | Four recipes assembled from the mechanisms above; carousel and odometer need paired pages | §4.2 |
-| Unattended looping playback | `--auto-advance <seconds>`, optionally with `-t none` | Export; §3 |
+| Unattended looping playback | `--auto-advance <seconds>`, optionally with `-t none`; add `--kiosk` when the show must loop and ignore clicks (signage, a touch guide navigated by its own buttons) | Export; §3 |
| A transition or object animation needs an audible cue | Optional `transition.sound` or object `sound`, selected only after the visual solution is complete and synced from the global library; a narrated MP4 uses either the verified native-export mix or explicit slideshow capture, never both | Post-motion; §2.2 |
| Nothing should move | `-t none` and per-element `none` | Export; §1 |
@@ -164,6 +164,7 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t none --auto-advanc
| `-t/--transition` | Default `fade`; `none` keeps an explicit auto-advance |
| `--transition-duration` | Default `0.4` |
| `--auto-advance` | Seconds, longer than the page's animation total; click still advances |
+| `--kiosk` | Loop until Escape and ignore click/keyboard advance; only timings and hyperlinks move between slides |
**Hard rule — no silent downgrade**: an unknown effect, unsupported option, or invalid duration fails export and is never replaced by `fade`. Carrier XML, MCE fallbacks, and read-back: [`pptx-transitions.md`](../scripts/docs/pptx-transitions.md).
diff --git a/skills/ppt-master/scripts/docs/pptx-transitions.md b/skills/ppt-master/scripts/docs/pptx-transitions.md
index c151a90a..6800072d 100644
--- a/skills/ppt-master/scripts/docs/pptx-transitions.md
+++ b/skills/ppt-master/scripts/docs/pptx-transitions.md
@@ -291,6 +291,12 @@ effect prefix without updating these attributes corrupts compatibility.
ppt/presProps.xml p:presentationPr/p:showPr useTimings=1. Do not write showPr
into ppt/presentation.xml.
+**Kiosk show**: `svg_to_pptx.py --kiosk` writes `p:showPr loop="1"` with a
+`p:kiosk` child (PowerPoint's "Browsed at a kiosk"): the show loops until
+Escape and ignores click and keyboard advance, so only `advTm` timings and
+hyperlinks move between slides. It leaves `useTimings` to the timing rule, so
+a hyperlink-driven touch guide can be a kiosk show without timed advance.
+
---
## 6. Validation and Read-Back