- JavaScript 41%
- Java 24.3%
- HTML 16.4%
- EJS 13.6%
- CSS 2.4%
- Other 2.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
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. |
||
| .forgejo/workflows | ||
| client | ||
| docker | ||
| gradle/wrapper | ||
| service | ||
| .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
- De client beslist nooit wat er speelt. Geen eigen nummerkeuze, geen eigen bitrate.
- De Minecraft-server doet nooit zwaar werk. Geen mediabestanden, geen decoder, geen blokkerende HTTP in de tick.
- 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.