community

KO | EN

gitlite — search

#ai-agent #swift #rust #codex #chatgpt #nodejs #cli #framework #android #cpp

(★ 9)

The community exchange for SUB/WAVE skills, DJ personas, shows, and the public station directory

File Explorer

ZIP Download

- - add-app.yml
  - add-persona.yml
  - add-show.yml
  - add-skill.yml
  - add-station.yml
  - config.yml
  - report-app.yml
  - report-station.yml
- - app-submission.yml
  - build-catalog.yml
  - persona-submission.yml
  - show-submission.yml
  - skill-submission.yml
  - station-submission.yml
  - validate-catalog.yml
- - pico-subwave.png
  - subwave-desktop-screenshot.png
  - subwave-mcp.png
  - web-player-screenshot.png
  - web-player.png
- pico-subwave.json
- prism-player.json
- radiotop.json
- README.md
- sub-wave-e-ink-display-for-trmnl.json
- subwave-auto.json
- subwave-desktop.json
- subwave-discord-bot.json
- subwave-mcp.json
- subwave-tune.json
- talk-wave.json
- wave-tv.json
- web-player.json
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- - PERSONA.md
- build-catalog.mjs
- - SHOW.md
- - SHOW.md
- - SHOW.md
- - SHOW.md
- - SHOW.md
- - SHOW.md
- - SHOW.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- 2618-home-radio.json
- brisflix-radio.json
- chillwave-radio.json
- east-beach-radio.json
- echo-fm.json
- equinox-radio.json
- foggymtndrifter-fm.json
- juho-station.json
- klair-radio.json
- radio-bartek.json
- radio-parra-vergara.json
- README.md
- subwave-flagship.json
- whig-the-hig.json
- zetax-tempo-radio.json
.gitignore
catalog.json
CONTRIBUTING.md
package.json
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

The community exchange for **[SUB/WAVE](https://github.com/perminder-klair/subwave)** — the
personal internet radio station with an AI DJ. This repo holds the community-contributed
**skills**, **DJ personas**, **shows**, the public **station directory**, and the **apps
directory**. Every running SUB/WAVE station fetches this catalog **live**, so anything merged
here shows up in every station's admin panel — and on [getsubwave.com](https://getsubwave.com) —
without waiting for a software release.

## What's here

| Folder | What it is | Installs as |
|---|---|---|
| [`skills/`](skills/) | Between-track segment briefs (prompt-only, data-only) | a DJ skill in `/admin/skills` → Community |
| [`personas/`](personas/) | DJ characters — the "soul" + talk/tone knobs | a roster persona in `/admin/personas` → Community |
| [`shows/`](shows/) | Show templates — a brief + music-steering filters | a show in `/admin/shows` → Community |
| [`stations/`](stations/) | The public map of live SUB/WAVE stations | a pin on [/stations](https://getsubwave.com/stations) |
| [`apps/`](apps/) | Third-party apps + integrations built for SUB/WAVE | a card on [/apps](https://getsubwave.com/apps) |

Each entry is **one file (or folder)** so contributions never collide on merge.

`stations/` and `apps/` are **website-only** — they're published in the catalog but a running
station installs nothing from them. The other three are what a station's admin panel installs.

## How stations consume it

A CI job ([`build-catalog.yml`](.github/workflows/build-catalog.yml)) compiles every entry into a
single **[`catalog.json`](catalog.json)** at the repo root on each push to `main`. Stations fetch
it from raw GitHub by default (Fastly-fronted, ~5-min cache):

```
https://raw.githubusercontent.com/getsubwave/community/main/catalog.json
```

The controller memoises it (~30 min TTL, refreshable from the admin UI) and degrades to an empty
catalog if the fetch fails — a station never stops broadcasting because the catalog is unreachable.
An operator can point their station at a fork, a self-hosted mirror, or the jsDelivr CDN
(`https://cdn.jsdelivr.net/gh/getsubwave/community@main/catalog.json`) with `COMMUNITY_CATALOG_URL`.

**Don't edit `catalog.json` by hand** — it's generated. Edit the source files under `skills/`,
`personas/`, `shows/`, `stations/`, `apps/` and the workflow rebuilds it.

## Contributing

The easy way (no fork, no YAML): open one of the issue forms and a bot turns it into a one-file PR
for a maintainer to review.

- 🎛️ [Add a skill](https://github.com/getsubwave/community/issues/new?template=add-skill.yml)
- 🎙️ [Add a persona](https://github.com/getsubwave/community/issues/new?template=add-persona.yml)
- 📻 [Add a show](https://github.com/getsubwave/community/issues/new?template=add-show.yml)
- 🗺️ [Add your station](https://github.com/getsubwave/community/issues/new?template=add-station.yml)
- 🧰 [Submit an app](https://github.com/getsubwave/community/issues/new?template=add-app.yml)

Prefer to open the PR yourself? See **[CONTRIBUTING.md](CONTRIBUTING.md)** for each type's schema
and validation rules. `node scripts/build-catalog.mjs --check` validates your entry locally.

## License

Community submissions are contributed for use within SUB/WAVE. See the main project for license
details.

community

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README