@audiofool/moondog 0.3.0-beta.2 → 0.3.0-beta.4

package/src/i18n/screen/pt.mjs

@@ -1060,4 +1060,62 @@ export default {
   "The next record is still being cut.": "O próximo disco ainda está sendo gravado.",
   "Off air.": "Fora do ar.",
   "Turn on music making first: /generation on.": "Ative a criação de música primeiro: /generation on.",
+  "Download a Stable Audio 3 model from Stability AI": "Baixar um modelo do Stable Audio 3 da Stability AI",
+  "Make music with a downloaded model": "Fazer música com um modelo baixado",
+  "Delete a downloaded model from this Mac": "Apagar deste Mac um modelo baixado",
+  "Stop the download": "Parar o download",
+  "Medium: best sound, about 5.2 GB": "Medium: o melhor som, cerca de 5,2 GB",
+  "Small Music: faster, lighter, about 1.7 GB": "Small Music: mais rápido e leve, cerca de 1,7 GB",
+  "getting ready": "preparando",
+  "There isn't enough free space on this Mac for the download. Free some up, then use /generation download again.": "Não há espaço livre suficiente neste Mac para o download. Libere um pouco e use /generation download de novo.",
+  "A downloaded file didn't match the one Stability AI publishes, so Moondog deleted it. Use /generation download to try again.": "Um arquivo baixado não coincidia com o que a Stability AI publica, então o Moondog o apagou. Use /generation download para tentar de novo.",
+  "The download couldn't reach its source. Check your connection, then use /generation download to try again.": "O download não conseguiu chegar à origem. Verifique sua conexão e use /generation download para tentar de novo.",
+  "Another Moondog window or terminal is already downloading. /generation shows how far it is.": "Outra janela ou terminal do Moondog já está baixando. /generation mostra quanto falta.",
+  "The download didn't finish: {error}. Use /generation download to try again.": "O download não terminou: {error}. Use /generation download para tentar de novo.",
+  "unknown error": "erro desconhecido",
+  "Stable Audio 3 {model} is ready. Ask for a track.": "O Stable Audio 3 {model} está pronto. Peça uma faixa.",
+  "Stable Audio 3 {model} is downloaded. Use it with /generation use {choice}.": "O Stable Audio 3 {model} foi baixado. Use com /generation use {choice}.",
+  "Download stopped. /generation download {choice} picks it up where it left off.": "Download parado. /generation download {choice} continua de onde parou.",
+  "download stopped on an error": "download parado por um erro",
+  "downloading": "baixando",
+  "downloading, {percent}%": "baixando, {percent}%",
+  "installed, in use": "instalado, em uso",
+  "installed": "instalado",
+  "partly downloaded": "baixado em parte",
+  "not downloaded": "não baixado",
+  "{size} GB": "{size} GB",
+  "In use: your own install at {folder}.": "Em uso: sua própria instalação em {folder}.",
+  "Get a model with /generation download medium or small. /generation use, remove and cancel manage them.": "Baixe um modelo com /generation download medium ou small. /generation use, remove e cancel cuidam deles.",
+  "Making music on this Mac is off. Get Stable Audio 3 with /generation download medium, or small for a lighter model; music making turns on when it's done.": "Fazer música neste Mac está desativado. Baixe o Stable Audio 3 com /generation download medium, ou small para um modelo mais leve; a criação de música é ativada ao terminar.",
+  "Stable Audio 3 {model} isn't downloaded yet. Get it with /generation download {choice}.": "O Stable Audio 3 {model} ainda não foi baixado. Baixe com /generation download {choice}.",
+  "Making music on this Mac is off. Stable Audio 3 {model} is ready; turn it on with /generation on.": "Fazer música neste Mac está desativado. O Stable Audio 3 {model} está pronto; ative com /generation on.",
+  "Use /generation download, use or remove with medium or small, or /generation cancel.": "Use /generation download, use ou remove com medium ou small, ou /generation cancel.",
+  "No download is running.": "Nenhum download em andamento.",
+  "Stable Audio 3 {model} is already downloading.": "O Stable Audio 3 {model} já está sendo baixado.",
+  "Another download is running. /generation cancel stops it.": "Há outro download em andamento. /generation cancel o interrompe.",
+  "Stable Audio 3 {model} is already on this Mac. Use it with /generation use {choice}.": "O Stable Audio 3 {model} já está neste Mac. Use com /generation use {choice}.",
+  "Already downloaded.": "Já foi baixado.",
+  "Stable Audio 3 comes under the Stability AI Community License ({license}), and its text encoder, T5Gemma, under the Gemma Terms of Use ({gemma}). Moondog downloads it only from Stability AI's official sources and checks every file.\n\nTo agree and download {model} ({size} GB): /generation download {choice} --agree": "O Stable Audio 3 está sob a Stability AI Community License ({license}), e seu codificador de texto, T5Gemma, sob os Gemma Terms of Use ({gemma}). O Moondog o baixa só das fontes oficiais da Stability AI e confere cada arquivo.\n\nPara aceitar e baixar o {model} ({size} GB): /generation download {choice} --agree",
+  "Waiting for your agreement.": "Aguardando sua aceitação.",
+  "The download didn't finish.": "O download não terminou.",
+  "Downloading Stable Audio 3 {model} ({size} GB) from Stability AI's official sources. It runs in the background; /generation cancel stops it, and a later download picks up where it left off.": "Baixando o Stable Audio 3 {model} ({size} GB) das fontes oficiais da Stability AI. Ele segue em segundo plano; /generation cancel o interrompe, e um download depois continua de onde parou.",
+  "Downloading Stable Audio 3 {model}.": "Baixando o Stable Audio 3 {model}.",
+  "Wait for the download to finish, or stop it with /generation cancel, before removing a model.": "Espere o download terminar, ou pare com /generation cancel, antes de remover um modelo.",
+  "A download is running.": "Há um download em andamento.",
+  "Stable Audio 3 {model} isn't on this Mac.": "O Stable Audio 3 {model} não está neste Mac.",
+  "Removing Stable Audio 3 {model} deletes its {size} GB from this Mac. It's the last model, so the rest of Moondog's Stable Audio 3 setup goes too. To go ahead: /generation remove {choice} --yes": "Remover o Stable Audio 3 {model} apaga seus {size} GB deste Mac. É o último modelo, então o resto da instalação do Stable Audio 3 do Moondog também sai. Para continuar: /generation remove {choice} --yes",
+  "Removing Stable Audio 3 {model} deletes its {size} GB from this Mac. To go ahead: /generation remove {choice} --yes": "Remover o Stable Audio 3 {model} apaga seus {size} GB deste Mac. Para continuar: /generation remove {choice} --yes",
+  "Nothing removed yet.": "Nada foi removido ainda.",
+  "Removed Stable Audio 3 {model} from this Mac.": "Stable Audio 3 {model} removido deste Mac.",
+  "Removed.": "Removido.",
+  "Removed. Music making isn't ready.": "Removido. A criação de música não está pronta.",
+  "Use /generation, /generation on [folder] or off, or /generation download, use or remove with medium or small.": "Use /generation, /generation on [pasta] ou off, ou /generation download, use ou remove com medium ou small.",
+  "best sound": "o melhor som",
+  "faster, lighter": "mais rápido e leve",
+  "getting uv": "obtendo o uv",
+  "getting Stable Audio 3's code": "obtendo o código do Stable Audio 3",
+  "setting up Python": "preparando o Python",
+  "downloading the model": "baixando o modelo",
+  "checking the files": "conferindo os arquivos",
+  "Stable Audio 3's Python environment couldn't be set up. Check your connection, then use /generation download to try again.": "Não foi possível preparar o ambiente Python do Stable Audio 3. Verifique sua conexão e use /generation download para tentar de novo.",
 };

