zwfm-babbel: Babbel: The Broadcast API That Turns News Selection, Voice Branding, and Loudness Into One Pipeline

A Go service for radio stations that chooses stories fairly, mixes them with station-specific jingles, normalizes them to broadcast standards, and serves the result as cached audio for playout systems.

8 min read • View on GitHub • More from oszuidwest

A radio production pipeline shown as a mechanical broadcast desk. News cards enter on one side, a mixer with ducking and loudness controls shapes the audio in the middle, and a finished WAV reel exits toward a radio tower on the other side. The image explains that Babbel turns editorial inputs into broadcast-ready output.
Babbel treats a bulletin like a rendered artifact, not a draft. It chooses, mixes, normalizes, caches, and serves audio that playout software can trust.
Key Takeaways

Babbel does not behave like a content app. It behaves like a machine that produces something a station can air without a human staying up to babysit it. That difference matters, because in radio the hard part is rarely “make audio.” It is “make the right audio, in the right order, at the right loudness, with the right station identity, every time.”

The thing Babbel actually makes

The output is a finished news bulletin. Stories are selected, voiced, branded, mixed, and written out as audio that playout software can fetch on demand. In other words, the repository is not selling creation in the abstract. It is selling readiness.

That framing explains the entire codebase. The service layer, audio layer, scheduler, and public automation endpoints all point toward one job: convert editorial intent into a file a station can trust unattended.

Why radio news is a software problem

Radio sounds simple from the outside. In practice it is a sequence of constraints. Bulletins need to stay current, avoid sounding repetitive, keep a station’s sonic identity intact, and sit at a loudness level that does not jar listeners when they move from music into speech.

Babbel encodes those constraints as rules. That is the important move. The software is not just producing speech. It is preserving a broadcast format.

How Babbel decides what listeners hear

Babbel’s rotation logic is easier to read as a queue than as prose. Breaking news overrides everything, unused stories come next, and older stories only return when the day has run out of fresh options.

A three-lane sorting gate for radio stories. The top lane opens for breaking news, the middle lane holds unused stories from today, and the bottom lane loops older stories as least recently used. A midnight clock resets the system. The image explains how Babbel keeps bulletins fresh without repeating the same items.
The core editorial trick is not invention, it is rotation. Babbel keeps the bulletin fresh by making repetition the fallback, not the default.

The selection hierarchy is straightforward: breaking news first, then stories not yet used today, then least recently used fallback. That is a small algorithm with a big editorial effect. It avoids the failure mode every repetitive bulletin system eventually hits, where listeners hear the same three items until the station starts to feel stuck.

The midnight reset is the quiet detail that makes the whole system work. Without it, the day’s rotation would harden into a dead end. With it, the service gets a clean slate and can start fresh without manual intervention.

How the bulletin gets built

Babbel’s audio path is closer to broadcast engineering than to a typical media workflow. It combines spoken stories with station jingles, manages mix points, and normalizes the final file to EBU R128 loudness standards so the bulletin sits naturally in a broadcast chain.

That is a meaningful distinction. Concatenating clips is easy. Making them sound like a station product is the actual work.

story selection -> voice render -> jingle mix -> ducking at mix points -> EBU R128 normalization -> cached WAV output

The structure suggests a pipeline that is built for repeatability. A bulletin is not assembled by a human editor clicking around a UI. It is rendered from stored inputs, using deterministic rules, into a standardized audio artifact.

Why the API looks modern but serves legacy systems

The public surface is modern enough for enterprise use. Authentication and role control sit behind OIDC and RBAC. Errors can be returned as structured Problem Details. The automation endpoint, though, is deliberately old-school in the way playout systems expect: give me a URL, and let me fetch a WAV file.

CapabilityBabbelGeneric CMSTTS-only serviceMedia renderer
Selects stories by editorial rulesYesSometimesNoNo
Applies station-specific brandingYesRarelyNoSometimes
Produces broadcast-ready audioYesNoSometimesYes
Supports fair rotation and midnight resetYesNoNoNo
Caches output for playout softwareYesNoSometimesSometimes
Uses modern auth for admin accessYesSometimesSometimesSometimes
Normalizes loudness to broadcast standardsYesNoNoSometimes

That split is the point. The management layer is modern, but the consumption layer respects the reality of radio automation: legacy software wants stable files, predictable URLs, and minimal surprises.

What makes Babbel different from adjacent tools

A CMS manages content. A TTS service speaks text. A media renderer transforms files. Babbel sits across all three layers, but only where radio needs them to meet: story choice, station identity, and playout reliability.

Tool categoryPrimary jobWhat it missesBabbel's advantage
CMSStore and organize storiesDoes not produce broadcast audioKnows how to choose and render a bulletin
TTS serviceGenerate speechDoes not manage station logic or deliveryKeeps the station-specific pipeline intact
Media rendererMix and export audioDoes not decide what should playWraps editorial rules around the render step
Playout helperServe files to automationDoes not solve content or brandingCombines caching, selection, and audio standards

That combination makes the project feel less like a media toy and more like a vertical utility. It is opinionated in exactly the places radio operators care about.

The operational edge

The boring parts are where unattended systems live or die. Babbel has schedulers for story expiration and bulletin cleanup, which matters because audio files are large and stale cache files are a very real failure mode in broadcast automation.

This is the kind of plumbing that never gets applause until it fails. Then it becomes the whole story.

What this project hints at next

The ElevenLabs integration points toward a familiar next step: more synthetic voices, less human recording, and a stronger separation between editorial input and voiced output. The architecture is already prepared for that future because the bulletin is treated as a render target, not a live performance.

That does not mean radio becomes generic. It means the station’s identity moves further upstream, into the rules that choose stories and the audio logic that shapes the final bulletin.