https://github.com/mg0x7be/koji-stream-player

Console-based audio stream player for Windows and macOS
https://github.com/mg0x7be/koji-stream-player

audio audio-player audio-streaming console-application dotnet fsharp libvlc libvlcsharp mac macos macos-app macos-application music-player stream-playback stream-player streaming-audio vlc vlc-media-player vlcsharp windows-console

Last synced: 8 days ago
JSON representation

Console-based audio stream player for Windows and macOS

• Host: GitHub
• URL: https://github.com/mg0x7be/koji-stream-player
• Owner: mg0x7BE
• License: unlicense
• Created: 2024-10-05T23:22:52.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2026-04-10T22:20:12.000Z (16 days ago)
• Last Synced: 2026-04-11T00:19:55.185Z (16 days ago)
• Topics: audio, audio-player, audio-streaming, console-application, dotnet, fsharp, libvlc, libvlcsharp, mac, macos, macos-app, macos-application, music-player, stream-playback, stream-player, streaming-audio, vlc, vlc-media-player, vlcsharp, windows-console
• Language: F#
• Homepage:
• Size: 65.8 MB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

![Workflow Status](https://github.com/mg0x7BE/koji-stream-player/actions/workflows/dotnet.yml/badge.svg)

![GitHub repo size](https://img.shields.io/github/repo-size/mg0x7BE/koji-stream-player)

![GitHub License](https://img.shields.io/github/license/mg0x7BE/koji-stream-player)

![GitHub Created At](https://img.shields.io/github/created-at/mg0x7BE/koji-stream-player)

![GitHub forks](https://img.shields.io/github/forks/mg0x7BE/koji-stream-player)

![GitHub Repo stars](https://img.shields.io/github/stars/mg0x7BE/koji-stream-player)\

![Windows](https://img.shields.io/badge/Windows-0078D6?logo=windows&logoColor=white)

![macOS](https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=white)

# Koji Stream Player

Console audio stream player for Windows and macOS.

![Koji](gfx/koji-player.png)

## 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](LICENSE)

![Koji](gfx/koji-logo.png)