# mebtte/cicada

🎵 💻 📱 A multi-user music service for self-hosting.

Repository: https://github.com/mebtte/cicada
Canonical: https://ross.abutalabs.com/products/cicada
Language: TypeScript
License: GPL-3.0
License Family: copyleft
Topics: music, music-player, music-service, self-hosted, docker, pwa, ffmpeg, instrumental, song
Last push: 2026-08-20T14:27:23+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 98, longevity 100
- inputs: {"age_days": 1907, "days_push": 13, "days_rel": 13, "gap_med": 7.0, "n_releases_24m": 13}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1109, forks 78 (observed 2026-08-28T04:03:37.284041+00:00)

## What it is
Cicada is a self-hosted, multi-user music streaming service distributed as a single binary with an embedded PWA frontend and bundled ffmpeg. It supports multiple users with 2FA, shared playlists (musicbills), and lyrics/composer metadata.

## Use cases
- self-host my own music streaming server
- share a music library with family across devices
- stream my local music collection to phone via web app
- multi-user music service with 2FA
- replace Spotify with my own hosted music

## When to choose
- you want a lightweight single-binary self-hosted music server
- you need multi-user accounts with sharing and 2FA
- you prefer a PWA over installing native apps

## When to avoid
- you need transcoding-heavy large-scale streaming like Plex/Jellyfin
- you want desktop-native player features or offline sync
- you need integration with existing music metadata services

## Facets
- artifact type: application
- maturity: active
- function: audio-processing, http-server, auth, self-hosted
- domain: media, self-hosted, web-development
- platform: self-hosted, cross-platform, windows
- tags: music-streaming, pwa, multi-user, ffmpeg, media-server, typescript, docker, web-server, linux, macos

## Member repositories
- mebtte/cicada (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:37.284041+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-30T06:43:36.517991+00:00, confidence not recorded.
  - readme: https://github.com/mebtte/cicada (fetched 2026-08-28T04:03:37.284041+00:00, sha 28ca33ad956f)
- Data as of 2026-08-30T08:39:29.467469+00:00.
