How lukaszliniewicz/pandrator works
Pandrator is a browser-based workspace for turning documents and media into audiobooks, transcripts, translated subtitles, voiceovers, and reviewed video edits. A user selects a workflow in the web interface; the API coordinates session-backed processing and results are reviewed and exported. Major branches also include temporary quick transcription and MCP-assisted preparation, validation, and resumable work. Manager handles installation and runtime operations. The README documents product flows; the source excerpts show API, MCP, and manager entry points, but not the full processing call graph, so undocumented links are omitted.
Main entry points: api_routes.py HTTP API · server.py MCP tools · tts_handler.py Audiobook generation · workflow_export.py Review and export
Components 16
Browser workspace
- Web interface
pandrator/web/static/_app/immutable/entry/app.DpXEFSz1.js - HTTP API
pandrator/web/api_routes.py - Sessions and state
pandrator/web/models.py
Media workflows
- Document preparation
pandrator/logic/source_cleaning/pipeline.py - Audiobook generation
pandrator/logic/tts_handler.py - Subtitle and dubbing
pandrator/logic/dubbing/workflow.py - Quick transcription
pandrator/web/quick_transcription_routes.py - Recording edits
pandrator/web/media_edit_routes.py - Review and export
pandrator/web/workflow_export.py
Speech services
- Speech engines
pandrator/logic/tts_provider_profiles.py
Automation
- MCP tools
pandrator_mcp/server.py
Runtime management
- Manager API
pandrator_manager/api/app.py - Manager operations
pandrator_manager/application.py - Operation journal
pandrator_manager/operations/engine.py
Other components
- User
- MCP-capable agent
Connections 19
- User → Web interface: chooses workflow
README.md - Web interface → HTTP API: sends requests
- HTTP API → Sessions and state: reads and writes
pandrator/web/api_routes.py - HTTP API → Document preparation: prepares documents
- HTTP API → Audiobook generation: starts generation
- HTTP API → Subtitle and dubbing: starts subtitle work
- HTTP API → Quick transcription: offers transcription
README.md - HTTP API → Recording edits: offers editing
README.md - Audiobook generation → Speech engines: uses providers
pandrator/logic/tts_handler.py - User → MCP tools: requests assistance
README.md - MCP tools → MCP-capable agent: coordinates work
README.md - MCP-capable agent → MCP tools: submits results
README.md - MCP tools → HTTP API: tracks work
- User → Manager API: sets up runtime
README.md - Manager API → Manager operations: delegates operations
pandrator_manager/api/app.py - Manager operations → Operation journal: queues tasks
- Audiobook generation → Review and export: produces audio
README.md - Subtitle and dubbing → Review and export: produces subtitles and media
README.md - Recording edits → Review and export: renders reviewed edit
README.md