@ignix-social/editor 0.1.15 → 0.1.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ignix-social/editor",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Ignix Editor: render HTML video compositions (reels, edits, clips) on your own computer. Based on HyperFrames.",
   "license": "Apache-2.0",
   "type": "module",

package/skills/ignix-editor/SKILL.md

@@ -7,14 +7,15 @@ description: Build and render videos with Ignix Editor (HTML + GSAP compositions
 
 Ignix Editor turns an HTML page into an MP4. You write `index.html` (layout in HTML/CSS, motion in JS), the editor renders it frame by frame in a headless browser and encodes it with ffmpeg. The Ignix playbooks say WHAT to make; this skill says HOW to write it so that what you write is what renders.
 
-Commands (`npx @ignix-social/editor <cmd>` if `ignix-editor` is not on the PATH):
+Commands. `ignix-editor` means the copy the Ignix playbook installed: `~/.ignix-editor/cli/node_modules/.bin/ignix-editor` (Windows PowerShell: `& "$env:USERPROFILE\.ignix-editor\cli\node_modules\.bin\ignix-editor.cmd"`; PowerShell blocks `.ps1` scripts by default, so use the `.cmd` and `npm.cmd`, and `$env:USERPROFILE` instead of `~`). Do not use `npx`: it may fetch another version.
 
 | Command | What it does |
 |---|---|
 | `ignix-editor doctor` | Node 22+ and the H.264 encoder; downloads its own ffmpeg and whisper the first time. Run it first. |
 | `ignix-editor init <name>` | Creates `~/ignix-videos/<name>` with a working skeleton, GSAP, local fonts and `ignix-frame.js`. |
 | `ignix-editor transcribe <file> --lang es [--script "…"] -o words.json` | Words with start/end seconds, on this machine. |
-| `ignix-editor faces <video> -o work/faces.json` | Where the face is over time (macOS, Apple Vision): a smoothed path `{t, cx, cy, size}` (0–1, top-left origin) to frame the person. |
+| `ignix-editor faces <video> -o work/faces.json` | Where the face is over time (macOS and Windows; the first run downloads the face detector): a smoothed path `{t, cx, cy, size}` (0–1, top-left origin) to frame the person. |
+| `ignix-editor pick-audio [dir] --kind music\|sfx --query "inspiring" [--order trending]` | Music (or a specific sound effect) from Pixabay, chosen by the USER: opens Pixabay's search in their browser, waits for their download, copies it into `assets/` and notes its source in `work/audio-sources.json`. Tell the user first that you opened Pixabay for them to pick one. Never fetch pixabay.com yourself: it blocks robots. |
 | `ignix-editor check [dir]` | HTML well-formed, no network assets, media rules, layout/contrast/motion audit. |
 | `ignix-editor snapshot [dir] --at 0,1.5,3` | PNG frames into `<dir>/snapshots/` to LOOK at. `[dir]` defaults to the current folder. |
 | `ignix-editor render [dir] [-o out.mp4]` | Renders to `<dir>/renders/<dir>.mp4`, audio normalised to −14 LUFS. |

package/src/binaries.mjs

@@ -4,7 +4,7 @@
 // (descarga oficial de Google la primera vez).
 import { createHash } from 'node:crypto';
 import { chmodSync, createReadStream, createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
-import { Readable } from 'node:stream';
+import { Readable, Transform } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
@@ -75,9 +75,40 @@ export async function ensureWhisperModel(model = 'medium', log = () => {}) {
   if (existsSync(dest)) return dest;
   mkdirSync(dir, { recursive: true });
   log(`Downloading the ${model} transcription model (${(m.size / 1e9).toFixed(1)} GB, first time only)…`);
-  const res = await fetch(`https://huggingface.co/ggerganov/whisper.cpp/resolve/main/${m.file}`);
-  if (!res.ok) throw new Error(`Could not download the ${model} model: ${res.status}`);
-  await pipeline(Readable.fromWeb(res.body), createWriteStream(`${dest}.part`));
+  // Con avance y con freno (2026-10-07): en las pruebas de Windows esta descarga tardó 52 min
+  // sin decir nada, y un agente que no ve avance cree que se ha colgado y la corta. Se avisa
+  // cada 10 % y, si en 2 min no llega ni un byte, se para con un error claro.
+  const ctrl = new AbortController();
+  const STALL_MS = 120_000;
+  let stall = setTimeout(() => ctrl.abort(), STALL_MS);
+  let got = 0;
+  let next = 10;
+  const progress = new Transform({
+    transform(chunk, _enc, cb) {
+      clearTimeout(stall);
+      stall = setTimeout(() => ctrl.abort(), STALL_MS);
+      got += chunk.length;
+      const pct = Math.floor((got / m.size) * 100);
+      if (pct >= next && pct < 100) {
+        log(`  ${pct} % (${Math.round(got / 1e6)} of ${Math.round(m.size / 1e6)} MB)`);
+        next = Math.floor(pct / 10) * 10 + 10;
+      }
+      cb(null, chunk);
+    },
+  });
+  try {
+    const res = await fetch(`https://huggingface.co/ggerganov/whisper.cpp/resolve/main/${m.file}`, { signal: ctrl.signal });
+    if (!res.ok) throw new Error(`Could not download the ${model} model: ${res.status}`);
+    await pipeline(Readable.fromWeb(res.body), progress, createWriteStream(`${dest}.part`));
+  } catch (err) {
+    rmSync(`${dest}.part`, { force: true });
+    if (ctrl.signal.aborted) {
+      throw new Error(`The ${model} transcription model download stalled (no data for 2 minutes). Check the internet connection and run the command again; it starts over.`);
+    }
+    throw err;
+  } finally {
+    clearTimeout(stall);
+  }
   // El sha256 es el que publica Hugging Face para ese fichero (su oid de LFS).
   const h = createHash('sha256');
   await pipeline(createReadStream(`${dest}.part`), h);

package/src/cli.mjs

@@ -19,6 +19,7 @@ import { creatorJob } from './creator/job.mjs';
 import { fetchAll } from './fetch.mjs';
 import { measureStyle } from './analysis/style.mjs';
 import { reviewVideo } from './analysis/review.mjs';
+import { pickAudio } from './pick-audio.mjs';
 
 const PKG_DIR = join(dirname(fileURLToPath(import.meta.url)), '..');
 const PKG = JSON.parse(readFileSync(join(PKG_DIR, 'package.json'), 'utf8'));
@@ -223,6 +224,33 @@ const commands = {
     } else console.log(json);
   },
 
+  // Música o efectos de Pixabay elegidos por la persona (src/pick-audio.mjs): abre la
+  // búsqueda en su navegador, espera su descarga y la copia al proyecto.
+  async 'pick-audio'(argv) {
+    const { pos, opts } = parseArgs(argv, { kind: 'str', query: 'str', order: 'str', count: 'str', timeout: 'str', downloads: 'str', open: 'bool', json: 'bool' });
+    const project = resolve(pos[0] ?? '.');
+    const kind = opts.kind === 'sfx' ? 'sfx' : 'music';
+    if (!opts.query || !existsSync(project)) {
+      fail('Usage: ignix-editor pick-audio [folder] --kind music|sfx --query "inspiring" [--order trending|latest] [--count 1] [--timeout 600] [--no-open] [--downloads <folder>] [--json]');
+    }
+    const r = await pickAudio({
+      project,
+      kind,
+      query: opts.query,
+      order: opts.order,
+      count: Math.max(1, Math.min(10, Number(opts.count ?? 1) || 1)),
+      timeoutSec: Math.max(30, Number(opts.timeout ?? 600) || 600),
+      downloads: opts.downloads,
+      open: opts.open !== false,
+      log,
+    });
+    if (opts.json) console.log(JSON.stringify(r, null, 1));
+    if (r.timedOut) {
+      log(r.picked.length ? `Only ${r.picked.length} downloaded before the time ran out.` : 'Nothing was downloaded. Ask the person whether they found something, then run this again.');
+      process.exitCode = 2;
+    }
+  },
+
   // El estilo de edición de alguien, medido en 2–3 vídeos suyos (ADR-0023 E3).
   async style(argv) {
     const [sub, ...rest] = argv;
@@ -356,10 +384,12 @@ const commands = {
   ignix-editor check [folder]                  HTML, assets, layout, motion and contrast
   ignix-editor snapshot [folder] --at 0,2.5,5  single frames to look at (into <folder>/snapshots)
   ignix-editor render [folder] [-o out.mp4] [--lufs -14] [--no-normalize] [--no-review]
-  ignix-editor review <video.mp4> [--json]     is it ready to show? stillness, empty frame, voice gaps, cuts, sound effects
+  ignix-editor review <video.mp4> [--json]     is it ready to show? stillness, empty frame, voice gaps, cuts
   ignix-editor preview [folder]                live preview in the browser
   ignix-editor transcribe <file> [--lang es] [--script "text"] [-o words.json]
   ignix-editor faces <video> [--every 0.2] [-o faces.json]   where the face is, smoothed
+  ignix-editor pick-audio [folder] --kind music|sfx --query "inspiring" [--order trending]
+                                               opens the Pixabay search in the browser, waits for the person's download, copies it into assets/
   ignix-editor style measure <video>… [--speech] [--stills dir] [-o style.json]   someone's editing style, measured on 2–3 of their videos
   ignix-editor ffmpeg|ffprobe <args>           Ignix Editor's own ffmpeg
   ignix-editor skills add                      installs the skill for Claude

package/src/pick-audio.mjs

@@ -0,0 +1,152 @@
+import { spawn } from 'node:child_process';
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { basename, extname, join } from 'node:path';
+
+// MÚSICA Y EFECTOS DE PIXABAY, ELEGIDOS POR LA PERSONA (2026-10-08, idea de Fran).
+//
+// Pixabay no tiene API de audio y su web no deja entrar a robots (Cloudflare devuelve 403
+// a todo lo que no sea un navegador con una persona). Así que el agente NO busca ni
+// descarga: abre la búsqueda en el navegador de la persona, ella escucha los avances y
+// pulsa «Descargar» en el que le gusta, y esto lo recoge de su carpeta de Descargas y lo
+// copia al proyecto. La licencia de Pixabay permite usarlo en redes; guardamos de dónde
+// salió (nombre del fichero y búsqueda) porque es lo que Pixabay pide para responder a
+// una reclamación de Content ID en YouTube.
+
+const AUDIO = new Set(['.mp3', '.wav', '.m4a', '.ogg', '.aac', '.flac']);
+/** Descargas a medias de Chrome, Firefox, Safari y Edge. */
+const PARTIAL = /\.(crdownload|part|download|partial|tmp)$/i;
+
+/** La búsqueda de Pixabay, como la usa una persona en su web. */
+export function pixabayAudioUrl(kind, query, order) {
+  const base = kind === 'sfx' ? 'https://pixabay.com/sound-effects/search/' : 'https://pixabay.com/music/search/';
+  const q = encodeURIComponent(String(query ?? '').trim().replace(/\s+/g, ' ').slice(0, 80));
+  const o = order && ['trending', 'latest', 'ec'].includes(order) ? `?order=${order}` : '';
+  return `${base}${q}/${o}`;
+}
+
+/** La carpeta de Descargas de esta persona (la normal; `--downloads` para otra). */
+export function downloadsDir(override) {
+  if (override) return override;
+  return join(homedir(), 'Downloads');
+}
+
+/** Abre la URL en el navegador de la persona. false si no se pudo (sandbox, sin escritorio). */
+export function openInBrowser(url) {
+  try {
+    const os = platform();
+    const [cmd, args] =
+      os === 'darwin' ? ['open', [url]] : os === 'win32' ? ['cmd', ['/c', 'start', '""', url.replace(/&/g, '^&')]] : ['xdg-open', [url]];
+    const child = spawn(cmd, args, { detached: true, stdio: 'ignore', windowsHide: true });
+    child.on('error', () => {});
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** Ficheros de audio terminados que han aparecido en `dir` después de `since` (ms). */
+export function newAudioFiles(dir, since, seen = new Set()) {
+  let names = [];
+  try {
+    names = readdirSync(dir);
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const name of names) {
+    if (seen.has(name) || PARTIAL.test(name) || !AUDIO.has(extname(name).toLowerCase())) continue;
+    let st;
+    try {
+      st = statSync(join(dir, name));
+    } catch {
+      continue;
+    }
+    // birthtime no existe en todos los sistemas de ficheros: vale la última escritura.
+    const t = Math.max(st.mtimeMs, st.birthtimeMs || 0);
+    if (st.isFile() && st.size > 0 && t >= since) out.push({ name, path: join(dir, name), size: st.size });
+  }
+  return out;
+}
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+/** Espera a que el fichero deje de crecer (la descarga terminó de escribirse). */
+async function settled(path) {
+  let last = -1;
+  for (let i = 0; i < 20; i++) {
+    let size = -1;
+    try {
+      size = statSync(path).size;
+    } catch {
+      return false;
+    }
+    if (size > 0 && size === last) return true;
+    last = size;
+    await sleep(500);
+  }
+  return true;
+}
+
+const slug = (s) =>
+  s
+    .normalize('NFKD')
+    .replace(/[̀-ͯ]/g, '')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-|-$/g, '')
+    .slice(0, 60) || 'audio';
+
+/**
+ * Abre la búsqueda y espera a que la persona descargue `count` ficheros; los copia a
+ * `<project>/assets/` y apunta su origen en `<project>/work/audio-sources.json`.
+ */
+export async function pickAudio({ project, kind, query, order, count = 1, timeoutSec = 600, downloads, open = true, log = () => {} }) {
+  const url = pixabayAudioUrl(kind, query, order);
+  const dir = downloadsDir(downloads);
+  if (!existsSync(dir)) throw new Error(`Downloads folder not found: ${dir}. Pass --downloads <folder>.`);
+  const since = Date.now() - 1000;
+  const opened = open ? openInBrowser(url) : false;
+  log(opened ? `Opened in the browser: ${url}` : `Open this in the browser: ${url}`);
+  log(`Waiting for ${count === 1 ? 'a download' : `${count} downloads`} in ${dir} (up to ${Math.round(timeoutSec / 60)} min)…`);
+
+  const seen = new Set();
+  const picked = [];
+  const deadline = Date.now() + timeoutSec * 1000;
+  while (picked.length < count && Date.now() < deadline) {
+    for (const f of newAudioFiles(dir, since, seen)) {
+      seen.add(f.name);
+      if (!(await settled(f.path))) continue;
+      const assets = join(project, 'assets');
+      mkdirSync(assets, { recursive: true });
+      const ext = extname(f.name).toLowerCase();
+      let dest = join(assets, `${kind === 'sfx' ? 'sfx' : 'music'}-${slug(basename(f.name, ext))}${ext}`);
+      for (let n = 2; existsSync(dest); n++) dest = join(assets, `${kind === 'sfx' ? 'sfx' : 'music'}-${slug(basename(f.name, ext))}-${n}${ext}`);
+      copyFileSync(f.path, dest);
+      picked.push({ file: dest, originalName: f.name, bytes: f.size });
+      log(`✓ Got ${f.name} → ${dest}`);
+      if (picked.length >= count) break;
+    }
+    if (picked.length < count) await sleep(1000);
+  }
+
+  // De dónde salió cada uno: Pixabay pide conservarlo para disputar un Content ID.
+  if (picked.length) {
+    const work = join(project, 'work');
+    mkdirSync(work, { recursive: true });
+    const file = join(work, 'audio-sources.json');
+    let prev = [];
+    try {
+      prev = JSON.parse(readFileSync(file, 'utf8'));
+    } catch {
+      /* primera vez */
+    }
+    const now = new Date().toISOString();
+    writeFileSync(
+      file,
+      JSON.stringify([...prev, ...picked.map((p) => ({ source: 'pixabay', kind, search: url, originalName: p.originalName, file: p.file, downloadedAt: now }))], null, 2),
+    );
+  }
+  return { url, opened, picked, timedOut: picked.length < count };
+}