Mcaster1AMP
AI-powered desktop media player for internet radio. Dual-deck playback, 4 AI backends, full DSP chain, broadcast tools, and one-click streaming from the CasterClub YP Directory.
Download Mcaster1AMPPlayback Engine
Professional A/B deck architecture with lock-free audio pipeline, multi-codec support, and deep ICY 2.2 integration.
A/B Deck with Crossfader
Dual independent playback decks with real-time crossfading. Ships with the MC1 Crossfader plugin offering 9 blend curves for seamless transitions between streams.
Lock-Free SPSC Ring Buffer
Single-producer single-consumer ring buffer feeds the PortAudio callback with zero allocations in the audio path. Glitch-free playback even under heavy system load.
Multi-Codec Decoder
Native decoding for every internet radio format:
- MP3 (MPEG-1/2 Layer III)
- AAC / AAC+ / HE-AAC v1 & v2
- OGG Vorbis & Opus
- FLAC (lossless)
- WAV / PCM
ICY 2.2 with TLS
Full ICY metadata protocol support including TLS/HTTPS streams. Resolves m3u, pls, xspf, and m3u8 playlists automatically before connecting.
mc1amp:// Protocol
Registers the custom mc1amp:// URL scheme on your system. Web pages launch streams directly into the player — one click from the CasterClub directory to live audio.
Mcaster1StreamProxy Integration
Native integration with Mcaster1StreamProxy for HTTPS relay of HTTP-only streams. Eliminates mixed-content browser blocks and provides connection coalescing.
AI-Powered Intelligence
Four AI backends, 21 persona presets, real-time song analysis, and deep artist research — all built into the player.
4 AI Backends
Connect to the AI engine of your choice:
- Ollama — local/private LLM
- Claude — Anthropic API
- OpenAI — GPT models
- Azure OpenAI — enterprise
21 Persona Presets
5 DJ personas plus 16 genre-specific personalities. Each shapes how the AI describes tracks, artists, and station programming — from jazz connoisseur to metal headbanger.
AI Song Ticker
4-section scrolling ticker driven by AI analysis. Displays real-time context about the currently playing track — genre history, artist trivia, mood analysis, and musical connections.
Track Intel Panel
Deep-dive panel for the current track. AI generates context about the song, its place in the artist's catalog, production notes, and similar recommendations in real time.
Artist Intel Report Generator
7 dedicated research buttons generate comprehensive artist intelligence reports. 5 HTML report themes available. Reports can be saved to SQLite for offline reference.
Save-to-SQLite
All AI-generated reports, track analyses, and artist research persist in a local SQLite database. Build a personal music knowledge base that grows with your listening.
DSP Processing Chain
Studio-grade audio processing running inline in the PortAudio callback — zero allocations, zero latency additions.
10-Band Parametric EQ
Fully adjustable center frequency, bandwidth (Q), and gain per band. Precision tone shaping for any monitoring environment or personal preference.
31-Band Graphic EQ
ISO standard 1/3 octave graphic equalizer. Quick visual tone adjustment from 20 Hz to 20 kHz with preset management.
AGC with Look-Ahead
Automatic Gain Control with look-ahead buffer. Normalizes stream volume across stations so switching channels does not blast or whisper.
Sonic Enhancer
3-band Linkwitz-Riley crossover feeding independent low, mid, and high enhancers. Adds presence, warmth, and air without distortion.
Spectrum Analyzer
FFT-based real-time spectrum visualization running on a dedicated worker thread. Lock-free double buffer feeds the UI at 60 fps without impacting the audio path.
Zero-Alloc Audio Path
The entire DSP chain executes inline in the PortAudio callback. No heap allocations, no locks, no system calls in the hot path — guaranteed glitch-free processing.
Broadcast Tools
Everything a broadcaster needs built right into the player — cart wall, scheduling, clocks, and metadata export.
Cart Wall
Instant-fire audio cart system. Load jingles, stingers, drops, and sound effects for one-touch playback during live broadcasts.
Event Scheduler
Schedule stream switches, playlist changes, and automation events. Time-based triggers keep your broadcast running on schedule.
Broadcast Clock
Dual 24-hour and 12-hour clock display with ON-AIR / OFF-AIR indicator. Visual confirmation of broadcast state at a glance.
Metadata Export
Export now-playing metadata in 6 formats:
- TXT & LOG (plain text)
- M3U & PLS (playlists)
- XSPF & M3U8 (extended)
Media Library & AutoDJ
SQLite-powered library with full-text search, intelligent auto-rotation, and deep metadata integration.
SQLite FTS5 Search
Full-text search engine indexes every tag field. Find any track instantly across artist, title, album, genre, comment, and custom fields.
TagLib Scanner
Scans local media with TagLib for complete metadata extraction. Extracts album art, reads ID3v2/Vorbis comments/MP4 atoms, and populates the library database.
Color-Coded Categories
Assign color categories to tracks for visual organization. Column display persists across sessions with drag-to-reorder and resize.
AutoDJ Engine
Intelligent automatic playback with:
- Weighted rotation scheduling
- Artist separation rules
- BPM flow matching
- Genre rotation mixing
- Vote up/down listener feedback
Video Player & Plugin SDK
Built-in video playback and an extensible plugin architecture for custom processing.
Video Player
Qt6 Multimedia-powered video engine with intelligent URL resolution:
- HTTP / HTTPS direct streams
- HLS (m3u8) adaptive
- YouTube via yt-dlp integration
- RTMP live feeds
Features TV Color dialog, fullscreen mode, and pop-out window for multi-monitor setups.
Plugin SDK v2
Stable C ABI for third-party audio processing plugins:
- Parameter API with type-safe accessors
- Custom Qt UI integration
- Hot-reload during playback
- Ships with MC1 Crossfader (9 blend curves)
Supported Formats
● Audio ● Video ● Playlist/Meta
Architecture
WorkerPool with 7 dedicated threads, lock-free data paths, and code-signed binaries.
Code-signed binaries — RSA 4096 SHA-256 with DigiCert timestamp. Windows SmartScreen trusts the installer without warnings. Fully portable: no registry writes, no AppData pollution — runs from any directory.
Mcaster1 Ecosystem
How Mcaster1AMP fits into the full broadcast pipeline from player to listener.
The mc1amp:// Protocol
Custom URL scheme that connects web directories to native desktop playback.
How It Works
When Mcaster1AMP is installed, it registers the mc1amp:// protocol handler with the operating system.
Clicking an mc1amp:// link on any web page (the CasterClub YP Directory, a station website, or an embedded player)
causes the OS to launch Mcaster1AMP and pass the stream URL as an argument. The player connects, resolves playlists if needed,
and begins playback instantly — no browser audio, no mixed-content warnings, no codec limitations.
mc1amp://play?url=http://radio.example.org/stream.mp3&name=My+Station
mc1amp://play?proxy_id=1294 // uses CasterClub StreamProxy
The protocol also supports a proxy_id parameter which routes through the Mcaster1StreamProxy HTTPS relay,
converting any HTTP stream to a secure TLS connection. Web pages detect protocol availability using an iframe probe with
a 2.5-second timeout — if the handler is not installed, a download modal appears.
Roadmap
| Version | Feature | Status |
|---|---|---|
| 1.0 | Core playback engine, A/B decks, multi-codec, ICY 2.2, DSP chain | Done |
| 1.1 | AI integration (4 backends, 21 personas, Song Ticker, Artist Intel) | Done |
| 1.1.3 | Plugin SDK v2, MC1 Crossfader, Cart Wall, Event Scheduler, Broadcast Clock | Current |
| 1.2 | Media Library FTS5, AutoDJ engine, album art extraction, TagLib scanner | In Progress |
| 1.3 | Video player (Qt6, HLS, YouTube/yt-dlp, RTMP), TV Color dialog, pop-out | Planned |
| 1.4 | CasterClub account sync, cloud presets, remote control API | Planned |
| 2.0 | Linux & macOS builds, native Wayland/Cocoa, ARM64 support | Planned |