# timeshiftsauce/CeruMusic

Ceru Music 是基于 Electron 和 Vue 开发的跨平台桌面音乐播放器工具，借鉴洛雪音乐插件思想，提供插件运行框架与播放功能，不直接存储、提供任何音乐源文件。用户需通过自行选择、安装合规插件获取音乐相关数据，项目旨在为开发者提供桌面应用技术实践与学习案例，为用户提供合规的音乐播放工具框架。

Repository: https://github.com/timeshiftsauce/CeruMusic
Canonical: https://ross.abutalabs.com/products/cerumusic
Homepage: https://ceru.docs.shiqianjiang.cn
License Family: other
Archived: true
Last push: 2026-06-20T14:30:04+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 88, release rhythm 73, longevity 27
- inputs: {"age_days": 385, "days_push": 74, "days_rel": 101, "gap_med": 1.0, "n_releases_24m": 87}
- flags: archived, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1911, forks 110 (observed 2026-08-28T04:05:53.254115+00:00)

## What it is
Ceru Music (澜音) is a cross-platform desktop music player built with Electron and Vue 3 that provides only a plugin runtime framework and playback features, without hosting any music files. Users must install their own compliant plugins to fetch music metadata and streams; the project was explicitly created as a desktop-app development learning case.

## Use cases
- play music on windows mac and linux with a desktop app
- load custom music source plugins into a player framework
- display synced lyrics and album art while listening
- manage local playlists without cloud sync
- learn electron and vue 3 desktop app development
- search songs across multiple music platforms via plugins

## When to choose
- you want an open-source, plugin-based desktop music player framework
- you need a real-world Electron + Vue 3 + TypeScript codebase to study
- you want local playlist management with lyrics display

## When to avoid
- you expect built-in music sources or bundled plugins - none are provided
- you need a maintained project - the repo is no longer maintained for copyright reasons
- you want cloud backup or streaming service integration

## Facets
- artifact type: application
- maturity: abandoned
- function: audio-processing, plugin-system, gui, search-engine
- domain: media, entertainment, desktop-applications, cross-platform, developer-tools
- platform: windows, cross-platform
- tags: music-player, electron, vue3, music-plugins, lyrics, playlist, agpl, discontinued, macos, linux, desktop

## Member repositories
- timeshiftsauce/CeruMusic (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:53.254115+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:11:02.767438+00:00, confidence not recorded.
  - readme: https://github.com/timeshiftsauce/CeruMusic (fetched 2026-08-28T04:05:53.254115+00:00, sha 247707e78bc9)
  - homepage: https://ceru.docs.shiqianjiang.cn (fetched 2026-08-29T10:50:30.362603+00:00, sha 20f234cbd06e)
  - site_page: https://api.ceru.shiqianjiang.cn/api-docs (fetched 2026-08-29T10:50:30.365755+00:00, sha 1275efa95589)
- Data as of 2026-08-30T08:39:29.467469+00:00.