Presentation Generator — Dropouts

A Python script that converts any README.md into a themeable HTML slide presentation. Zero dependencies. Python standard library only. One file does everything.

Clone on GitHub

Quick Start

# Clone the repo
git clone https://github.com/Jjohnston70/presentation-generator.git
cd presentation-generator

# Generate presentation from your README
python generate_presentation.py README.md presentation.html

# Open in browser
open presentation.html  # or xdg-open on Linux

What It Does

Parses README.md

Extracts title, features, tech stack, installation steps, and sections automatically. Standard README structure becomes structured slides.

Generates HTML Slides

One file output. No build step. Opens in any browser. Works offline. Self-contained with all CSS and JS inline.

40+ Theme Combinations

Mix and match backgrounds (11), accent colors (11), card styles (8), and font colors (8). Theme panel built-in. Preferences save to localStorage.

Works Everywhere

Keyboard navigation (arrows, space, ESC). Touch/swipe for mobile. No CDN dependencies. No accounts. No internet required to present.

module-files.md

Module Contents

File	Purpose
generate_presentation.py	The generator script (1700 lines, zero dependencies)
README.md	Usage documentation and tradeoffs
ARCHITECTURE.md	How the code works and where to modify
FAILURES.md	What breaks and why (debug guide)
examples/	Sample README and generated output

Tradeoffs

What it does well

Fast iteration (change README, regenerate, refresh)
No vendor lock-in
Works on any machine with Python
Self-contained output

What it doesn't do

No speaker notes
No animations beyond transitions
No collaborative editing
No PDF export (use browser print)

When to Use Something Else

Complex diagrams: Use Mermaid or draw.io, embed as images in README
Live demos: Screen share instead
Team collaboration: Google Slides still wins for real-time editing
Print handouts: Export from browser, but it's not optimized for print

Fork It

This is meant to be modified. Common customizations:

Add your logo: Edit get_template_head(), add an image
Change default theme: Modify CSS variables in :root
Add slide types: Create new render_slide() conditions
Parse different formats: Modify regex patterns in parse_readme()