Is subwave still maintained?

Yes, active. Last change yesterday. Latest release v1.30.0, 6 days ago.

Some track record. 1.6k stars, 6 months old. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to install subwave on Windows (perminder-klair/subwave) · gitmanual

How to install on Windows

perminder-klair/subwave

Personal internet radio: Agentic AI DJ

Node.js

Difficulty: Easy
Time: about 5 min
Stars: ★ 1,641
Activity: Updated this month

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change yesterday. Latest release v1.30.0, 6 days ago.
Can I trust it?: Some track record1.6k stars, 6 months old. Get it from the official repo and read what it installs.

Saved setup from 12 h ago

Will it work on Windows?

Yes, with Docker on Windows

Apps are only published for macOS and Linux.
It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On Windows that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Website ↗getsubwave.comThe project's own site.

Also: Docs ↗

Heads-upBuilding it yourself? It also needs 3 settings in .env (1 secret).

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker compose up -d

Docker

docker compose -f docker-compose.byo.yml up -d

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for Windows yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for Windows. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js >=20runtime
1×npm package manager

3× settings in .env

ADMIN_USER
ADMIN_PASSsecret
SITE_URL

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/perminder-klair/subwave/badge.svg)](https://gitmanual.com/perminder-klair/subwave)

Good to know

The README mentions NVIDIA CUDA. Check its hardware section: some features (or all of them) may need an NVIDIA GPU.
Setup script found: scripts/setup.sh.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: .deepsec/package.json, app/package.json, cli/package.json, controller/package.json and 3 more

Details

License: MIT
Open issues: 91
Branch: develop

package.json scripts (10)

startnode bin/subwave
setupnode bin/subwave setup
devnode bin/subwave setup
dev:dockerdocker compose -f docker-compose.dev.yml up -d
dev:webnpm --prefix web run dev
rebuilddocker compose -f docker-compose.dev.yml up -d --build
logsdocker compose -f docker-compose.dev.yml logs -f
downdocker compose -f docker-compose.dev.yml down
jinglesbash scripts/generate-jingles.sh
cli:typechecknpm --prefix cli run typecheck

Files we read (11)

.env.example

.github/workflows/audio-tests.yml

.github/workflows/cli-smoke.yml

.github/workflows/deploy-cli-installer.yml

.github/workflows/enforce-main-source.yml

.github/workflows/lint.yml

.github/workflows/liquidsoap-image.yml

CONTRIBUTING.md

README.md

docker-compose.yml

package.json

2,523 files in the repo