The Night Arc Interactive Terminal Studio Core Features Playlist Modes Quickstart Guide ★ View on GitHub

THE NIGHT,
ORCHESTRATED.

Never worry about what track plays next. Waveform pairs your favorite AI model (Gemini, OpenAI GPT-4o, Claude 3.7, Groq, or 100% offline with local Ollama) directly with Spotify to curate a continuous 5-chapter soundtrack with zero duplicates, calibrated energy arcs, and parametric cover art.

Launch Studio Demo Get Waveform (Free) Explore Arc ↓
◈ Powered by Spotify API
◈ Gemini · OpenAI · Claude · Groq · Ollama
◈ Zero-Repeat History Engine
◈ Runs 100% Locally on Your Machine
Curated Playlist
160 Tracks · 9.4 Hrs
Sarah's 30th Birthday
Peak Send
00:00 — 02:00 · Chapter 3
128 BPM · Dance Energy
Levitating
Dua Lipa
1:56 / 3:23
CHAPTER PLAYBOOK

One Prompt.
The Full Emotional Arc.

Waveform divides your night into five calibrated chapters. Tap each block to inspect its sonic signature, genre weighting, and parametric Spotify cover art.

WAVEFORM // ARC 20:00 - 22:00
CHAPTER 01
Wine & Chill
Powered by Spotify
32 Tracks
LLM SEED PROMPT (ANY MODEL):

"Warm, inviting, rhythmic baseline. Focus on soul, neo-soul, and mellow grooves as arrivals unpack coats."

20:00 — 22:00 · PHASE 1

Wine & Chill

Setting the frequency. Warm, magnetic, unhurried grooves that allow guests to mingle, talk, and get comfortable without shouting.

Energy Level 42% (Mellow Arrival)
Tempo Range 90 — 108 BPM Neo-Soul 45% · Lo-Fi 30% · Indie 25%
CURATED SAMPLES (NO REPEATS)
MULTI-PROVIDER AI COMPILATION

Test the Studio.
Watch Any Model Build the Arc.

Choose your AI provider — Google Gemini, OpenAI, Anthropic Claude, Groq, or Local Offline Ollama — and watch Waveform authenticate with Spotify to curate the night in real time.

waveform-cli — gemini-2.5-flash
● POWERED BY SPOTIFY
$ waveform --event="Sarah's 30th" --provider=gemini --model=gemini-2.5-flash
✓ Spotify OAuth handshake verified (Powered by Spotify Web API)
◈ Loaded master_prompt.md (5 chapters, rules: 'no-breakup-songs')
… Standby. Click 'Generate Playlist' to trigger multi-model AI compilation & Spotify delivery.
Ready for stream
● POWERED BY SPOTIFY · DEDUP ACTIVE
ARCHITECTURE SPEC

Engineered Emotion.
Flawless Soundtracks.

Every feature in Waveform exists to serve the room on the night of the event. Filter by capability:

Multi-Model AI Curation

Zero hardcoded song catalogs. Bring your preferred AI: Gemini 2.5, OpenAI GPT-4o, Claude 3.7, Groq, OpenRouter, or 100% offline local Ollama.

GEMINI · OPENAI · CLAUDE · OLLAMA

Strict No-Repeat Engine

Waveform tracks historical generations per event in local storage. Regenerate as many times as you like without duplicates.

HISTORICAL DEDUPLICATION

Parametric Cover Artwork

Each chapter block receives high-resolution gradient artwork matched to its palette, directly uploaded to Spotify via the Web API.

POWERED BY SPOTIFY WEB API

Block-Preserving Shuffle

Tracks shuffle within each vibe block to prevent artist clumping, while strictly preserving the overarching 20:00-to-sunrise energy flow.

ARC INTEGRITY PRESERVED

Hard Artist Blocklist

Drop hated artists into blocked_artists.txt. Waveform applies a hard client-side veto that strips them unconditionally.

ABSOLUTE HARD VETO

Reference Playlist Taste Profiler

Paste any Spotify playlist link. Waveform extracts track audio features and genre distributions via Spotify, feeding your chosen LLM to calibrate the room.

SPOTIFY AUDIO FEATURES · TASTE CALIBRATION

Runs 100% Locally

Runs directly on your computer with direct Spotify sign-in. Your music tastes stay private on your device with no third-party accounts, cloud tracking, or subscriptions.

RUNS LOCALLY · COMPLETE PRIVACY

Live Prompt Injection

Quickly inject on-the-fly vibe rules without editing files: "more 90s French Touch", "no reggaeton after 2 AM", "extra high tempo".

INSTANT TWEAKS

Collision & Overwrite Guard

Never destroys an existing playlist. If a playlist name conflicts, Waveform asks whether to overwrite, append, or create a dated copy.

SAFETY FIRST
PLAYLIST ARCHITECTURE

Three Output Modes.
Total Control.

Choose how Waveform delivers your soundtrack to Spotify on party night:

Full Night

One continuous playlist containing every block in sequential chronological order. Press play at 8 PM and let the evening unfold without intervention.

BEST FOR: Set-and-forget hosting
POPULAR

Split Night

Five distinct Spotify playlists corresponding to each vibe chapter. Perfect for hosts who want separate playlists for each part of the night with dedicated cover artwork.

BEST FOR: Targeted chapter control

Both (Full + Split)

Creates the mega-playlist AND the 5 dedicated split playlists simultaneously in a single AI run. Powered by Spotify Web API for instant library availability.

BEST FOR: Maximum party insurance
QUICK SETUP

Clone. Key.
Party in 5 Minutes.

Runs in the browser. Nothing to install. Free Spotify Developer credentials, and your key for Gemini, OpenAI, Claude, Groq, OpenRouter, or free local Ollama.

01

Open the app

No install, no account. Waveform is a static web app — everything runs in your browser and nothing is uploaded.

02

Provide Credentials

Paste your Spotify Client ID and one AI provider key into Settings. Sign-in uses PKCE, so there is no client secret — and local Ollama needs no key at all.

03

Run the Orchestrator

Pick a blueprint, shape the night, and watch your curated playlists land in Spotify with cover art for every chapter.

bash — run it locally 
# Use the hosted app, or run your own copy:

# 1. Clone repository
git clone https://github.com/thepixelabs/waveform.git
cd waveform

# 2. Install and start
npm install
npm run dev

# 3. Open Settings in the app and paste:
#    - your Spotify Client ID (no secret needed - PKCE)
#    - a key for gemini / openai / claude / groq /
#      openrouter, or point it at local Ollama
Try Studio The Arc GitHub