Le fichier .noisesong et le lien noise://

Un morceau quitte NØISE sous l'une de deux formes lisibles par une machine : un fichier .noisesong (JSON) ou un lien noise:// (le même JSON, encodé dans une URL). Ni l'un ni l'autre ne contient d'audio. Les deux portent exactement un morceau.

Le fichier .noisesong

EXPORTER, dans la plaque MORCEAUX comme dans l'éditeur, écrit un document JSON en UTF-8. L'app déclare le type de fichier comme nl.weap.noise.song (« NØISE Song », conforme à public.json, extension .noisesong) : un double-clic sur un fichier l'ouvre donc dans NØISE.

L'enveloppe

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

Les clés sont écrites triées et le JSON est indenté. Les dates sont en ISO-8601, en UTC, sans fractions de seconde (2026-05-01T12:00:00Z) : l'app refuse les fractions de seconde.

L'objet song

{
  "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 et rhythmGuitar n'existent plus au niveau du morceau : ils vivent dans drums et jam. Un morceau venu d'une app plus récente n'échoue jamais sur une clé en plus ; les clés inconnues sont gardées sur un aller-retour.

Les rangées

Les deux mêmes blocs se trouvent sur le morceau (ce dont part chaque section) et sur une section (ce qu'elle dit elle-même). Chaque champ est optionnel et veut dire « pas réglé ici » — voir la règle de résolution.

drums — ce que la section dit au kit :

jam — les drapeaux du groupe :

La règle de résolution

Chaque champ d'une rangée se résout dans un seul ordre, champ par champ :

SECTION → LA SECTION D'AVANT → MORCEAU

• Une section qui règle un champ le décide. Une section qui règle fill.in et rien d'autre décide la cymbale et suit pour tout le reste.
• Une section qui laisse un champ ouvert joue ce que jouait la section d'avant — dis HALF TIME une fois et ça continue jusqu'à ce qu'autre chose le dise. Dans l'éditeur, ça se lit FOLLOW PREV.
• La première section n'a rien avant elle, donc elle prend les rangées du morceau (FOLLOW SONG).
• Le style, le kit et le genre sont ceux du morceau à chaque section. Rien qu'une section puisse dire.
• Le nom du preset ne suit que quand chaque bouton suit aussi. Une section qui a bougé un bouton sous un preset nommé se lit CUSTOM : le nom est un label pour exactement ces quatre valeurs. Une section qui nomme un preset et ne règle aucun bouton porte le nom ET les boutons de la section d'avant — l'éditeur écrit toujours un nom avec ses valeurs.
• L'auditeur n'est pas dans la liste. Un champ que le morceau laisse ouvert est complété par un défaut fixe, qui fait partie du format, pour que le même document joue le même groupe partout :

Le swing et le live d'une section atterrissent sur l'horloge de l'app (GRID) pendant que le morceau joue, et ne sont jamais enregistrés comme les tiens ; les tiens reviennent quand tu détaches le morceau.

L'objet chart

{
  "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" }
      ]
    }
  ]
}

Les types d'accord sont les 24 noms du ChordType de l'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. Dans le fichier, un tel nom est la clé d'un objet vide, { "minor7": {} }, sous type comme sous quality.

Ce que l'app accepte à l'import

importSongs essaie trois formes dans l'ordre et prend la première qui se décode :

1. un document .noisesong { "version": …, "song": { … } },
2. un objet song nu,
3. un export de bibliothèque entière { "version": …, "songs": [ … ] } : chaque morceau que cette version de l'app sait lire est importé ; les illisibles sont sautés, jamais le fichier entier.

Dans chaque forme, un morceau avec un schemaVersion inférieur à 3 est sauté : l'app note pourquoi dans le journal, et rien n'est converti.

Le lien noise://

Le bouton Ouvrir dans NØISE du site, et le bouton Copier le lien à côté, produisent ce lien. L'app ne fabrique aucun lien ; elle ne fait que les lire.

noise://song?d=<payload>

• schéma noise, hôte song, un seul paramètre de requête d ;
• <payload> est le document .noisesong encodé compact (sans espaces, clés triées, version: 3, schemaVersion: 3) en base64url (RFC 4648 §5, - et _ à la place de + et /, sans remplissage =).

Quand l'app ouvre un tel lien, elle décode la charge utile avec les mêmes règles qu'un fichier. Elle est tolérante : une charge utile arrivée avec remplissage ou encodée en pourcent se décode quand même. Comme le JSON n'est pas compressé, un lien fait à peu près 1,4 × la taille du JSON compact : un morceau de quatre sections, c'est quelques kilo-octets. Un lien plus long que ce que ton client de chat accepte se partage plutôt comme fichier.

Ouvrir un lien n'ajoute jamais rien en silence : l'app demande d'abord. Voir Import.

Où vit ta bibliothèque

Tous les morceaux sont rangés dans un seul fichier, dans le conteneur de l'app :

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

Il est écrit de façon atomique ; la version précédente est gardée comme jam-songs.json.bak à chaque enregistrement réussi, et un fichier principal corrompu est restauré en silence depuis la sauvegarde (la copie corrompue est gardée comme jam-songs.json.corrupt). La bibliothèque contient au plus 100 morceaux ; au-delà, les morceaux modifiés le moins récemment sont abandonnés à l'enregistrement. Une bibliothèque écrite avant le schéma 3 est mise de côté comme jam-songs.v2.json au premier lancement de 0.81, et la bibliothèque démarre vide : les morceaux ne sont pas convertis, ils sont réécrits dans l'éditeur.