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

Console-based audio stream player for Windows and macOS
https://github.com/maxgripe/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: 6 months ago
JSON representation

Console-based audio stream player for Windows and macOS

• Host: GitHub
• URL: https://github.com/maxgripe/koji-stream-player
• Owner: MaxGripe
• License: unlicense
• Created: 2024-10-05T23:22:52.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2025-01-29T10:18:58.000Z (9 months ago)
• Last Synced: 2025-03-24T03:34:49.177Z (7 months 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: 64.8 MB
• Stars: 3
• 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/MaxGripe/koji-stream-player/actions/workflows/dotnet.yml/badge.svg)

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

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

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

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

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

![OS](https://img.shields.io/badge/os-Windows_%7C_macOS-blue)

# Koji Stream Player

![Koji](gfx/koji.png)

A simple console-based program to play audio streams for Windows and macOS

## Getting started

Run the executable and provide the URL of the stream you want to play, for example:

`https://ice1.somafm.com/spacestation-128-mp3`

or

`http://ice.bassdrive.net:80/stream32`

That's it!

## Features

- Easy to use

- Volume control

- Console-based

![Koji on Windows](gfx/terminal.png)

![Koji on macOS](gfx/zsh.png)

## Additional info for Mac users:

Koji only works on Apple Silicon processors and has been tested on an M1 running 

macOS Sequoia 15.2. Since I don't want to pay the ransom to greedy Apple for the 

"Apple Developer Program", if you want to run it after downloading, you'll 

unfortunately need to manually allow it in "Privacy & Security" 

(your Mac will insist on deleting :)

Please also make sure to mark it as executable:

`chmod +x ./koji-stream-player`

![Gatekeeper](gfx/gatekeeper.png)

## Support

If possible, please support the radio station you are listening to! :)

### MEGA IMPORTANT LICENSE INFORMATION (for people who care about this kind of nonsense)

This software uses some fancy third-party stuff like:

"libVLC" and "LibVLCSharp", both under LGPL-something.

Want to know more about their licenses? Go read their sites, it's all there.

These licenses are their thing, not mine.

This software is proudly released under the [Unlicense](LICENSE). You're welcome.