nodocarabanchel / cadence

All-in-one web radio suite. Provides music search, request, artwork, UI, and real-time stream information.

Home Page:https://cadenceradio.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

FORK!

Esto es un fork con el docker-compose modificado para no usar nginx puesto que ya se ejecuta en la rpi1 el nginx inverso.

πŸ“» About

Cadence (or CadenceRadio) is an all-in-one internet radio suite.

The project ships with Icecast and Liquidsoap working out-of-the-box, made complete with a Cadence API providing library search, song request, album artwork, and real-time stream information in a browser UI. Install and deploy in minutes.

See a live demo on cadenceradio.com!

πŸƒ Get Started

An interactive installation script is provided. Users familiar with Docker can be up and running in ~5 minutes. Alternate installation methods, including manual configuration and Kubernetes deployments, are respectively described on the Installation Guide and in cadence-k8s.

Server Preparation

Installation

Clone the Cadence repository to your server, then run the following:

$ chmod +x ./install.sh
$ ./install.sh

You will be prompted to provide the absolute path to a directory containing your music, a stream hostname, a rate limit timeout, a service password, and optional DNS. If you need help figuring out what values to use, refer to the Installation Guide. Your radio stack will automatically launch and Cadence's web UI will become accessible at localhost:8080.

After initial installation, simply run docker compose pull to check for container updates, then docker compose up to start your station again. Run ./install.sh again at any time to reconfigure. If you make your own changes locally to Cadence's code, run docker compose up --build to build and run.

πŸ”¬ Technical Details

Architecture

Basic Architecture

If you're interested in implementation details, Cadence: Self-Hosted Web Radio Suite does a dive into how a typical Icecast/Liquidsoap web radio works and the value Cadence provides.

API Reference for Custom Clients

Cadence's GitHub Wiki also hosts an API Reference with complete request/response details, useful for anyone developing custom scripts or clients for their station.

Discord Server Integration

Cadence installations can be directly integrated with Discord Servers using CadenceBot. CadenceBot allows you to control your station through Discord chat and listen to the radio in voice channels! You can quickly demo a CadenceBot by adding it to your Discord server.

About

All-in-one web radio suite. Provides music search, request, artwork, UI, and real-time stream information.

https://cadenceradio.com


Languages

Language:Go 64.8%Language:JavaScript 14.7%Language:HTML 7.0%Language:Shell 5.8%Language:CSS 3.3%Language:Dockerfile 2.9%Language:Makefile 1.5%