gitwtfhub

wtf is shuttleslide?

solider-shuwen/shuttleslide — explained in plain English

Analysis updated 2026-05-18

104HTMLAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A Python CLI and library that converts PowerPoint decks to editable HTML and back while preserving formatting.

Mindmap

mindmap
  root((repo))
    What it does
      PPTX to HTML
      HTML to PPTX
      AI slide generation
    Tech stack
      Python
      Playwright
      python-pptx
    Use cases
      RAG ready HTML
      Editable PPTX output
      Topic to deck generation
    Audience
      Developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Convert a PowerPoint deck into clean HTML for search indexing, a retrieval system, or web publishing.

REASON 2

Turn AI generated or hand written HTML slides back into a fully editable native PowerPoint file.

REASON 3

Generate a first draft slide deck from just a topic using an OpenAI compatible model, then refine it in PowerPoint.

What's in the stack?

PythonHTMLPlaywrightpython-pptx

How it stacks up

solider-shuwen/shuttleslidearef-vc/tufte-claude-skillmfranzon/render
Stars104102107
LanguageHTMLHTMLHTML
Setup difficultymoderateeasyeasy
Complexity3/51/52/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs a one-time Playwright Chromium install, AI generation requires an OpenAI compatible API key.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Shuttleslide is a Python library and command line tool that converts PowerPoint files into HTML and back again, aiming to preserve as much of the original formatting as possible on each trip between the two formats. Unlike tools that turn slides into flat images, it keeps real, editable elements on both sides, such as text boxes, tables, and native PowerPoint shapes, and it embeds extra metadata in the HTML so that converting back to PowerPoint restores the original coordinates, fonts, and structure. The project offers three separate capabilities. The first turns a pptx file into a single HTML file, with a choice of three layouts: a scrollable page suited to search indexing or feeding into a retrieval system, an editor style preview meant to look close to the original slide, and an interactive slideshow with keyboard navigation and transitions, which is the default. The second direction converts HTML back into a pptx file using a rule based pipeline with no AI involved, producing shapes that stay fully clickable and editable inside PowerPoint itself. This direction only works reliably on a limited subset of HTML the project calls Slide HTML, described in its own documentation. The third capability skips source files altogether: given just a topic, it can generate a full slide deck using any OpenAI compatible language model, including options like Zhipu GLM, DeepSeek, or a locally run Ollama model, with an optional web interface that pauses at each step for a person to approve the result. Installation is through pip, with optional extras for the AI generation feature and the web review interface, plus a one time setup step to install a headless Chromium browser that the tool uses internally for layout work. Python 3.9 or newer is required. The README positions the project as different from similar tools mainly because it supports both conversion directions with format preserving metadata, rather than just one direction, and because the core pptx and html conversion pipeline works entirely offline without needing any language model. It is released under the MIT license.

Yoink these prompts

Prompt 1
Use shuttleslide to convert deck.pptx into a scrollable HTML page I can feed into a RAG pipeline.
Prompt 2
Generate a slide deck about our quarterly business review with shuttleslide and convert it to a native pptx file.
Prompt 3
Explain what the Slide HTML subset is and why shuttleslide's to-pptx command only works reliably on it.
Prompt 4
Show me how to install shuttleslide with the AI generation and web review extras.

Frequently asked questions

wtf is shuttleslide?

A Python CLI and library that converts PowerPoint decks to editable HTML and back while preserving formatting.

What language is shuttleslide written in?

Mainly HTML. The stack also includes Python, HTML, Playwright.

What license does shuttleslide use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is shuttleslide to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is shuttleslide for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.