‧₊˚♪ 𝄞₊˚⊹ ࣪ ˖     𝐜𝐚𝐬𝐭𝐚𝐰𝐚𝐲     .✦ ݁˖ ‧₊˚♪ 𝄞₊˚⊹

A way to create radio station for your local network & listen across devices.

requirements

• python >= 3.12
• aiohttp
• ffmpeg

setup

• Install dependencies:

  uv venv && source .venv && uv sync
  
  # use your os/distro's package manager to install ffmpeg
  sudo pacman -Sy ffmpeg

• Config:

  vi main.py # edit MUSIC_DIR

• Run the program:

  python main.py

  Now you can go use any media player like VLC or mpv to listen to the stream:

  mpv http://your-ip-here:6769/stream

why

i have been slowly converting my arch linux setup to something of a home server & thought it'd be cool to have a music service running on it. wait, i already use mpd+ncmpcpp lets use it as a cool 24/7 radio! little did i know even though you can expose it to lan but audio output can be very different for different devices (my work macbook doesn't use pipewire ofc) and i couldn't find any answers that worked for me.

hence this little script to use python+ffmpeg to create an audio stream over http that any client can use.