What is it?

This project is a CLI appliction what subscribes to MQTT topic and plays sounds from files stored on disk

At now, application supports .wav and .mp3 file formats

Usage

1. Place your sound files into sfx/ directory
2. Start application
3. Send filename to mqtt2play/play topic as text
4. Enjoy

Contributing

This project is written in Golang. If you want to contribute code:

1. Ensure you are running golang version 1.16 or greater for go module support
2. Check-out the project: git clone https://github.com/iamtio/mqtt2play && cd mqtt2play
3. Make sure libasound2-dev installed on your system (Debian, Ubuntu)
4. Make changes to the code
5. Build the project, e.g. via go build ./cmd/mqtt2play-server
6. Evaluate and test your changes MQTT2PLAY_BROKERS=localhost:1883; ./mqtt2play-server
7. Make a pull request