{"id":43657193,"url":"https://github.com/creightonlinza/forever-jukebox","last_synced_at":"2026-03-03T06:03:00.449Z","repository":{"id":331311560,"uuid":"1126122342","full_name":"creightonlinza/forever-jukebox","owner":"creightonlinza","description":"An end-to-end Infinite Jukebox replacement that analyzes audio, serves it via an API, and plays it with interactive visualizations across both Web and Android platforms.","archived":false,"fork":false,"pushed_at":"2026-02-21T02:58:58.000Z","size":29260,"stargazers_count":7,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-21T02:59:43.378Z","etag":null,"topics":["android","api","audio-analysis","autocanonizer","beat-tracking","codex","docker","engine","essentia","infinite-jukebox","javascript","kotlin","kotlin-android","music-analysis","python","spotify","typescript","youtube","yt-dlp"],"latest_commit_sha":null,"homepage":"https://foreverjukebox.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/creightonlinza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-01T06:51:11.000Z","updated_at":"2026-02-21T02:59:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/creightonlinza/forever-jukebox","commit_stats":null,"previous_names":["creightonlinza/forever-jukebox"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/creightonlinza/forever-jukebox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creightonlinza%2Fforever-jukebox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creightonlinza%2Fforever-jukebox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creightonlinza%2Fforever-jukebox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creightonlinza%2Fforever-jukebox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/creightonlinza","download_url":"https://codeload.github.com/creightonlinza/forever-jukebox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creightonlinza%2Fforever-jukebox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29672890,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T03:11:15.450Z","status":"ssl_error","status_checked_at":"2026-02-21T03:10:34.920Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","api","audio-analysis","autocanonizer","beat-tracking","codex","docker","engine","essentia","infinite-jukebox","javascript","kotlin","kotlin-android","music-analysis","python","spotify","typescript","youtube","yt-dlp"],"created_at":"2026-02-04T21:03:12.431Z","updated_at":"2026-03-03T06:03:00.444Z","avatar_url":"https://github.com/creightonlinza.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The Forever Jukebox\n\n![The Forever Jukebox logo](./tfj-logo.png)\n\nThe Forever Jukebox is a self-hosted, end-to-end system that analyzes audio,\nserves the results via a lightweight API, and powers a refreshed Infinite\nJukebox-style web UI with branching playback and multiple visualizations. It\nalso includes an installable offline PWA and a native Android app for on-device\nplayback. It replaces reliance on the deprecated Spotify Audio Analysis engine\nby generating similar beat/segment/section data locally.\n\n## Structure\n\n- `engine/` — The Forever Jukebox audio analysis engine (with optional calibration support).\n- `api/` — REST API + worker that calls the engine.\n- `web/` — Web UI.\n- `pwa/` — Offline/local analysis PWA that can also export jukebox audio.\n- `android/` — Native Android app.\n- `schema.json` — JSON schema reference for analysis output.\n\n## Quick Start\n\nPrereqs: Python 3.10, npm (Node.js).\n\nAll-in-one (dev):\n\n```bash\n./dev.sh\n```\n\nThen open the web UI at `http://localhost:5173`.\n\n## Android (native app):\n\n- Download: [GitHub Releases](https://github.com/creightonlinza/forever-jukebox/releases/latest)\n- Signature (SHA-256):\n\n```bash\n  B5:30:EB:FD:C1:7E:C2:D0:1A:2E:9A:9D:D9:DD:02:CA:5D:2F:E0:7A:E2:C6:E5:F8:45:E7:FF:41:FD:78:B4:4D\n```\n\n## Docker (production)\n\nBuild and run the container with Docker Compose (serves web UI + offline PWA + API):\n\n```bash\nexport SPOTIFY_CLIENT_ID=...\nexport SPOTIFY_CLIENT_SECRET=...\nexport YOUTUBE_API_KEY=...\nexport ADMIN_KEY=...\nexport NTFY_TOPIC_KEY=...\nexport WORKER_COUNT=1\nexport ALLOW_USER_UPLOAD=false\nexport ALLOW_USER_YOUTUBE=false\nexport ALLOW_FAVORITES_SYNC=false\ndocker compose up --build\n```\n\n`ENGINE_CONFIG` is optional and unused by default; set it only when you explicitly want to use calibration parameters.\n\nYou can also put these values in a `.env` file (same directory as\n`docker-compose.yml`) and Compose will load them automatically.\n\nOpen:\n\n- Web UI: `http://localhost:8000/`\n- Offline PWA: `http://localhost:8000/offline/`\n\nAPI routes are under `/api/*`. The Compose file uses a named Docker volume\n(`storage`) to persist `/app/api/storage`.\n\n## For standalone setup, see:\n\n- [`engine/README.md`](https://github.com/creightonlinza/forever-jukebox/blob/master/engine/README.md)\n- [`api/README.md`](https://github.com/creightonlinza/forever-jukebox/blob/master/api/README.md)\n- [`web/README.md`](https://github.com/creightonlinza/forever-jukebox/blob/master/web/README.md)\n- [`pwa/README.md`](https://github.com/creightonlinza/forever-jukebox/blob/master/pwa/README.md)\n- [`android/README.md`](https://github.com/creightonlinza/forever-jukebox/blob/master/android/README.md)\n\n## Credits\n\n- The Infinite Jukebox (Paul Lamere): original interactive concept and UX inspiration.\n- The Echo Nest / Spotify Audio Analysis: foundational analysis schema and ideas.\n- EternalJukebox: keeping the dream alive.\n- madmom: beat/downbeat tracking models and utilities.\n- Essentia: audio features and DSP toolkits.\n- ffmpeg: audio decoding.\n- yt-dlp: YouTube search metadata and audio.\n- OpenAI Codex (GPT-5): implementation guidance and tooling.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreightonlinza%2Fforever-jukebox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcreightonlinza%2Fforever-jukebox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreightonlinza%2Fforever-jukebox/lists"}