package/src/i18n/screen/zh.mjs

@@ -1060,4 +1060,62 @@ export default {
   "The next record is still being cut.": "下一张还在刻。",
   "Off air.": "已停播。",
   "Turn on music making first: /generation on.": "先开启音乐生成：/generation on。",
+  "Download a Stable Audio 3 model from Stability AI": "从 Stability AI 下载一个 Stable Audio 3 模型",
+  "Make music with a downloaded model": "用已下载的模型做音乐",
+  "Delete a downloaded model from this Mac": "从这台 Mac 删除一个已下载的模型",
+  "Stop the download": "停止下载",
+  "Medium: best sound, about 5.2 GB": "Medium：音质最好，约 5.2 GB",
+  "Small Music: faster, lighter, about 1.7 GB": "Small Music：更快更轻，约 1.7 GB",
+  "getting ready": "准备中",
+  "There isn't enough free space on this Mac for the download. Free some up, then use /generation download again.": "这台 Mac 的可用空间不够下载。腾出一些空间，再用一次 /generation download。",
+  "A downloaded file didn't match the one Stability AI publishes, so Moondog deleted it. Use /generation download to try again.": "有个下载的文件和 Stability AI 发布的不一致，Moondog 已把它删除。用 /generation download 重试。",
+  "The download couldn't reach its source. Check your connection, then use /generation download to try again.": "下载连不上来源。检查网络连接，再用 /generation download 重试。",
+  "Another Moondog window or terminal is already downloading. /generation shows how far it is.": "另一个 Moondog 窗口或终端已经在下载。/generation 可以看进度。",
+  "The download didn't finish: {error}. Use /generation download to try again.": "下载没有完成：{error}。用 /generation download 重试。",
+  "unknown error": "未知错误",
+  "Stable Audio 3 {model} is ready. Ask for a track.": "Stable Audio 3 {model} 已就绪。想听就让它做一首。",
+  "Stable Audio 3 {model} is downloaded. Use it with /generation use {choice}.": "Stable Audio 3 {model} 已下载。用 /generation use {choice} 来使用它。",
+  "Download stopped. /generation download {choice} picks it up where it left off.": "下载已停止。/generation download {choice} 会从停下的地方接着下。",
+  "download stopped on an error": "下载因错误停止",
+  "downloading": "下载中",
+  "downloading, {percent}%": "下载中，{percent}%",
+  "installed, in use": "已安装，使用中",
+  "installed": "已安装",
+  "partly downloaded": "已下载一部分",
+  "not downloaded": "未下载",
+  "{size} GB": "{size} GB",
+  "In use: your own install at {folder}.": "使用中：你自己在 {folder} 的安装。",
+  "Get a model with /generation download medium or small. /generation use, remove and cancel manage them.": "用 /generation download medium 或 small 获取模型。/generation use、remove 和 cancel 用来管理它们。",
+  "Making music on this Mac is off. Get Stable Audio 3 with /generation download medium, or small for a lighter model; music making turns on when it's done.": "在这台 Mac 上做音乐已关闭。用 /generation download medium 获取 Stable Audio 3，想要更轻的模型就用 small；下载完成后会开启音乐生成。",
+  "Stable Audio 3 {model} isn't downloaded yet. Get it with /generation download {choice}.": "Stable Audio 3 {model} 还没下载。用 /generation download {choice} 获取。",
+  "Making music on this Mac is off. Stable Audio 3 {model} is ready; turn it on with /generation on.": "在这台 Mac 上做音乐已关闭。Stable Audio 3 {model} 已准备好，用 /generation on 开启。",
+  "Use /generation download, use or remove with medium or small, or /generation cancel.": "用 /generation download、use 或 remove 加上 medium 或 small，或用 /generation cancel。",
+  "No download is running.": "没有正在进行的下载。",
+  "Stable Audio 3 {model} is already downloading.": "Stable Audio 3 {model} 已经在下载了。",
+  "Another download is running. /generation cancel stops it.": "另一个下载正在进行。/generation cancel 可以停止它。",
+  "Stable Audio 3 {model} is already on this Mac. Use it with /generation use {choice}.": "Stable Audio 3 {model} 已经在这台 Mac 上。用 /generation use {choice} 来使用它。",
+  "Already downloaded.": "已经下载过了。",
+  "Stable Audio 3 comes under the Stability AI Community License ({license}), and its text encoder, T5Gemma, under the Gemma Terms of Use ({gemma}). Moondog downloads it only from Stability AI's official sources and checks every file.\n\nTo agree and download {model} ({size} GB): /generation download {choice} --agree": "Stable Audio 3 适用 Stability AI Community License（{license}），它的文本编码器 T5Gemma 适用 Gemma Terms of Use（{gemma}）。Moondog 只从 Stability AI 的官方来源下载，并校验每个文件。\n\n同意并下载 {model}（{size} GB）：/generation download {choice} --agree",
+  "Waiting for your agreement.": "等你同意。",
+  "The download didn't finish.": "下载没有完成。",
+  "Downloading Stable Audio 3 {model} ({size} GB) from Stability AI's official sources. It runs in the background; /generation cancel stops it, and a later download picks up where it left off.": "正在从 Stability AI 的官方来源下载 Stable Audio 3 {model}（{size} GB）。它在后台进行；/generation cancel 可以停止，之后再下载会从停下的地方接着下。",
+  "Downloading Stable Audio 3 {model}.": "正在下载 Stable Audio 3 {model}。",
+  "Wait for the download to finish, or stop it with /generation cancel, before removing a model.": "删除模型前，先等下载完成，或用 /generation cancel 停止它。",
+  "A download is running.": "有下载正在进行。",
+  "Stable Audio 3 {model} isn't on this Mac.": "这台 Mac 上没有 Stable Audio 3 {model}。",
+  "Removing Stable Audio 3 {model} deletes its {size} GB from this Mac. It's the last model, so the rest of Moondog's Stable Audio 3 setup goes too. To go ahead: /generation remove {choice} --yes": "删除 Stable Audio 3 {model} 会从这台 Mac 删掉它的 {size} GB。这是最后一个模型，所以 Moondog 的 Stable Audio 3 其余部分也会一并删除。确定的话：/generation remove {choice} --yes",
+  "Removing Stable Audio 3 {model} deletes its {size} GB from this Mac. To go ahead: /generation remove {choice} --yes": "删除 Stable Audio 3 {model} 会从这台 Mac 删掉它的 {size} GB。确定的话：/generation remove {choice} --yes",
+  "Nothing removed yet.": "还没有删除任何东西。",
+  "Removed Stable Audio 3 {model} from this Mac.": "已从这台 Mac 删除 Stable Audio 3 {model}。",
+  "Removed.": "已删除。",
+  "Removed. Music making isn't ready.": "已删除。音乐生成还没准备好。",
+  "Use /generation, /generation on [folder] or off, or /generation download, use or remove with medium or small.": "用 /generation、/generation on [文件夹] 或 off，或用 /generation download、use 或 remove 加上 medium 或 small。",
+  "best sound": "音质最好",
+  "faster, lighter": "更快更轻",
+  "getting uv": "正在获取 uv",
+  "getting Stable Audio 3's code": "正在获取 Stable Audio 3 的代码",
+  "setting up Python": "正在准备 Python",
+  "downloading the model": "正在下载模型",
+  "checking the files": "正在校验文件",
+  "Stable Audio 3's Python environment couldn't be set up. Check your connection, then use /generation download to try again.": "没能准备好 Stable Audio 3 的 Python 环境。检查网络连接，再用 /generation download 重试。",
 };

