Skip to content
Projects

Wolfiku/cumu has 56 GitHub stars and 0 forks. GitHot measured 0 in 7 days. Last checked 2026-11-18 11:18 UTC. Last push 2026-11-08.

How these counts are measured

Measured star growth

in 24h
Update delayed
in 7 days
0
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Lightweight self-hosted music & podcast streaming server with SQLite backend, PWA offline mode and zero telemetry.

Self-hosted

README.md

Original

cumu

A lightweight, self-hosted music & podcast streaming server — own your music, own your data.

  ██████╗██╗   ██╗███╗   ███╗██╗   ██╗
 ██╔════╝██║   ██║████╗ ████║██║   ██║
 ██║     ██║   ██║██╔████╔██║██║   ██║
 ██║     ██║   ██║██║╚██╔╝██║██║   ██║
 ╚██████╗╚██████╔╝██║ ╚═╝ ██║╚██████╔╝
  ╚═════╝ ╚═════╝ ╚═╝     ╚═╝ ╚═════╝

🚀 Quick Start (One-Line Installer)

Get cumu installed and running on Linux (Debian, Ubuntu, Proxmox LXC, Fedora, Arch) in seconds:

curl -fsSL https://raw.githubusercontent.com/Wolfiku/cumu/main/scripts/install.sh | bash

(Note: If you are logged in as root, do not add sudo before the command.)

📖 Looking for Docker Compose, Debian .deb packages, or offline archives?
Check out the complete INSTALL.md guide for all alternative deployment methods.


✨ Key Features

[+] Interactive Setup Wizard     — create your custom admin account on first launch
[+] Custom Port Support          — specify custom server port during install, in web setup, or via env
[+] Automated Daily Updates      — auto-updates via cron (Linux) & Watchtower (Docker)
[+] Admin Update Dashboard       — check for and trigger system updates directly in the web UI
[+] Instant Drag & Drop Import   — drop audio files or full folders into browser UI or ./music
[+] Recursive Library Scanner    — auto-scans nested subdirectories (Artist/Album/Song.mp3)
[+] Podcast Search & Player      — search millions of shows/episodes, manage feeds & progress
[+] PWA & Offline Mode           — save playlists offline for playback without internet
[+] Native Android App           — streaming, background playback, offline library & downloads (APK in Releases)
[+] Login Brute-Force Protection — failed logins are rate-limited per account and IP
[+] Multi-Format Audio           — MP3, FLAC, M4A, AAC, WAV, OGG, OPUS, ALAC support
[+] Embedded Artwork Extraction  — auto-extracts ID3 album covers or upload custom JPG/PNG
[+] Audio Seeking & Range Stream — HTTP Range requests for instant scrubbing
[+] Playlists & Library          — manage playlists, favorite songs, albums, and artists
[+] Modern Theme Engine          — clean, minimalist Studio Environment design system
[+] 100% Self-Hosted & Private   — SQLite backend, no cloud dependency, no telemetry

⚙️ Environment Variables

Customize runtime settings via .env or environment variables:

Variable Default Description
PORT 3000 HTTP port server listens on
HOST 0.0.0.0 Network interface binding address
SESSION_SECRET (auto-generated) Secret key used for signing session cookies
ADMIN_LOGIN_CODE (auto-generated) Code every admin must enter at login (and during first-time setup). If missing, the server generates one on startup and writes it to .env (in Docker: data/.env inside the data volume)
TRUST_PROXY (off) Set when cumu runs behind a reverse proxy (true, a hop count like 1, or an address/subnet like loopback), so login brute-force protection sees the real client IP
MUSIC_PATH ./music Path to host music storage folder
MAX_STORAGE_GB 50 Maximum library storage quota in GB
DB_PATH ./data/cumu.db Path to SQLite database file

📄 License

Distributed under the MIT License. See LICENSE for more information.