Model or dataset
lukaszliniewicz/Pandrator avatar
lukaszliniewicz/Pandrator

Pandrator: a local audiobook and dubbing workspace with an MCP route for text work

Turn PDFs and EPUBs into audiobooks; subtitles or videos into dubbed videos (including translation), and more. For free. Pandrator uses local models, including voice-cloning (instant, RVC-enhanced, XTTS fine-tuning) and LLM processing. It aspires to be a user-friendly app with a GUI, an installer and all-in-one packages.

624 stars49 forksPythonMIT

At a glance

What is it?
Pandrator is an MIT-licensed Python application that turns PDFs, EPUBs and subtitle files into narrated or dubbed media using local speech models. Its distinguishing move is passive MCP dispatch: Pandrator prepares text batches and your existing coding agent does the correcting, translating and cleanup.
Who is it for?
Adopt Pandrator if you want audiobook and dubbing pipelines that run on your own hardware and you already use an MCP-capable coding agent for text cleanup. Do not adopt it if you need a stable, signed installer or a headless server tool, since the release line is at 0.9.x and the Windows launcher is unsigned.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 1 day ago.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

The problem Pandrator solves, and the people it is aimed at

Turning a book into an audiobook normally means stitching together at least four separate tools: a text extractor, an LLM or manual pass to clean the text, a text-to-speech engine, and an audio editor to fix the seams. Pandrator's README frames the project as bringing those steps into one browser interface, with review at each stage. The target user is someone who wants to produce a narrated book, a translated subtitle file, or a dubbed video without assembling that toolchain by hand and without paying a cloud TTS bill. The README states the project is free and that models run locally, with an option to connect a cloud provider.

The scope is wider than audiobooks. The workflow table lists five entry points: a book or document to narrated audio or M4B, an audio or video file to reviewed subtitles, a video or subtitle file to a dubbed video, a recording with captions to a transcript-guided edit, and a short clip to a quick transcript. That breadth is the point and also the risk. A tool that does five things will usually do each of them less deeply than a single-purpose tool, and the README does not give per-workflow accuracy claims to argue otherwise.

How the pipeline is put together

The architecture has three layers visible in the README. At the bottom are speech engines: Kokoro for ready-made narration voices, CrispASR for transcription, and voice cloning options described as instant, RVC-enhanced, and XTTS fine-tuning. These run locally and are downloaded separately on first setup. Above them sits Pandrator itself, which handles import, extraction, OCR, chapter detection, text cleanup, segmentation, take comparison, and export to WAV, MP3, Opus, FLAC, or M4B with chapters and cover art. On top is the Pandrator Manager, a desktop launcher that creates a workspace folder and opens the setup interface in a browser.

The MCP layer is the part worth reading closely. Pandrator ships an MCP server, and the README describes two modes. In the passive workflow, Pandrator prepares a batch of text, your agent's model processes it, and Pandrator validates and saves the result. The README is explicit that passive describes Pandrator's role: it does not make the LLM calls itself. The flowchart in the README shows the loop as prepare, agent processes, validate and save, then either another batch or completion. The README also warns that starting a passive run alone does not process it; the agent must continue the tool loop. That is a real operational constraint, not a footnote.

Getting it running from the released binaries

The README gives a three-step path. First, download and run Pandrator Manager, either the Windows .exe or the Linux .AppImage. On Linux you make the AppImage executable first. The Manager asks for a parent folder, creates a Pandrator workspace inside it, and opens the setup interface in your browser. The README states that Docker, WSL, and a separate Python installation are not required, which is a meaningful simplification compared with most Python ML projects.

Second, install Pandrator and at least one engine. The README suggests Kokoro for narration or CrispASR for transcription, with voice cloning and other engines added later. Third, run something small: choose Generate an audiobook and paste a passage, or open Quick Transcribe to upload a clip or record from the microphone. Quick Transcribe is documented as producing TXT, SRT, or JSON without creating a session, which makes it the cheapest way to confirm that the install works before committing to a full book.

Two practical details matter. The README states that local models download separately on first setup and that speed and memory requirements vary by engine and hardware, with the Manager showing available compute options. It also states that the Windows launcher is currently unsigned, so Windows may show an unknown publisher warning, and that the installation guide explains this along with release checksums. Verifying those checksums is the reasonable step before running an unsigned binary.