package/src/integrations/apple-music/terminal-preview-player.mjs

@@ -7,6 +7,8 @@ import { access, constants, rm, stat, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
 
+import { createPlayerNow } from "../../core/listening-now.mjs";
+
 // Players that play one file without a window and exit at its end, in order of preference.
 // None of them may read or write the terminal: the listening room owns it.
 const systemPlayers = {
@@ -69,8 +71,11 @@ export async function createTerminalPreviewPlayer({
   let queue = null;
   let child = null;
   let closed = false;
+  // What it plays, for the agent: the queue it holds, moved along by its own events.
+  const now = createPlayerNow();
 
   const emit = (event) => {
+    now.observe(event);
     for (const listener of listeners) {
       try { listener(event); } catch {}
     }
@@ -223,6 +228,7 @@ export async function createTerminalPreviewPlayer({
       if (closed || !name || typeof file !== "string" || !path.isAbsolute(file)) return;
       if (!queue || !queue.tracks.every((track) => track.generated)) return this.playGenerated({ id, title, file });
       queue.tracks.push({ title: name, artist_credit: "", generated: true, id: String(id ?? ""), file });
+      now.appended({ title: name, generated: true });
     },
     // Ends the song now playing, or still loading; the next one starts after it.
     skip() {
@@ -232,6 +238,8 @@ export async function createTerminalPreviewPlayer({
       return true;
     },
     stop,
+    // What plays now, as createPlayerNow reads it: null, or { state, song, position, count, next }.
+    nowPlaying: () => (closed ? null : now.read()),
     // Leaving Apple Music stops its previews here, never the tracks Moondog made.
     holdsCatalogSongs: () => Boolean(queue?.tracks.some((track) => !track.generated)),
     subscribe(listener) {

package/src/integrations/stable-audio/cover.mjs

@@ -0,0 +1,324 @@
+// The sleeve of a track Moondog made: a grid of characters, drawn as an SVG, never an image model.
+// It reads only the track's receipt: the seed, what shaped the sound, and how loud the track ran from
+// start to end. So one track always has one cover, and a stream that keeps only its newest audio
+// still draws every cover. The loud band across the middle is the track itself; the field behind it
+// takes its characters and colour from the track's textures, genres and moods.
+import { open, readFile } from "node:fs/promises";
+import path from "node:path";
+
+// How many loudness readings a receipt keeps, from the start of the track to its end.
+export const LOUDNESS_POINTS = 64;
+// The grid: 40 columns by 24 rows on a 600-point square, so a cell is about as tall as a monospace glyph.
+const COLUMNS = 40;
+const ROWS = 24;
+const SIZE = 600;
+const MARGIN = 30;
+const CELL_W = (SIZE - 2 * MARGIN) / COLUMNS;
+const CELL_H = (SIZE - 2 * MARGIN) / ROWS;
+// The rows the art fills; the rows above and below carry the readout.
+const ART_TOP = 2;
+const ART_ROWS = 19;
+export const COVER_VERSION = 1;
+
+// ── Loudness ──────────────────────────────────────────────────────────────────────────────────
+
+/**
+ * How loud a WAV runs from start to end: `points` readings from 0 (30 dB under its loudest stretch,
+ * or quieter) to 1 (its loudest). Reads 16-, 24- and 32-bit PCM and 32-bit float. Null when the file
+ * is not a WAV it can read.
+ */
+export async function readLoudness(file, points = LOUDNESS_POINTS) {
+  const handle = await open(file, "r");
+  try {
+    const size = (await handle.stat()).size;
+    const head = Buffer.alloc(12);
+    await handle.read(head, 0, 12, 0);
+    if (head.toString("ascii", 0, 4) !== "RIFF" || head.toString("ascii", 8, 12) !== "WAVE") return null;
+    let format = null;
+    let data = null;
+    for (let offset = 12; offset + 8 <= size && !data;) {
+      const chunk = Buffer.alloc(8);
+      await handle.read(chunk, 0, 8, offset);
+      const id = chunk.toString("ascii", 0, 4);
+      const length = chunk.readUInt32LE(4);
+      if (id === "fmt ") {
+        const body = Buffer.alloc(Math.min(length, 40));
+        await handle.read(body, 0, body.length, offset + 8);
+        let code = body.readUInt16LE(0);
+        // WAVE_FORMAT_EXTENSIBLE names the real format in its subformat.
+        if (code === 0xfffe && body.length >= 26) code = body.readUInt16LE(24);
+        format = { code, channels: body.readUInt16LE(2), bits: body.readUInt16LE(14) };
+      } else if (id === "data") {
+        data = { start: offset + 8, length: Math.min(length, size - offset - 8) };
+      }
+      offset += 8 + length + (length % 2);
+    }
+    if (!format || !data || !format.channels) return null;
+    const bytes = format.bits / 8;
+    const sample = format.code === 3 && format.bits === 32 ? (buffer, at) => buffer.readFloatLE(at)
+      : format.code === 1 && format.bits === 16 ? (buffer, at) => buffer.readInt16LE(at) / 32768
+        : format.code === 1 && format.bits === 24 ? (buffer, at) => buffer.readIntLE(at, 3) / 8388608
+          : format.code === 1 && format.bits === 32 ? (buffer, at) => buffer.readInt32LE(at) / 2147483648 : null;
+    if (!sample) return null;
+    const frameBytes = bytes * format.channels;
+    const frames = Math.floor(data.length / frameBytes);
+    if (frames < points) return null;
+    const sums = new Float64Array(points);
+    const counts = new Float64Array(points);
+    const chunkFrames = 65_536;
+    const buffer = Buffer.alloc(chunkFrames * frameBytes);
+    for (let frame = 0; frame < frames; frame += chunkFrames) {
+      const count = Math.min(chunkFrames, frames - frame);
+      const { bytesRead } = await handle.read(buffer, 0, count * frameBytes, data.start + frame * frameBytes);
+      const read = Math.floor(bytesRead / frameBytes);
+      for (let index = 0; index < read; index += 1) {
+        const point = Math.min(points - 1, Math.floor(((frame + index) * points) / frames));
+        let energy = 0;
+        for (let channel = 0; channel < format.channels; channel += 1) {
+          const value = sample(buffer, index * frameBytes + channel * bytes);
+          energy += value * value;
+        }
+        sums[point] += energy / format.channels;
+        counts[point] += 1;
+      }
+      if (read < count) break;
+    }
+    const decibels = [...sums].map((sum, point) => 10 * Math.log10(Math.max(1e-10, sum / Math.max(1, counts[point]))));
+    const loudest = Math.max(...decibels);
+    return decibels.map((db) => Math.round(Math.max(0, Math.min(1, (db - (loudest - 30)) / 30)) * 1000) / 1000);
+  } finally {
+    await handle.close();
+  }
+}
+
+// ── The look, from what shaped the sound ─────────────────────────────────────────────────────
+
+// Each glyph ramp runs from empty to dense. The track's words pick one.
+const RAMPS = [
+  { name: "grain", ramp: " .,:;irsXA253hMHGS#9B&@", words: ["tape", "crackle", "vinyl", "lofi", "lo-fi", "dust", "noise", "grit", "distort", "saturat", "fuzz", "analog", "cassette", "hiss", "warble", "boom bap"] },
+  { name: "soft", ramp: " .'`-~:=+*", words: ["ambient", "reverb", "wash", "air", "dream", "ether", "drone", "shimmer", "pad", "haze", "mist", "calm", "gentle", "soft", "float", "shoegaze", "new age"] },
+  { name: "digital", ramp: " .-:=+01x#", words: ["electronic", "techno", "house", "synth", "glitch", "digital", "idm", "trance", "edm", "chip", "bit", "modular", "acid", "breakbeat", "drum and bass", "dubstep", "electro"] },
+  { name: "strings", ramp: " .,-~:;!|/", words: ["piano", "guitar", "string", "folk", "jazz", "acoustic", "orchestra", "wood", "cello", "violin", "harp", "classical", "choir", "brass", "bass clarinet", "upright"] },
+];
+const DEFAULT_RAMP = " .:-=+*#%@";
+
+// Hues for the words a track carries; light paper for the bright ones.
+const HUES = [
+  { hue: 32, words: ["warm", "sun", "amber", "golden", "tape", "vinyl", "lofi", "lo-fi", "soul", "funk", "dust", "cassette", "boom bap"] },
+  { hue: 232, words: ["night", "dark", "noir", "midnight", "melanchol", "sad", "moody", "deep", "nocturn", "cold", "brooding"] },
+  { hue: 182, words: ["ambient", "ocean", "water", "aquatic", "chill", "calm", "dream", "float", "reverb", "shoegaze", "wash", "rain"] },
+  { hue: 350, words: ["jazz", "blues", "romantic", "lounge", "love", "sensual", "r&b", "neo soul"] },
+  { hue: 286, words: ["electronic", "techno", "synth", "neon", "glitch", "acid", "cyber", "trance", "house", "electro"] },
+  { hue: 96, words: ["folk", "acoustic", "pastoral", "forest", "organic", "nature", "country", "earthy"] },
+  { hue: 46, light: true, words: ["bright", "happy", "pop", "upbeat", "euphoric", "joy", "sunny", "playful", "uplifting"] },
+];
+
+// A small seeded generator, so a seed always draws the same cover.
+function random(seed) {
+  let state = seed >>> 0;
+  return () => {
+    state = (state + 0x6d2b79f5) >>> 0;
+    let value = state;
+    value = Math.imul(value ^ (value >>> 15), value | 1);
+    value ^= value + Math.imul(value ^ (value >>> 7), value | 61);
+    return ((value ^ (value >>> 14)) >>> 0) / 4294967296;
+  };
+}
+const hash = (text) => [...String(text)].reduce((sum, character) => (Math.imul(sum, 31) + character.codePointAt(0)) >>> 0, 2166136261);
+
+// The words that shaped the track: texture counts most, then genre, mood and the rest.
+function wordsOf(receipt) {
+  const weights = { texture: 3, genre: 2, mood: 2, instrument: 1, rhythm: 1 };
+  return (Array.isArray(receipt?.shaped_by) ? receipt.shaped_by : [])
+    .filter((entry) => typeof entry?.term === "string")
+    .map((entry) => ({ term: entry.term.toLowerCase(), weight: weights[entry.facet] ?? 1 }));
+}
+function bestMatch(options, words) {
+  let best = null;
+  let bestScore = 0;
+  for (const option of options) {
+    const score = words.reduce((sum, { term, weight }) => sum + (option.words.some((word) => term.includes(word)) ? weight : 0), 0);
+    if (score > bestScore) { best = option; bestScore = score; }
+  }
+  return best;
+}
+
+const hsl = (h, s, l) => `hsl(${Math.round(((h % 360) + 360) % 360)} ${Math.round(s)}% ${Math.round(l)}%)`;
+
+// ── The field ────────────────────────────────────────────────────────────────────────────────
+
+// A field behind the band: a few seeded waves, or rings around a point, as the seed chooses. Values 0 to 1.
+function backgroundField(next) {
+  const kind = next() < 0.5 ? "waves" : "rings";
+  const waves = Array.from({ length: 3 }, () => ({
+    angle: next() * Math.PI, frequency: 2 + next() * 7, phase: next() * Math.PI * 2, weight: 0.5 + next(),
+  }));
+  const center = { x: 0.15 + next() * 0.7, y: 0.15 + next() * 0.7 };
+  const ringFrequency = 9 + next() * 10;
+  const total = waves.reduce((sum, wave) => sum + wave.weight, 0);
+  return (x, y) => {
+    let value = 0;
+    for (const wave of waves) {
+      const along = x * Math.cos(wave.angle) + y * Math.sin(wave.angle);
+      value += wave.weight * Math.sin(along * wave.frequency * Math.PI + wave.phase);
+    }
+    value /= total;
+    if (kind === "rings") {
+      const distance = Math.hypot((x - center.x) * 1.0, y - center.y);
+      value = 0.6 * Math.sin(distance * ringFrequency * Math.PI) + 0.4 * value;
+    }
+    return (value + 1) / 2;
+  };
+}
+
+// Readings spread over `columns`, so 64 kept readings fit the grid's 40 columns.
+function resample(values, columns) {
+  if (!Array.isArray(values) || values.length < 2) return null;
+  return Array.from({ length: columns }, (_, column) => {
+    const at = (column / (columns - 1)) * (values.length - 1);
+    const low = Math.floor(at);
+    const high = Math.min(values.length - 1, low + 1);
+    const value = values[low] + (values[high] - values[low]) * (at - low);
+    return Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
+  });
+}
+
+// Made tracks are loud almost all the way through, so the band shows each track against its own
+// quietest and loudest stretch; the quietest still keeps a quarter of the height.
+function stretch(values) {
+  if (!values) return null;
+  const low = Math.min(...values);
+  const high = Math.max(...values);
+  const range = high - low;
+  return values.map((value) => 0.25 + 0.75 * (range >= 0.05 ? (value - low) / range : value));
+}
+
+// ── The readout ──────────────────────────────────────────────────────────────────────────────
+
+// A character takes two cells when it is wide, as CJK is.
+const wide = (character) => /[ᄀ-ᅟ⺀-꓏가-힣豈-﫿︰-﹏＀-｠￠-￦]|[\u{20000}-\u{3fffd}]/u.test(character);
+const cellsOf = (text) => [...text].reduce((sum, character) => sum + (wide(character) ? 2 : 1), 0);
+function fit(text, cells) {
+  if (cellsOf(text) <= cells) return text;
+  let out = "";
+  for (const character of text) {
+    if (cellsOf(`${out}${character}`) > cells - 1) break;
+    out += character;
+  }
+  return `${out}…`;
+}
+const clock = (seconds) => `${Math.floor(seconds / 60)}:${String(Math.round(seconds % 60)).padStart(2, "0")}`;
+
+function readout(receipt) {
+  const position = Number.isInteger(receipt?.stream?.position) ? receipt.stream.position : null;
+  const date = typeof receipt?.created_at === "string" ? receipt.created_at.slice(0, 10).replaceAll("-", ".") : "";
+  const featured = Array.isArray(receipt?.stream?.featured) && receipt.stream.featured.length ? receipt.stream.featured
+    : wordsOf(receipt).slice(0, 3).map(({ term }) => term);
+  const seconds = receipt?.audio?.duration_seconds ?? receipt?.generator?.seconds;
+  const bpm = Number.isInteger(receipt?.bpm) ? receipt.bpm : null;
+  const seed = Number.isInteger(receipt?.generator?.seed) ? receipt.generator.seed : null;
+  return {
+    left: "moondog",
+    right: position ? `on air #${String(position).padStart(2, "0")}` : date,
+    terms: featured.length ? fit(`// ${featured.join(", ")}`, COLUMNS) : "// made on this mac",
+    facts: fit([Number.isFinite(seconds) ? clock(seconds) : null, bpm ? `${bpm} bpm` : null, seed !== null ? `seed ${seed}` : null]
+      .filter(Boolean).join("  "), COLUMNS),
+  };
+}
+
+// ── Drawing ──────────────────────────────────────────────────────────────────────────────────
+
+const escape = (text) => text.replace(/[&<>"]/gu, (character) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[character]);
+const x = (column) => (MARGIN + (column + 0.5) * CELL_W).toFixed(1);
+const y = (row) => (MARGIN + (row + 0.78) * CELL_H).toFixed(1);
+
+/**
+ * The cover of one made track: { svg, lines, look }. `lines` is the same grid as plain text, for a
+ * terminal; `look` names the ramp, field and hue it chose. `loudness` overrides the receipt's own
+ * readings, for a track made before receipts kept them.
+ */
+export function drawCover(receipt, { loudness } = {}) {
+  const seed = (Number.isInteger(receipt?.generator?.seed) ? receipt.generator.seed : 0) ^ hash(receipt?.generated_track_id ?? receipt?.title ?? "");
+  const next = random(seed);
+  const words = wordsOf(receipt);
+  const ramp = bestMatch(RAMPS, words);
+  const glyphs = ramp?.ramp ?? DEFAULT_RAMP;
+  const tint = bestMatch(HUES, words);
+  const hue = (tint?.hue ?? Math.floor(next() * 360)) + (next() - 0.5) * 24;
+  const light = tint?.light === true;
+  const colours = light
+    ? { paper: hsl(hue, 34, 90), dim: hsl(hue, 16, 64), ink: hsl(hue, 24, 32), accent: hsl(hue, 70, 40) }
+    : { paper: hsl(hue, 26, 9), dim: hsl(hue, 16, 34), ink: hsl(hue, 18, 64), accent: hsl(hue, 72, 68) };
+  const field = backgroundField(next);
+  const band = stretch(resample(loudness ?? receipt?.audio?.loudness, COLUMNS));
+  // A little unevenness per column, so the band reads as a waveform rather than a block.
+  const jitter = Array.from({ length: COLUMNS }, () => 0.86 + next() * 0.28);
+
+  // Each cell holds a glyph and its tone: 0 dim, 1 ink, 2 accent.
+  const grid = Array.from({ length: ROWS }, () => Array.from({ length: COLUMNS }, () => ({ glyph: " ", tone: 1 })));
+  for (let row = 0; row < ART_ROWS; row += 1) {
+    for (let column = 0; column < COLUMNS; column += 1) {
+      const fx = column / (COLUMNS - 1);
+      const fy = row / (ART_ROWS - 1);
+      const behind = field(fx, fy);
+      // With a band, the field stays low so the band reads first; without one, the field is the cover.
+      let value = band ? Math.max(0, behind - 0.35) * 0.75 : Math.max(0, behind - 0.2) * 1.1;
+      let tone = band ? 0 : behind > 0.82 ? 2 : behind > 0.55 ? 1 : 0;
+      if (band) {
+        // The band is the track: tall where it is loud, mirrored about the middle row as a waveform is.
+        const half = 0.06 + band[column] * 0.36 * jitter[column];
+        const distance = Math.abs(fy - 0.5);
+        if (distance <= half) {
+          const depth = (1 - distance / half) ** 0.8;
+          value = Math.max(value, Math.min(1, 0.38 + 0.62 * depth + (behind - 0.5) * 0.4));
+          tone = distance <= half * 0.4 ? 2 : 1;
+        }
+      }
+      const index = Math.min(glyphs.length - 1, Math.floor(value * glyphs.length));
+      grid[ART_TOP + row][column] = { glyph: glyphs[index], tone };
+    }
+  }
+  const write = (row, text, column, tone) => {
+    let at = column;
+    for (const character of text) {
+      if (at >= COLUMNS) break;
+      grid[row][at] = { glyph: character, tone };
+      at += wide(character) ? 2 : 1;
+      if (wide(character) && at - 1 < COLUMNS) grid[row][at - 1] = { glyph: "", tone };
+    }
+  };
+  const info = readout(receipt);
+  write(0, info.left, 0, 1);
+  write(0, info.right, COLUMNS - cellsOf(info.right), 2);
+  write(ROWS - 2, info.terms, 0, 1);
+  write(ROWS - 1, info.facts, 0, 0);
+
+  // One text element per row and tone, each glyph at its own cell, so any monospace font keeps the grid.
+  const tones = [colours.dim, colours.ink, colours.accent];
+  const rows = grid.map((cells, row) => tones.map((fill, tone) => {
+    const placed = cells.map((cell, column) => ({ ...cell, column })).filter((cell) => cell.tone === tone && cell.glyph && cell.glyph !== " ");
+    if (!placed.length) return "";
+    return `<text y="${y(row)}" x="${placed.map((cell) => x(cell.column)).join(" ")}" fill="${fill}">${escape(placed.map((cell) => cell.glyph).join(""))}</text>`;
+  }).join("")).join("");
+  const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${SIZE}" height="${SIZE}" viewBox="0 0 ${SIZE} ${SIZE}">`
+    + `<rect width="${SIZE}" height="${SIZE}" fill="${colours.paper}"/>`
+    + `<g font-family="ui-monospace, 'SF Mono', Menlo, Consolas, 'DejaVu Sans Mono', monospace" font-size="19" font-weight="500" text-anchor="middle">${rows}</g></svg>`;
+  const lines = grid.map((cells) => cells.map((cell) => cell.glyph).join("").replace(/\s+$/u, ""));
+  return { svg, lines, look: { ramp: ramp?.name ?? "plain", hue: Math.round(((hue % 360) + 360) % 360), light, banded: Boolean(band), version: COVER_VERSION } };
+}
+
+/**
+ * The cover of the made track in `folder` as SVG text, or null when the folder holds no receipt.
+ * A track made before receipts kept its loudness is measured from its audio while it still has some.
+ */
+export async function trackFolderCover(folder) {
+  let receipt;
+  try {
+    receipt = JSON.parse(await readFile(path.join(folder, "receipt.json"), "utf8"));
+  } catch {
+    return null;
+  }
+  const loudness = Array.isArray(receipt?.audio?.loudness) ? null
+    : await readLoudness(path.join(folder, "track.wav")).catch(() => null);
+  return drawCover(receipt, loudness ? { loudness } : {}).svg;
+}