Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

apple/creator-studio-doc-format

Developer Tools

A Python library for reading, creating, and editing Keynote .keyx presentations programmatically.

146
5
Python
Apache-2.0
3 days old

What it does

This Apple-maintained Python library works with Keynote Interchange Format (.keyx) files. It reads slides, text, images, tables, charts, and styles from a .keyx export, builds new presentations from scratch or from a theme's slide layouts, and edits existing decks with format validation before saving. The library parses and writes the format itself, so it does not need Keynote, an Apple device, or a network connection. It is aimed at developers who need to generate or process presentation files in automated pipelines.

Getting started

Python 3.13 or later is required. Install the package from PyPI:

pip install creator-studio-doc-format

The README's quick start builds a Presentation containing a text box, wraps it in a KeyxDocument, and saves it as hello.keyx (see the quick start):

from creator_studio_doc_format.core import *

title = Textbox(
    geometry=Geometry(position=Position(x=160, y=440), size=Size(width=1600, height=200)),
    stroke=Stroke(empty=True),
    layout_properties=LayoutProperties(vertical_alignment="center"),
    paragraph_properties=ParagraphProperties(
        alignment="center",
        character_properties=CharacterProperties(font_size=96),
    ),
    text=Text(string="Hello, Keynote"),
)
slide = Slide(contents=[SlideObject(object=CanvasObject(textbox=title))])

doc = KeyxDocument(
    Presentation(
        theme=KeynoteTheme(name="White", locale="en_US"),
        slide_size=Size(width=1920, height=1080),
        slides=[slide],
    )
)
doc.save("hello.keyx")

The resulting file opens in Keynote. For every slide content type, runnable scripts live in the examples directory. The guide walks through creating, validating, and navigating documents, and the API reference covers all public symbols.

Constraints and limits

  • Python 3.13+ is mandatory.
  • Input and output are .keyx files; previewing requires Keynote on an Apple device, and converting to formats such as PDF elsewhere relies on the separate Creator Studio Document Exporting API rather than this library.
  • Contributions are limited to issues at present; the project is not accepting code or documentation pull requests.
  • Licensed under Apache 2.0.

Agent skill

A bundled creator-studio-doc-format skill teaches a coding agent to use the library, installable from the latest release with gh skill install apple/creator-studio-doc-format creator-studio-doc-format. The skill folder also works with any agent that reads SKILL.md directories, provided the library itself is installed.

HotRepo's take

The project appeared on HotRepo's new-project list on 2026-11-19, its first recorded day, gaining 16 stars in a one-hour observation window and reaching 117 stars total. That is a short window on a young repository, so it shows early attention rather than sustained momentum. The practical value here is the offline, Keynote-free handling of a document format Apple controls, which makes automated deck generation feasible in server-side Python; the lack of a best daily rank record so far is consistent with a project only just entering its tracking period.

Written by AI from the project's README, updated . The project's own docs are the source of truth.