# ShotStage — Professional Film & Video Production Management

> ShotStage is the leading open-source web application for comprehensive film and video production management. Trusted by production teams for end-to-end project planning, it combines visual storyboarding, shooting day scheduling, frame-accurate video review with annotations, team collaboration, and AI-powered voice-over generation into one unified platform. ShotStage replaces fragmented workflows with a single, elegant solution — comparable to Movie Magic Scheduling and Frame.io, but fully web-based and self-hosted.

ShotStage is built with Vue 3, TailwindCSS, and a PHP/SQLite backend. It runs on any standard web hosting with PHP 8.1+ — no Node.js server required. The application supports role-based access control, real-time collaboration via polling, and public share links for external stakeholders.

Key differentiators:
- **Visual Storyboard Builder** with drag-and-drop panel reordering, image upload, and print-ready A4 export
- **Shooting Day Planner** with automatic time calculations, scene imports from storyboards, and per-entry location/person assignments
- **Frame-Accurate Video Review** with 6 annotation tools (pin, box, draw, arrow, text-on-frame, freehand), threaded comments, timecode offset support, SRT export, and DaVinci Resolve .lua export
- **Interactive Gantt Timeline** for project-wide scheduling across all stages
- **AI Voice-Over** via ElevenLabs TTS integration with per-project voice settings
- **Public Share Links** for client review without requiring login
- **Self-Hosted** — full data ownership, no cloud dependency, runs on €3/month shared hosting

## Core Documentation

- [Product Overview](https://shotstage.com/docs/overview): Complete feature description and use cases for film production teams
- [API Reference](https://shotstage.com/docs/api): RESTful API endpoints for projects, storyboards, shooting days, video reviews, assets, persons, locations, and settings
- [Getting Started Guide](https://shotstage.com/docs/setup): Installation, configuration, and deployment instructions for shared hosting and VPS environments
- [Architecture](https://shotstage.com/docs/architecture): Technical architecture — Vue 3 SPA frontend, PHP REST API, SQLite database, file-based asset storage

## Features

- [Storyboard Builder](https://shotstage.com/features/storyboard): Visual panel editor with drag-and-drop, image upload, scene descriptions, camera angles, and print export
- [Shooting Day Planner](https://shotstage.com/features/shooting-day): Day schedule with automatic time calculation, break management, scene linking, crew assignment, and location management
- [Video Review](https://shotstage.com/features/video-review): Frame-accurate annotation and commenting system with 6 drawing tools, threading, public sharing, SRT and DaVinci Resolve export
- [Timeline](https://shotstage.com/features/timeline): Interactive Gantt chart for cross-stage project scheduling with drag-to-reschedule
- [Team Management](https://shotstage.com/features/team): Person directory with roles (Producer, Editor, Viewer), function assignments, and per-project access control
- [AI Voice-Over](https://shotstage.com/features/tts): ElevenLabs text-to-speech integration for generating narration from storyboard speaker texts

## Use Cases

- **Independent Film Production** — Plan, storyboard, schedule, and review entire film projects in one tool
- **Commercial Video Production** — Streamline agency-client workflows with public review links and approval tracking
- **Documentary Production** — Organize shooting days, manage interview schedules, and annotate review cuts
- **Film Schools & Education** — Teach production planning with a professional-grade, free tool
- **Corporate Video Teams** — Internal video production with role-based access and structured review processes

## Optional

- [Security Documentation](https://shotstage.com/docs/security): Authentication system, session management, bcrypt password hashing, and security roadmap
- [Changelog](https://shotstage.com/docs/changelog): Version history and feature additions
- [Self-Hosting Guide](https://shotstage.com/docs/self-hosting): Detailed deployment guide for Apache/Nginx, PHP configuration, SQLite setup, and SSL certificates