kenellorando/cadence：一体化网络广播套件，具浏览器界面、音乐搜索、点歌、艺术作品和

项目介绍

kenellorando/cadence 是一个托管在 GitHub 上的开源项目，主要使用 Go 编写，目前获得 65 个 Star、17 次 Fork。

仓库全名: kenellorando/cadence
Star 数: 65
Fork 数: 17
未关闭 Issue: 23

README 摘要

📻 About Cadence (or CadenceRadio) is an all-in-one internet radio suite. The project ships Icecast and Liquidsoap working out-of-the-box, made complete by a Cadence API providing song request, library search, album artwork, and real-time stream information in a browser UI. See a live demo on cadenceradio.com! 🏃 Get Started An interactive installation script is provided. Users familiar with Docker can be up and…

完整内容见 GitHub 原始 README 或本页。

常见问题

cadence 用什么语言开发？

主要使用 Go 编写，目前有 65 个 Star。

如何获取 cadence 的源码？

可以直接克隆仓库：git clone https://github.com/kenellorando/cadence.git，默认分支为 master；安装与运行步骤见仓库 README。

cadence 最近还在维护吗？

仓库最近一次更新为 9月7日，当前有 23 个未关闭 Issue；Star 数为 65，可作为社区活跃度的参考。

关于

GitHub 原始描述（英文）

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

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分

104

价值分

活跃状态

活跃

cadenceradio compose docker-compose icecast icecast2 internet-radio internet-station liquidsoap radio radio-player self-hosted selfhosted stream web-player web-radio web-radio-server webradio zutomayo

GitHub

语言占比

CSS

Dockerfile

HTML

JavaScript

Makefile

Shell

Release

Cadence Radio 5.4.42024年5月9日
Cadence Radio 5.4.32023年11月2日
Cadence Radio 5.4.22023年4月1日
Cadence Radio 5.4.12023年3月27日
Cadence Radio 5.4.02023年3月12日

贡献者

README

📻 About

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

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

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.

Server Preparation

Docker Engine and Docker Compose V2 are installed.
You have some music files (e.g. .mp3, .flac) with title and artist metadata.

Installation

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

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

You will be prompted to provide an absolute path to a directory containing music, a stream hostname, a rate limit timeout, a service password, and optional reverse proxy configuration. 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 changes to code locally, run docker compose up --build to build and run.

🔬 Technical Details

Architecture

Basic Architecture

If you’re interested in implementation details, this blog post does a dive into how a basic 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.

cadence