audio-to-post is a WordPress plugin for newsrooms and podcast publishers. It turns an uploaded audio file or a podcast episode into a transcript and then a draft post, keeping speaker turns and timestamps. It splits long recordings, and it shows the editor the minutes and tokens a run will use before any paid call. The code is at https://github.com/IndianOpinion/audio-to-post, licensed MIT. Version v0.1.0 was released on 19 November 2026.
We wrote it from scratch from a one-line idea. Its PRD says so, and no real transcription provider has been run against it. The 47 utilities in this series were specified, built, reviewed and released between 11 and 19 November 2026 by language-model coding agents under the editor’s direction, in five roles: a spec writer, a spec reviewer, a builder that saw only the spec, an independent code reviewer and a releaser. The editor made the rulings on every open question.
Turning an hour of recorded interview into an article takes an editor several hours. Speech-to-text services do the typing well, but using them by hand has four recurring failures:
article, show_notes or transcript.wp audio-to-post commands.A run is a private post with a state machine: new, fetching, probed, awaiting_confirmation, queued, transcribing, transcript_ready, drafting and draft_ready, with side states for paused, failed, cancelled, expired and empty. Other transitions are refused.
Chunking is pure PHP. There is no shell and no ffmpeg. Mp3Reader walks the MPEG frames to get an exact length and frame-aligned offsets, and WavReader reads the RIFF header. Mp3Chunker and WavChunker cut on those boundaries. Other formats go to the provider whole, or are refused.
The Stitcher maps speaker labels across each overlap by shared speaking time and flags weak mappings. Times are shifted to the recording. The seam is cut in a gap between words near the middle of the overlap. The estimate carries a fingerprint, and a confirmation is refused if anything that affects cost has changed.
For drafts, the model sees segment ids and never times. Speakers and times come from the transcript. Each quote must appear in the segment it cites, and anything else is removed and listed in review notes on the edit screen. Transcription goes through a small TranscriptionAdapter interface, with one generic multipart HTTP adapter, a transcript file importer and a fake adapter for tests.
wp audio-to-post add episode.mp3 --rights-confirmed --mode=show_notes
wp audio-to-post confirm 42
wp audio-to-post run --time=1800
wp audio-to-post export 42 --format=vtt > episode.vtt
draft, even if a filter asks for something else.audiopost_can_spend filter, spend-meter when present, and a cancel flag. In-flight calls are held against the caps under a short lock, so two runs near a cap cannot overshoot..htaccess, and the status screen warns if a test file is reachable.The independent code review found and fixed these before the merge:
Test status: this is v0.1.0. There are 119 PHPUnit tests, run on stubs and mocks without WordPress and with the fake adapter, and it has not run on a live site. Static analysis and code style checks passed. With the fake adapter, a generated 61-minute MP3 gave 7 chunks and all 9,150 script words back after stitching, none duplicated. That is a test of the stitching logic and not a provider run. The GitHub CI workflow has not run: the commit adding it stayed local because the token lacked the workflow scope.
It needs PHP 8.1 or later with mbstring (intl recommended), and WordPress 6.4 or later. Composer also installs llm-json-php, the model caller for drafts.
cd wp-content/plugins
git clone https://github.com/IndianOpinion/audio-to-post.git
cd audio-to-post && composer install --no-dev
Without Composer, transcription, the transcript mode and exports work. The article and show_notes modes need a model caller, supplied through the audiopost_llm_caller filter.