Het .noisesong-bestand en de noise://-link

Een nummer verlaat NØISE in een van twee machineleesbare vormen: een .noisesong-bestand (JSON) of een noise://-link (dezelfde JSON, verpakt in een URL). Geen van beide bevat audio. Allebei bevatten precies één nummer.

Het .noisesong-bestand

EXPORT, in de NUMMERS-plaat en in de editor, schrijft een UTF-8 JSON-document. De app registreert het bestandstype als nl.weap.noise.song ("NØISE Song", conformeert aan public.json, extensie .noisesong), dus een dubbelklik op het bestand opent het in NØISE.

De envelop

{
  "version": 3,
  "song": { … }
}

Sleutels staan gesorteerd, met inspringing. Datums zijn ISO-8601 in UTC zonder decimalen in de seconden (2026-05-01T12:00:00Z): de app weigert seconden met decimalen.

Het song-object

{
  "id": "6F1A0E9C-3D4E-4B11-9A0B-1C2D3E4F5A6B",
  "name": "Amber Skyline",
  "author": "NØISE",
  "songDescription": "Demo song for the website",
  "style": "rock",
  "kit": "rock.classic",
  "drums": { "feel": "straight", "preset": { "name": "LAID BACK", "energy": 0.45, "swing": 0.2, "humanize": 0.25, "live": 0.35 } },
  "jam": { "intensity": 0.5, "colorLayer": false, "rhythmGuitar": true },
  "tempoHint": 112,
  "grooveSeed": 4422912175377245,
  "schemaVersion": 3,
  "createdAt": "2026-05-01T12:00:00Z",
  "updatedAt": "2026-05-01T12:00:00Z",
  "chart": { … }
}

feel, drumStyle, drumEnergy, drumHumanize, jamIntensity, colorLayer en rhythmGuitar bestaan niet meer op het niveau van het nummer: ze zitten in drums en jam. Een nummer uit een nieuwere app faalt nooit op een extra sleutel; onbekende sleutels blijven bewaard bij een round trip.

De blokken

Dezelfde twee blokken staan op het nummer (het beginpunt van elke sectie) en op een sectie (wat ze zelf zegt). Elk veld is optioneel en betekent "hier niet ingesteld" — zie de oplosregel.

drums — wat een sectie tegen de drummer zegt:

jam — de schakelaars van de band:

De oplosregel

Elk veld van een blok lost op in één volgorde, per veld:

SECTION → THE SECTION BEFORE IT → SONG

• Een sectie die een veld instelt beslist het. Een sectie die alleen fill.in instelt beslist het bekken en volgt voor de rest.
• Een sectie die een veld openlaat speelt wat de sectie ervoor speelde — zet HALF TIME eenmaal en het blijft gelden tot iets anders het zegt. In de editor leest dat als VOLG VORIGE.
• De eerste sectie heeft niets ervoor, dus neemt ze de blokken van het nummer (VOLG NUMMER).
• De stijl, de kit en het genre zijn die van het nummer, op elke sectie. Niets wat een sectie kan zeggen.
• De naam van de preset volgt alleen als elke knop dat doet. Een sectie die één knop verzet onder een genoemde preset leest CUSTOM: de naam is een label voor precies die vier waarden. Een sectie die een preset noemt en geen knop instelt draagt de naam ÉN de knoppen van de sectie ervoor — de editor schrijft een naam altijd samen met zijn waarden.
• De luisteraar staat niet in de rij. Een veld dat het nummer openlaat wordt aangevuld met een vaste standaardwaarde, onderdeel van het formaat, zodat hetzelfde document overal dezelfde band speelt:

De swing en live van een sectie landen op de klok van de app (GRID) terwijl het nummer speelt, en worden nooit als die van de speler bewaard; die van de speler komen terug zodra het nummer wordt losgelaten.

Het chart-object

{
  "writtenKey": { "tonic": 9, "mode": "minor" },
  "endBehavior": "end",
  "sections": [
    {
      "id": "…",
      "name": "INTRO",
      "repeats": 2,
      "energy": "sparse",
      "color": "cyan",
      "drums": { "feel": "straight", "fill": { "in": "none" } },
      "items": [
        { "ref": { "degree": { "_0": { "degree": 1, "alteration": 0, "quality": { "minor": {} }, "alterations": [], "secondaryOf": false } } },
          "duration": { "bars": 2, "ticks": 0 }, "rawText": "Am" },
        { "ref": { "absolute": { "_0": { "root": { "letter": "F", "accidental": 0 }, "type": { "major": {} }, "alterations": [] } } },
          "duration": { "bars": 1, "ticks": 0 }, "rawText": "F" }
      ]
    }
  ]
}

Akkoordtypes zijn de 24 namen van ChordType in de app: major minor diminished augmented sus2 sus4 major7 minor7 dominant7 diminished7 halfDiminished7 minorMajor7 augmented7 add9 major9 minor9 dominant9 major11 minor11 dominant11 major13 minor13 dominant13 power. In het bestand staat zo'n naam als de sleutel van een leeg object, { "minor7": {} }, zowel onder type als onder quality.

Wat de app bij importeren accepteert

importSongs probeert drie vormen op volgorde en neemt de eerste die decodeert:

1. een .noisesong-document { "version": …, "song": { … } },
2. een kaal song-object,
3. een export van een hele bibliotheek { "version": …, "songs": [ … ] }: elk nummer dat deze build kan lezen wordt geïmporteerd; onleesbare nummers worden overgeslagen, nooit het hele bestand.

In elke vorm wordt een nummer met schemaVersion lager dan 3 overgeslagen: de app logt waarom, en er wordt niets omgezet.

De noise://-link

De knop Open in NØISE op de website en Kopieer link ernaast maken deze link. De app maakt zelf geen links; die leest het alleen.

noise://song?d=<payload>

• URL-schema noise, host song, één queryparameter d;
• <payload> is het .noisesong-document, compact gecodeerd (geen witruimte, gesorteerde sleutels, version: 3, schemaVersion: 3) als base64url (RFC 4648 §5, - en _ in plaats van + en /, geen = als opvulling).

Opent de app zo'n link, dan decodeert het de payload met dezelfde regels als een bestand. De decoder is tolerant: een payload die met opvulling of percent-gecodeerd binnenkomt decodeert ook. Omdat de JSON niet gecomprimeerd is, is een link ongeveer 1,4 keer zo groot als de compacte JSON: een nummer met vier secties is een paar kilobyte. Wordt een link langer dan je chatprogramma accepteert, deel dan het bestand.

Een link openen voegt nooit stilletjes iets toe: de app vraagt eerst. Zie Import.

Waar je bibliotheek staat

Alle nummers staan in één bestand, in de container van de app:

~/Library/Containers/com.noise-app.macos/Data/Library/Application Support/NØISE/jam-songs.json

Het wordt atomair geschreven; elke keer dat bewaren lukt blijft de vorige versie staan als jam-songs.json.bak, en een corrupt hoofdbestand wordt zonder melding hersteld uit de back-up (de corrupte kopie blijft bewaard als jam-songs.json.corrupt). De bibliotheek bevat hoogstens 100 nummers; daarboven vallen bij het bewaren de nummers weg die het langst niet gewijzigd zijn. Een bibliotheek van vóór schema 3 wordt bij de eerste start van 0.81 opzijgezet als jam-songs.v2.json en de bibliotheek begint leeg — de nummers worden niet omgezet, maar opnieuw geschreven in de editor.