b1rdmania
f69a022afd
Removed: - Old planning docs (DEPLOYMENT.md, IMPLEMENTATION.md, etc.) - Dev notes (thursday-aims-progress-problems.md) - Old backup files (main-simple.ts, main-working.ts) - Test file (test.html) - Unused image (chiptune_blog_piece_1000x.webp) - docs/ folder with old audit/plan docs Updated: - Renamed claude.md to CLAUDE.md - Added .claude/ to gitignore 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
WARIO SYNTH
Turn any song into retro Game Boy music using the Wario Synthesis Engine.
Live Demo
wariosynthengine.com (or motif-self.vercel.app)
About
WARIO SYNTH is a fun experiment in music-as-code: it treats MIDI as structural data, not audio. Search for any song, pick a MIDI source, and the Wario Synthesis Engine analyses the MIDI structure and resynthesises it using Web Audio oscillators tuned to mimic the Game Boy's 4-channel sound chip.
- Two pulse wave channels for melody and harmony
- One wave channel for bass
- One noise channel for percussion
All processing runs client-side in your browser - no server-side audio generation.
Features
- MIDI search from BitMidi and other sources
- Browser playback with soundfont piano preview
- Wario Synthesis Engine: procedural Game Boy-style synthesis from parsed MIDI structure
- Share links with dynamic social previews
- Works on mobile (iOS audio unlock included)
Quick Start (Local)
# Install frontend deps
npm install
# Install backend deps
cd server && npm install && cd ..
# Run backend (http://localhost:3001)
npm run dev:backend
# Run frontend (Vite prints the URL, typically http://localhost:5173)
npm run dev
How It Works
- User searches for a song
- Backend searches MIDI sources and returns ranked candidates
- User picks a MIDI source
- Frontend parses MIDI into normalized note events
- Wario Synthesis Engine maps tracks to Game Boy sound channels
- Web Audio oscillators generate the retro sound
Embed Widget
WARIO SYNTH includes an embeddable widget at /embed:
<iframe
src="https://wariosynthengine.com/embed?song=Hotel%20California"
width="420"
height="260"
style="border:0;border-radius:12px;overflow:hidden"
allow="autoplay"
></iframe>
Tech Stack
- Frontend: TypeScript, Vite, Web Audio API
- Backend: Express, Node.js
- Deployment: Vercel
- Built with: Claude Code
Credits
A non-commercial project by @b1rdmania for lols. Please don't sue me.
