Koji Stream Player

Console audio stream player for Windows and macOS.

Usage

Run the executable, pick a station or enter a custom URL.

During playback:

Key	Action
+	Volume up (+5%)
-	Volume down (-5%)
p	Pause / Resume
s	Station menu
q	Quit

Or pass a URL directly:

./koji-stream-player http://ice1.somafm.com/spacestation-128-mp3

Custom Stations

Edit stations.txt next to the executable. One station per line, Name|URL format:

Bassdrive (DnB)|http://ice.bassdrive.net:80/stream32
SomaFM DEF CON|http://ice1.somafm.com/defcon-128-mp3
# Lines starting with # are ignored

Use http:// for streams that support ICY metadata (track titles). https:// works for playback but metadata may not be available.

macOS Note

Apple Silicon only. Unsigned binary — allow in Privacy & Security, and:

chmod +x ./koji-stream-player

Supported Streams

Optimized for internet radio (Icecast/Shoutcast). Supported audio formats:

• MP3 (most internet radio stations)
• AAC / HE-AAC (e.g. Bassdrive)

The bundled VLC is stripped down to audio streaming essentials — no video, no local file playback.

Dependencies

libVLC + LibVLCSharp (LGPL).

License

Unlicense