vadeo

README

Radio + Video = Vadeo

People like video streams, but that doesn't mean your internet radio station has to be ignored. Stream your shoutcast-compatible internet radio station as a live video stream and reach a whole new audience.

Live example stream from The Bat Station.

What it does

It will use your internet radio station to create a live video stream broadcast via RTMP to any live streaming platform such as Owncast. It will generate a 720p video stream with the now playing metadata (as provided by your radio stream), your logo, a background video loop, and an audio visualizer.

What you need

1. An internet radio station that is Shoutcast/Icecast compatible.
2. A logo to display.
3. A background video you want to loop.
4. ffmpeg to be installed on your system.

Install

1. Visit the releases page to download a version for your platform.
2. tar xvf vadeo_vx.x.x-version.tar.gz
3. ./vadeo

Setup

1. Copy your logo to logo.png. Resize it and add transparency as needed.
2. Copy your background video to background.mp4.

Edit config.yaml.

1. Copy config.example to config.yaml.
2. Find the audio stream URL to your internet radio station. Not the web page url, the actual audio stream. Set it in the config as audioUrl.
3. Put the RTMP video streaming endpoint as streamingURL and your stream key as streamingKey.
4. Edit video quality, framerate and audio bitrate. You likely want to match the audio bitrate to whatever your internet radio station is.

Testing

If you just want to try it out with your station, Owncast provides a free testing server you can use to try out Vadeo. Visit https://broadcast.owncast.online to get the stream key and you can point Vadeo at it to see it in action. After testing you can install your own server and expose your station to more people.

Optional Owncast support

If you are using Vadeo with Owncast you can take advantage of the feature of your track metadata populating the Owncast web interface.

1. Make sure your Owncast server is v0.0.6 or higher.
2. In the Owncast admin go to the Integrations/Access Tokens screen.
3. Create a new access token with system chat message access.
4. Edit your Vadeo configure file and paste in your Owncast and access token as owncastAccessToken.

Visit Owncast's Documentation for additional information.

Notes

• This operates as a live stream just like if you were streaming from OBS, Streamlabs, vMix, etc. It will require enough hardware to generate this video and enough bandwidth to stream it to your live streaming provider. If your machine or internet connection can't handle streaming via other methods, it's unlikely you'll be able to stream with this one.

• You may want to run utility on a machine separate from your actual streaming server as you may run into hardware utilization limits with two video processing applications running at once. But you can run it anywhere, including a machine on your personal home internet.

• If you would like to stream to multiple livestreaming destinations at once, take a look at Prism.

• Disclaimer: This is a utility for convenience, experimenting and entertainment. It was thrown together quickly and is likely not production-grade. Improvements are welcomed, but feature requests are not likely to be implemented.

Included assets

• Polentical Neon font (Creative Commons (CC-BY-SA 3.0) ) included. It has limited characters, so if you require more unicode or international characters you should replace this font with one of your own and specify it in the config file.