No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Satya Benson c82c516bae Add README and MIT license
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-05 15:32:21 -04:00
.gitignore initial commit 2024-11-17 22:48:54 +00:00
gemradio.go initial commit 2024-11-17 22:48:54 +00:00
go.mod initial commit 2024-11-17 22:48:54 +00:00
go.sum initial commit 2024-11-17 22:48:54 +00:00
LICENSE Add README and MIT license 2026-10-05 15:32:21 -04:00
README.md Add README and MIT license 2026-10-05 15:32:21 -04:00

gemradio

A "radio" server for the Gemini protocol. It finds every .mp3 file under a directory and plays them in order, on a loop, as one continuous stream. Every client that requests / gets an audio/mpeg response joined to the stream at its current position, like tuning in to a radio station.

Configuration

~/.config/gemradio/config.yaml:

cert_path: /path/to/certs   # TLS certificate directory (go-gemini certificate store)
audio_dir: /path/to/music   # searched recursively for .mp3 files
host: localhost             # hostname the certificate is for, and listen address
port: "1965"

Build and run

Needs Go.

go build
./gemradio

Then open gemini://<host>:<port>/ in a Gemini client that can play audio, or pipe the response into a media player.

License

MIT. See LICENSE.