live-stream-radio
v2.2.1
Published
24/7 live stream video radio station CLI / API
Downloads
12
Readme
live-stream-radio
formerly known as piStreamRadio.
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
- API Frontends
- Compatibility
- Example Assets from the
--generate
template - Contributing
- License
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!