Documentation

Full documentation index for Mr. Pumpkin.

Documentation

🚀 Installation & Usage

Install Mr. Pumpkin, set it up as a system service, and get running on Linux, Windows, or Raspberry Pi.

🔌 Building a Client

Connect to Mr. Pumpkin from any language via TCP or WebSocket. Full command reference and code examples.

🤖 AI Recording Skill

Describe an animation in plain English and have Google Gemini generate and upload the timeline automatically.

📋 Timeline JSON Schema

Full reference for the timeline format: structure, command vocabulary, timing rules, and validation.

🔄 Auto-Update Guide

Automated update scripts for Linux/macOS and Windows — cron job or Task Scheduler setup.

📣 What's New

Full release history and changelog — every version's features, fixes, and changes.

---

Quick Reference

Run the application

python pumpkin_face.py             # Fullscreen, default monitor
python pumpkin_face.py 1           # Fullscreen, second monitor
python pumpkin_face.py --window    # Windowed mode

Send a command

# netcat
echo "happy" | nc localhost 5000

# Python
import socket
s = socket.socket()
s.connect(('localhost', 5000))
s.send(b'happy')
s.close()

// WebSocket (browser / Node.js)
const ws = new WebSocket('ws://localhost:5001');
ws.onopen = () => ws.send('happy');

Version History

See the full What’s New page for the complete changelog.

Version	Date	Highlights
0.5.10	2026-03-03	Recording chaining, help command
0.5.8	2026-03-02	AI recording skill (Google Gemini)
0.5.0	2026-02-27	WebSocket dual-protocol support
0.4.1	2026-02-26	Timeline upload/download