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

feat(export): --kiosk writes a looping kiosk show

hugohe3067cb13c356d
diff --git a/skills/ppt-master/scripts/pptx_transitions.py b/skills/ppt-master/scripts/pptx_transitions.py
index 0dcc7030..4cb598bf 100644
--- a/skills/ppt-master/scripts/pptx_transitions.py
+++ b/skills/ppt-master/scripts/pptx_transitions.py
@@ -3131,12 +3131,56 @@ def set_package_use_timings(
_ensure_presentation_props_references(parts, props_part=props_part)
+def set_package_kiosk_show(parts: MutableMapping[str, bytes]) -> None:
+ """Make ppt/presProps.xml a looping kiosk show (browsed at a kiosk).
+
+ PowerPoint's "Browsed at a kiosk (full screen)" setting: the show loops
+ until Escape and ignores click and keyboard advance, so only timings and
+ hyperlinks move between slides — what a touch-screen guide or a signage
+ loop needs. `useTimings` is left as the timing pass set it.
+ """
+ rels_root = parse_source_xml(parts[PRESENTATION_RELS_PART])
+ existing_props_part = _presentation_props_part(rels_root)
+ props_part = existing_props_part or PRESENTATION_PROPS_PART
+ if props_part in parts:
+ source = parts[props_part]
+ root = parse_source_xml(source)
+ else:
+ if existing_props_part is not None:
+ raise ValueError(
+ f"presentation properties part is missing: {props_part}"
+ )
+ source = (
+ f'<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+ f'<p:presentationPr xmlns:p="{PML_NS}"/>'
+ ).encode("utf-8")
+ root = parse_source_xml(source)
+
+ show_properties = root.find(_qn(PML_NS, "showPr"))
+ if show_properties is None:
+ show_properties = ET.Element(_qn(PML_NS, "showPr"))
+ _insert_show_properties(root, show_properties)
+ show_properties.set("loop", "1")
+ # CT_ShowProperties opens with one of present / browse / kiosk.
+ for child in list(show_properties):
+ if child.tag in {_qn(PML_NS, kind) for kind in ("present", "browse", "kiosk")}:
+ show_properties.remove(child)
+ show_properties.insert(0, ET.Element(_qn(PML_NS, "kiosk")))
+ parts[props_part] = serialize_source_xml(root, source)
+ _ensure_presentation_props_references(parts, props_part=props_part)
+
+
def set_directory_use_timings(
extract_dir: Path,
*,
- enabled: bool = True,
+ enabled: bool | None = True,
+ kiosk: bool = False,
) -> None:
- """Set presentation timing playback in an extracted PPTX directory."""
+ """Set presentation timing playback (and optionally kiosk looping) in an extracted PPTX directory.
+
+ ``enabled=None`` leaves ``useTimings`` untouched so a kiosk show can be
+ written without claiming timed advance.
+ """
part_names = {
PRESENTATION_RELS_PART,
CONTENT_TYPES_PART,
@@ -3150,7 +3194,10 @@ def set_directory_use_timings(
name: (extract_dir / name).read_bytes()
for name in part_names
}
- set_package_use_timings(parts, enabled=enabled)
+ if enabled is not None:
+ set_package_use_timings(parts, enabled=enabled)
+ if kiosk:
+ set_package_kiosk_show(parts)
for name, payload in parts.items():
path = extract_dir / name
path.parent.mkdir(parents=True, exist_ok=True)
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py
index 1445a966..58b7a326 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py
@@ -6626,6 +6626,7 @@ def create_pptx_with_native_svg(
transition: str | None = 'fade',
transition_duration: float = 0.5,
auto_advance: float | None = None,
+ kiosk: bool = False,
use_compat_mode: bool = True,
notes: dict[str, str] | None = None,
enable_notes: bool = True,
@@ -6698,6 +6699,7 @@ def create_pptx_with_native_svg(
generated page transition.
transition_duration: Transition duration in seconds.
auto_advance: Auto-advance interval in seconds.
+ kiosk: Write a looping kiosk show (no click/keyboard advance).
use_compat_mode: Retained for API compatibility; ignored in native mode.
notes: Notes dict, key is SVG stem, value is notes content.
enable_notes: Whether to enable notes embedding.
@@ -8449,8 +8451,12 @@ def create_pptx_with_native_svg(
f"{pruned_page_plan_parts} unreachable part(s)"
)
- if package_uses_timings:
- set_directory_use_timings(extract_dir)
+ if package_uses_timings or kiosk:
+ set_directory_use_timings(
+ extract_dir,
+ enabled=True if package_uses_timings else None,
+ kiosk=kiosk,
+ )
reinjected_resources = _reinject_roundtrip_resources(
extract_dir,
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
index 438e29e6..433606ae 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
@@ -2229,6 +2229,10 @@ Recorded narration:
help='Transition duration in seconds (default: 0.4)')
parser.add_argument('--auto-advance', type=non_negative_float, default=None,
help='Auto-advance interval in seconds (default: manual advance)')
+ parser.add_argument('--kiosk', action='store_true',
+ help='Export as a looping kiosk show: PowerPoint ignores click and '
+ 'keyboard advance, so only --auto-advance timings and hyperlinks '
+ 'move between slides')
parser.add_argument('-a', '--animation', type=str, choices=animation_choices,
default=None,
@@ -3750,6 +3754,7 @@ Recorded narration:
transition_sound=transition_sound,
transition_duration=transition_duration,
auto_advance=auto_advance,
+ kiosk=args.kiosk,
notes=notes,
enable_notes=enable_notes,
animation=animation,