Mofusand Synth

🐱 Paste a YouTube link, get 8-bit chiptune. A cute Tauri desktop app that converts songs into retro game music — either by crushing the audio or by transcribing the actual notes and replaying them on chiptune oscillators.

---

✨ Features

• Two conversion modes
  • 🎛 DSP Crush — degrades the original recording in real time with a bitcrusher, lowpass filter, and sample-rate reducer. Tweak Bit Depth, Sample Rate, and Wave Crush live.
  • 🎮 True Chiptune — uses Spotify's basic-pitch ML model to detect the notes in the song, then replays them on square / triangle / pulse / sawtooth oscillators. An actual 8-bit cover, not just lo-fi.
• 🎤 Vocal removal — center-channel cancellation for an instrumental mix
• 🌊 Live oscilloscope — watch the waveforms dance as they play
• 💾 WAV export — save your creation via a native file dialog
• 🎀 Mofusand-themed UI — powder-blue hearts, cream card, gold filigree, cat ears

🛠 Tech Stack

Desktop shell	Tauri 2 (Rust)
Frontend	SvelteKit + Svelte 5 (runes)
Audio	Web Audio API (WaveShaper, AudioWorklet, OfflineAudioContext, OscillatorNode)
Note transcription	@spotify/basic-pitch + TensorFlow.js
YouTube download	yt-dlp

📦 Prerequisites

• Rust + Cargo
• Node.js 18+
• yt-dlp on your PATH (winget install yt-dlp.yt-dlp)
• ffmpeg on your PATH (yt-dlp uses it to extract audio)

🚀 Development

npm install
npm run tauri dev

🏗 Build a desktop installer

npm run tauri build

Installers land in src-tauri/target/release/bundle/ (.msi / .exe on Windows).

Note: the built app calls yt-dlp and ffmpeg from the system PATH. To distribute to machines that don't have them, bundle them as Tauri sidecar binaries.

🧠 How it works

YouTube URL → Rust (yt-dlp) → audio bytes → Web Audio API
   DSP mode:      bitcrusher → lowpass → downsampler → speakers
   Chiptune mode: basic-pitch → notes → oscillator synthesis → speakers
→ OfflineAudioContext render → WAV export

See docs/ARCHITECTURE.md for the full breakdown.

⚠️ Disclaimer

This is a personal, non-commercial hobby project made for fun and learning.

• Mofusand characters and artwork are the property of their creator (©mofusand). The icon is fan-use only; this project is not affiliated with, endorsed by, or sponsored by the Mofusand brand. If you fork or redistribute this, please replace the icon with your own art.
• Downloading content from YouTube may conflict with YouTube's Terms of Service and copyright law. Use this tool only with content you have the right to download, and keep outputs to personal use.

📄 License

No license yet — all rights reserved by default. Add one (e.g. MIT) if you intend to open-source it.