24/7 live stream video radio station CLI / API πŸ“Ή πŸ“»
Clone or download

README.md

live-stream-radio

formerly known as piStreamRadio.

Buy Me A Coffee

Galaxy Noise Radio Live Stream link

CLI Usage Screenshot πŸ–ΌοΈ

Documentation πŸ“š

live-stream-radio is a 24/7 live stream video radio station πŸ“Ή πŸ“» CLI built with Node.js and powered by FFmpeg. Meaning, This will allow for live streaming a video of music, playing over a video/gif, with the music information, and other overlay items πŸ–ΌοΈ. Music and video are chosen from their respective folders in a defined config.json that can be generated using the CLI. Generated projects come included with some songs and videos to get up and running quickly! Also, this project has a REST HTTP JSON Api, to allow for interfacing with your stream using a frontend πŸ‘©β€πŸ’».

Table of Contents

Getting Started

Please see the Documentation πŸ“š for how to get started using live-stream-radio. In particular, the Instllation Guide and CLI Usage will be the most useful to new users. πŸ˜„

API Frontends

For building your own API frontend, please see the API Documentation πŸ“š on API Endpoints.

Currently, there are no supported API frontends. However, Contributions are welcome! If you make a live-stream-radio frontend, please open an issue and so we can add the project here πŸ˜„!

Other Notable Projects

  • lsr-wrapper - A Promise based wrapper around the live-stream-radio api.

Radios built with live-stream-radio

Please feel free to share your radio if you are using live-stream-radio. Just open an issue, and we can add it to the README. πŸ˜„

Compatibility

Currently, this should work under any OS with support for Node and FFMPEG. Specifically in the tradition of this project being developed for raspberry pi, formerly as piStreamRadio , this also supports Raspbian as well.

Example Assets from the --generate template

Music is by Aviscerall, and Marquice Turner. Which is actually me (@torch2424), but I have a musical identitiy problem πŸ˜› . The .mp4 and .webm of the rotating earth, is a public domain video I found on Youtube. The image overlay uses images from EmojiOne, in particular, their video camera emoji, and their radio emoji.

Contributing

Feel free to fork the project, open up a PR, and give any contributions! I'd suggest opening an issue first however, just so everyone is aware and can discuss the proposed changes. πŸ‘

License

LICENSE under Apache 2.0. 🐦

This software uses code of FFmpeg licensed under the LGPLv2.1 and its source can be downloaded here.

As such, this software tries to respect the LGPLv2 License as close as possible to respect FFmpeg and its authors. Huge shoutout to them for building such an awesome and crazy tool!