No description
  • JavaScript 41%
  • Java 24.3%
  • HTML 16.4%
  • EJS 13.6%
  • CSS 2.4%
  • Other 2.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Dion Vos eb27dc36eb
All checks were successful
Build / Client-library (Java 21) (push) Successful in 1m21s
Build / Dienst (Node, rooktest) (push) Successful in 1m1s
Docker image / Build and publish image (push) Successful in 2s
test: wacht op de verbinding voordat de hooktest een frame stuurt
Op een drukke CI-machine kon het eerste frame aankomen voordat de client de
WebSocket verwerkte; de test wacht nu overal op connected. De mixertest dekt
ook mute all: master, gain en alle effectieve waarden gaan naar nul.
2026-11-06 20:17:18 +01:00
.forgejo/workflows test: kanalen, mixer en uplink krijgen hun eigen tests 2026-11-06 20:10:02 +01:00
client test: wacht op de verbinding voordat de hooktest een frame stuurt 2026-11-06 20:17:18 +01:00
docker
gradle/wrapper
service test: wacht op de verbinding voordat de hooktest een frame stuurt 2026-11-06 20:17:18 +01:00
.dockerignore
.gitattributes
.gitignore
build.gradle.kts
DESIGN.md
docker-compose.yml
Dockerfile
gradle.properties
gradlew
gradlew.bat
README.md
settings.gradle.kts

AIRWAVE

De rekenkracht en opslag naast Minecraft: muziek, mediabestanden en andere dingen die je niet in een tick wilt hebben.

Status: ontwerp v0.5. De dienst (Node + SQLite + ffmpeg) en de Java-client-library (client/) staan; de mod-code (speaker, /airwave, /link) hoort bij Uplink.


Het model in één alinea

AIRWAVE is een dienst met units. De MusicUnit bewaart tracks, maakt vier bitrates en streamt ze; de FileLibrary bewaart mediabestanden voor mods. Een mod vraagt om inhoud (resolve: "track 88 op 160 kbps") en krijgt een korte, getekende URL; andersom houdt de mod één uitgaande verbinding open waarover AIRWAVE opdrachten kan sturen (push: "speel deze playlist op die speakers"). De wereld beslist waar iets klinkt — AIRWAVE levert alleen wat er klinkt en hoe het bezorgd wordt.

/link  →  https://airwave.example.nl/link/7F3K2Q

Wat AIRWAVE niet is

  • Geen mod. Geen blokken, geen speakers, geen wereldlogica. Die horen bij de mod die AIRWAVE gebruikt (Uplink).
  • Geen tweede app waarin je zelf muziek uitzoekt. De wereld is de baas over wat er speelt.
  • Geen verplichting. Uplink werkt volledig zonder AIRWAVE; je verliest dan alleen streaming en de bibliotheek.

De onderdelen

Onderdeel Wat het doet Status
MusicUnit uploaden, transcoderen (16/64/160/320), bibliotheek, playlists, streams, radio v1
FileLibrary mediabestanden voor mods, varianten, quota, zichtbaarheid v1
Dashboard bibliotheek, playlists, servers en tokens, now-playing, bestanden v1
Push-kanaal opdrachten van de dienst naar de mod, met acks en replay v1
airwave-client Java-library (HTTP + WebSocket), geen Minecraft-klassen v1
VoiceUnit proximity chat als subproces, één adres later
ComputeUnit gereserveerd ooit

Drie harde regels

  1. De client beslist nooit wat er speelt. Geen eigen nummerkeuze, geen eigen bitrate.
  2. De Minecraft-server doet nooit zwaar werk. Geen mediabestanden, geen decoder, geen blokkerende HTTP in de tick.
  3. De dienst beslist nooit waar iets klinkt. Posities, bereik en tiers komen van de mod.

Documentatie

Document Inhoud
DESIGN.md Het volledige ontwerp: rollen, units, hooks, dashboard, opslag, beveiliging, MVP
service/README.md De dienst draaien, de API, de opslag, de rooktest
client/README.md De Java-library: resolve, uploaden, push, fouten, threads

De repo

service/    de dienst: Express, SQLite, ffmpeg, dashboard (Node 22)
client/     de Java-library voor mods (Gradle, Java 21, geen dependencies)
DESIGN.md   het ontwerp

Er is geen Minecraft-mod in deze repo: blokken, speakers en wereldlogica horen bij de mod. ./gradlew build bouwt en test de client-library.

Draaien op een server

Eén container, net als de andere diensten: de dienst plus Caddy voor HTTPS, al het staat in /data.

git clone https://git.vos.je/Bewerkt/AIRWAVE.git && cd AIRWAVE
docker compose up -d

Open daarna http://<ip-van-de-server> en doorloop de setup. Vul je een domein in, dan vraagt Caddy daar meteen een certificaat voor aan (on-demand TLS, alleen voor dat ene domein: de dienst moet het eerst goedkeuren via /internal/tls-allowed). Draait er al iets op poort 80/443 (ManageMC bijvoorbeeld), pas dan de poorten in docker-compose.yml aan of zet AIRWAVE achter die reverse proxy.

De updater naast de container haalt elke 15 minuten de nieuwste image op en herstart alleen als er iets nieuws is; je data in ./airwave-data blijft staan. De image wordt door CI gebouwd bij elke push naar main (:main) en bij een tag v* (:latest). Eenmalig instellen: een repository-secret REGISTRY_TOKEN met het recht write:package, anders slaat de image-workflow over met een melding.

Platform

  • Dienst: Docker, Node 22, Express, SQLite, ffmpeg, Caddy.
  • Client-library: Java 21-bytecode (werkt op 1.21.1 met Java 21 en op 26.3 met Java 25), geen Minecraft-imports.