Headless MQTT Audio Player

./audio-player config    # Configure sound device (creates config.yaml)
./audio-player           # Run with config.yaml (or use -c custom.yaml)

# Control via MQTT
mosquitto_pub -t "/player/audio_url" -m "http://example.com/sound.wav"
mosquitto_pub -t "/player/cmd/player" -m "start"

📡

MQTT Control

Full remote control via MQTT — ideal for embedded systems and installations where no GUI is possible. Integrates with Node-RED, Home Assistant, or any MQTT client.

🔊

Multi-Channel Routing

Route audio to any combination of output channels (2, 4, 8, 16+). Live-switchable — change routing mid-playback without interruption.

🌐

Remote File Loading

Load audio directly from HTTP/HTTPS URLs. Hot-swap — new file downloads in background while current audio continues playing.

🔁

Repeat Mode

Play N times (1–10) with configurable intervals (0–30s). Sticky — repeat settings persist across file changes. Ideal for alerts and announcements.

📊

Reactive Audio Level

Real-time RMS level published via MQTT for reactive visuals, LED control, or monitoring. Configurable frequency. Disable in config if not needed.

🖥️

Multi-Instance

Run multiple independent players on the same machine. Each can use the same device (different channels) or separate devices.

See the full technical specs Control · Audio · File Loading · Playback · Deployment — 17 features detailed ▶

Control
Protocol	MQTT-based API — full remote control, seamless integration with embedded systems, Node-RED, Home Assistant
Status Publishing	Player state, position, volume, loop/repeat status, audio level — all published in real-time
Health Heartbeat	Configurable heartbeat for monitoring player health in production
Audio Output
Channel Routing	Live-switchable — route to any channels (2, 4, 8, 16+), change mid-playback without interruption
Audio Level	Real-time RMS for reactive visuals/LEDs. Configurable update rate. Can be disabled via config.
Volume	0–200% range, real-time control via MQTT
File Loading
Remote URLs	HTTP/HTTPS — load audio directly from web, no pre-staging needed
Local Paths	Absolute file paths also supported
Hot-Swap	Background download — current audio continues while new file loads
Auto-Start	Configurable: auto-play on new file, or wait for explicit command
Playback
Loop	Continuous playback until stopped
Repeat	Play N times (1–10) with intervals (0–30s). Sticky across file changes.
Seek	Jump to any position (MM:SS or seconds)
Pause / Resume	Full transport control. New file with auto-start resumes immediately.
Deployment
Platforms	macOS, Linux, Windows (Intel, AMD, Apple Silicon)
Multi-Instance	Multiple players per machine, same or different audio devices

$25

Pay what you want (min $5)

One-time payment · Lifetime updates · Email support

Buy License

View Source

If you find this useful, consider supporting its development:

Buy Me a Coffee

▸ What's included?

License key, all current features, lifetime updates, and bug fix support via email.

▸ Can I try before buying?

Yes. The software runs without a license but shows a reminder and startup delay. Full source is available on GitHub.

▸ How many devices?

Each license can be activated on up to 2 machines. First activation requires a one-time internet connection; after that, it works fully offline.

▸ Refunds?

Since you can evaluate before purchase, refunds are not offered. Please test thoroughly first.

▸ How do I get my license key?

After purchase, you'll receive your key via email instantly (check spam folder if not received within a few minutes).