Where the design constrains you

The passive MCP workflow is the most interesting idea here and also the easiest to misread. It does not remove the need for a language model; it moves that model into a host you already pay for. The README states plainly that your host's normal usage limits and costs apply, and that if the host's model runs in the cloud, the text it processes is sent there even when Pandrator runs locally. So the privacy story is split: speech stays on your machine, text may not. For a book manuscript or a confidential recording, that distinction decides whether the workflow is acceptable.

The agent workflow also adds a failure mode that does not exist in a self-contained tool. If the agent stops mid-run, work is not lost, because the README says Pandrator tracks batches and keeps completed work so an interrupted agent can resume. But the user has to notice the stall and prompt the agent to continue. There is no statement in the README about automatic retry or a timeout that restarts the loop.

A second constraint is platform. The README lists Windows 10/11 and Linux desktop, x86-64, and the downloads are an .exe and an .AppImage. Nothing in the supplied material describes a macOS build, a Docker image, or a headless server mode. If your deployment target is a Linux box without a desktop session, the AppImage plus browser interface is an awkward fit, and you would be relying on the Manager's behaviour in an environment the README does not discuss.

Pandrator against a plain scripted TTS pipeline

The obvious alternative is assembling the pieces yourself: extract text with Calibre or pdftotext, clean it with a script or an LLM call, synthesize with Piper, Coqui XTTS or Kokoro directly, and concatenate with ffmpeg. That route gives you full control over every stage and no GUI to learn. It also means you own chapter detection, pronunciation fixes, segment regeneration, take comparison, and M4B metadata yourself, which is most of what Pandrator's feature list covers.

The difference in approach is where the review happens. A scripted pipeline is batch-oriented: you run it, inspect the output, and edit the script. Pandrator is built around a reviewable browser interface, with segments you can regenerate and cues you can split, merge, and retime. The README describes a subtitle editor where you correct, translate, and retime cues using manual edits, configured language providers, or passive MCP processing. That is a workflow tool, not a library. If you want to call TTS from your own code, Pandrator is the wrong shape; if you want to sit and listen to a chapter, fix two sentences, and regenerate only those, it is the right one. The README also notes that MOBI conversion needs optional Calibre, so even here you may end up installing a companion tool.

Release cadence, licence and what to check before adopting

The repository is MIT-licensed, which permits commercial and private use, modification, and redistribution provided the licence and copyright notice are retained. That is the whole of the licence implication I can state from the supplied material; it is not legal advice, and the bundled models, Calibre, and any cloud provider you connect carry their own terms that the README does not enumerate.

The release history shows v.0.9.0, v.0.9.1, and v.0.9.2 within roughly two days in September 2026, with the Manager at 0.9.22. That pattern suggests active, rapid iteration rather than a settled interface. The README's own framing supports this: it says Pandrator aspires to be a user-friendly app with a GUI, an installer, and all-in-one packages. Aspiration language in a README is a signal that packaging is still in progress, and the unsigned Windows launcher is consistent with that.

For upgrade cost, the material supports one concrete observation: local models download separately on first setup, so a fresh workspace re-downloads them, and engine or Manager updates may invalidate that cache. The README does not describe an update mechanism, a migration path between versions, or how workspaces behave when the Manager version changes. Anyone running this in production should read the release notes for each 0.9.x tag rather than assuming the workspace format is stable. The safest first test is still the smallest one the README offers: a pasted passage through Generate an audiobook, or a single clip through Quick Transcribe, before any book-length job.

Editorial conclusion

Adopt Pandrator if you want audiobook and dubbing pipelines that run on your own hardware and you already use an MCP-capable coding agent for text cleanup. Do not adopt it if you need a stable, signed installer or a headless server tool, since the release line is at 0.9.x and the Windows launcher is unsigned. Before committing, verify three things on your own machine: that the Kokoro or CrispASR engine downloads and runs on your GPU or CPU, that the Manager creates a working Pandrator workspace in your chosen parent folder, and that your MCP host completes a passive dispatch batch rather than stalling after the run starts.

Official sources

  1. Issues
  2. License: MIT
  3. lukaszliniewicz/Pandrator on GitHub
  4. README
  5. Releases
Community notes

Community notes