Recipes

Task-oriented guides and runnable examples for common AudioDN jobs. Each one shows the whole path — auth, upload, processing readiness, and playback or delivery — with correct security boundaries, so you (or an AI coding agent) can adapt it into a working app.

Built on the canonical flow

Every recipe follows the same upload lifecycle: create an upload session on your server, create a per-track upload URL (no API key — the session ID authorizes it), PUT the bytes, wait until the track is ready, then play or deliver. See the upload lifecycle for the full breakdown.

Building with an AI coding agent? Run npx @audiodn/agent-kit init to install AudioDN guidance (AGENTS.md, CLAUDE.md, Copilot, Cursor, and a portable Skill) and npx @audiodn/agent-kit validate . to catch common integration mistakes before you ship. See @audiodn/agent-kit on npm.

Guides

Step-by-step recipes with complete, copy-pasteable code.

Private Podcast

Entitlement-gated audio

Serve a subscriber-only podcast: a collection as the feed, per-listener play sessions (or signed enclosure URLs) so only paying subscribers can stream.

Stack: Any server + RSS
Covers: Play sessions, signed delivery, collections

Read recipe →

Preview & Waveform

Processing + visualization

Offer a short public preview and a waveform visualization while gating the full track. Uses variants and the <audiodn-waveform> component.

Stack: Any frontend
Covers: Variants, readiness, waveform component

Read recipe →

Vue Secure Upload

Vue / Nuxt

The secure upload flow in a Vue app: a server route mints the upload session, the browser creates a per-track URL and uploads bytes, then polls until ready.

Stack: Vue 3 / Nuxt + server route
Covers: Upload session, per-track, PUT, readiness

Read recipe →

Runnable examples

Complete, standalone projects in the AudioDN repository. Each ships a README.md and an AGENTS.md so coding agents can run, adapt, and deploy them.

Next.js Secure Upload

Runnable app

A complete Next.js project: an API route mints an upload session with a server-only key, the browser creates the per-track URL (no key), uploads bytes, polls for readiness, and plays back with the AudioDN player.

Source: examples/nextjs-secure-upload
Covers: Full upload lifecycle + playback

Cloudflare Worker Signed Playback

Runnable Worker

A Cloudflare Worker that signs delivery URLs with an HMAC URL Signing key kept in Worker secrets, then returns a ready-to-play URL for a native <audio> element. Deploys with wrangler.

Source: examples/cloudflare-worker-signed-playback
Covers: URL signing, edge delivery

Coming next

Recipes on the roadmap. Want one prioritized? Email [email protected].

Music marketplace (multi-seller catalog, purchases, downloads)
Multi-tenant audio application (per-tenant creators, collections, keys)
Paid audio downloads (downloadable play sessions + entitlements)
Migrating from S3 + FFmpeg (import pipeline and variant mapping)
User-generated voice recordings (record in the browser, upload, moderate)