Skip to content

JaimeJunr/claude-code-frontend-skills / plugins/hyperframes/skills/media-use

media-use

Verified

Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.

FileKindSize
.gitignoreother17 B
SKILL.mdskill md5.3 KB
audio/assets/sfx/CREDITS.mdmarkdown1.2 KB
audio/assets/sfx/chime.mp3binary26.7 KB
audio/assets/sfx/click-soft.mp3binary11.4 KB
audio/assets/sfx/click.mp3binary11.4 KB
audio/assets/sfx/error.mp3binary50.6 KB
audio/assets/sfx/glitch-1.mp3binary82.4 KB
audio/assets/sfx/glitch-2.mp3binary109.5 KB
audio/assets/sfx/glitch-3.mp3binary96.8 KB
audio/assets/sfx/impact-bass-1.mp3binary66.1 KB
audio/assets/sfx/impact-bass-2.mp3binary81.0 KB
audio/assets/sfx/key-press.mp3binary3.8 KB
audio/assets/sfx/manifest.jsonconfig3.6 KB
audio/assets/sfx/notification.mp3binary76.7 KB
audio/assets/sfx/ping.mp3binary25.8 KB
audio/assets/sfx/pop.mp3binary22.5 KB
audio/assets/sfx/riser.mp3binary313.5 KB
audio/assets/sfx/sparkle.mp3binary56.3 KB
audio/assets/sfx/typing.mp3binary26.2 KB
audio/assets/sfx/whoosh-cinematic.mp3binary173.3 KB
audio/assets/sfx/whoosh-short.mp3binary18.0 KB
audio/assets/sfx/whoosh.mp3binary18.0 KB
audio/references/bgm.mdmarkdown7.9 KB
audio/references/captions/authoring.mdmarkdown9.2 KB
audio/references/captions/motion.mdmarkdown5.4 KB
audio/references/captions/transcript-handling.mdmarkdown5.3 KB
audio/references/remove-background.mdmarkdown8.3 KB
audio/references/requirements.mdmarkdown4.7 KB
audio/references/sfx.mdmarkdown4.0 KB
audio/references/transcribe.mdmarkdown2.8 KB
audio/references/tts-to-captions.mdmarkdown1.7 KB
audio/references/tts.mdmarkdown13.9 KB
audio/scripts/audio.mjsscript15.2 KB
audio/scripts/audio.test.mjsscript8.4 KB
audio/scripts/carve.mjsscript20.1 KB
audio/scripts/carve.test.mjsscript12.2 KB
audio/scripts/extract-audio-data.pyscript7.1 KB
audio/scripts/gemini-pipeline.test.mjsscript4.8 KB
audio/scripts/heygen-tts.mjsexecutablescript4.3 KB
audio/scripts/heygen-tts.test.mjsscript1.4 KB
audio/scripts/heygen-voice.mjsscript3.8 KB
audio/scripts/heygen-voice.test.mjsscript8.3 KB
audio/scripts/lib/audio-carve.mjsscript16.6 KB
audio/scripts/lib/audio-meta.mjsscript1.1 KB
audio/scripts/lib/audio-meta.test.mjsscript4.5 KB
audio/scripts/lib/bgm-volume.mjsscript236 B
audio/scripts/lib/bgm.mjsscript11.5 KB
audio/scripts/lib/bgm.test.mjsscript4.7 KB
audio/scripts/lib/concurrency.mjsscript527 B
audio/scripts/lib/concurrency.test.mjsscript1.6 KB
audio/scripts/lib/gemini-auth.mjsscript1.6 KB
audio/scripts/lib/gemini-auth.pyscript1.9 KB
audio/scripts/lib/gemini-auth.test.mjsscript3.0 KB
audio/scripts/lib/gemini-auth_test.pyscript4.3 KB
audio/scripts/lib/gemini-tts.mjsscript5.0 KB
audio/scripts/lib/gemini-tts.test.mjsscript9.2 KB
audio/scripts/lib/heygen.mjsscript14.3 KB
audio/scripts/lib/heygen.test.mjsscript22.9 KB
audio/scripts/lib/main-module.mjsscript479 B
audio/scripts/lib/media-record.mjsscript5.1 KB
audio/scripts/lib/media-record.test.mjsscript12.6 KB
audio/scripts/lib/openverse.mjsscript4.9 KB
audio/scripts/lib/project-path.mjsscript2.2 KB
audio/scripts/lib/project-path.test.mjsscript3.0 KB
audio/scripts/lib/python.mjsscript4.6 KB
audio/scripts/lib/python.test.mjsscript7.8 KB
audio/scripts/lib/recording.mjsscript4.4 KB
audio/scripts/lib/sfx.mjsscript7.2 KB
audio/scripts/lib/sfx.test.mjsscript11.6 KB
audio/scripts/lib/tts.cleanup.test.mjsscript7.0 KB
audio/scripts/lib/tts.mjsscript18.6 KB
audio/scripts/lib/tts.spawn.test.mjsscript6.0 KB
audio/scripts/lib/tts.test.mjsscript10.2 KB
audio/scripts/lib/voice-credit.mjsscript686 B
audio/scripts/lib/voice-credit.test.mjsscript946 B
audio/scripts/lyria-recipe.pyscript4.9 KB
audio/scripts/recording.test.mjsscript9.2 KB
audio/scripts/trusted-program.test.mjsscript3.4 KB
audio/scripts/trusted_program.pyscript2.8 KB
audio/scripts/wait-bgm.mjsscript6.1 KB
audio/scripts/wait-bgm.test.mjsscript8.0 KB
luts/README.mdmarkdown1.1 KB
luts/index.jsonconfig2.0 KB
references/audio.mdmarkdown3.5 KB
references/grading.mdmarkdown7.0 KB
references/heygen.mdmarkdown11.8 KB
references/local.mdmarkdown2.6 KB
references/media-treatment-recipes.mdmarkdown35.0 KB
references/media-treatments.mdmarkdown13.8 KB
references/memory.mdmarkdown3.7 KB
references/meta.mdmarkdown6.4 KB
references/mixing.mdmarkdown4.5 KB
references/operations.mdmarkdown15.8 KB
references/resolve.mdmarkdown9.9 KB
references/setup-providers.mdmarkdown9.1 KB
references/telemetry-dashboard.mdmarkdown4.1 KB
scripts/audio-duck.mjsscript4.0 KB
scripts/compatibility.test.mjsscript1.6 KB
scripts/dither.mjsscript9.8 KB
scripts/dither.test.mjsscript4.6 KB
scripts/eval.mjsscript14.6 KB
scripts/lib/config-lock.mjsscript1.5 KB
scripts/lib/credit-limit.mjsscript2.0 KB
scripts/lib/cutlist.mjsscript6.2 KB
scripts/lib/duck.mjsscript3.8 KB
scripts/lib/error-diffusion.mjsscript6.5 KB
scripts/lib/index-gen.mjsscript2.0 KB
scripts/lib/manifest.mjsscript10.6 KB
scripts/lib/media-fetch.mjsscript2.8 KB
scripts/lib/media-home.mjsscript730 B
scripts/lib/npx-sync.mjsscript3.2 KB
scripts/lib/parakeet-words.mjsscript1.1 KB
scripts/lib/prefs-store.mjsscript6.8 KB
scripts/lib/recipe-store.mjsscript13.0 KB
scripts/lib/telemetry.mjsscript8.8 KB
scripts/lib/telemetry.test.mjsscript3.0 KB
scripts/lib/transcriptCutFade.mjsscript911 B
scripts/lib/windows-exe-search.mjsscript640 B
scripts/lib/words.mjsscript728 B
scripts/prefs.mjsscript2.3 KB
scripts/recipe.mjsscript3.8 KB
scripts/resolve-plugin.test.mjsscript3.2 KB
scripts/resolve.mjsscript1.4 KB
scripts/transcribe.mjsscript8.0 KB
scripts/transcribe.test.mjsscript7.7 KB
scripts/transcript-cut.mjsscript10.1 KB
scripts/transcript-cut.test.mjsscript9.6 KB

audio/scripts/wait-bgm.test.mjs

View on GitHub
import assert from "node:assert/strict";
import {
  existsSync,
  lstatSync,
  mkdirSync,
  mkdtempSync,
  readFileSync,
  rmSync,
  symlinkSync,
  writeFileSync,
} from "node:fs";
import { spawnSync } from "node:child_process";
import { join } from "node:path";
import { tmpdir } from "node:os";
import { test } from "node:test";
import { runInNewContext } from "node:vm";

const source = readFileSync(new URL("./wait-bgm.mjs", import.meta.url), "utf8");
const start = source.indexOf("function readTail(");
const end = source.indexOf("\nfunction detectFailure(", start);
function load(read) {
  return runInNewContext(`${source.slice(start, end)}; readTail`, {
    readFileSync: read,
    existsSync: () => true,
    statSync: () => {
      throw new Error("pathname stat must not precede log read");
    },
  });
}

test("reads a log once without a separate pathname check", () => {
  let calls = 0;
  const read = load((path, encoding) => {
    calls++;
    assert.equal(path, "renderer.log");
    assert.equal(encoding, "utf8");
    return "prefix\nRuntimeError: failed";
  });
  assert.equal(read("renderer.log", 20), "RuntimeError: failed");
  assert.equal(calls, 1);
});

test("preserves UTF-16 character tail boundaries and zero-length tails", () => {
  const txt = "🎵日本語".repeat(2000);
  const read = load(() => txt);
  assert.equal(read("log"), txt.slice(-6000));
  assert.equal(read("log", 0), "");
});

for (const code of ["ENOENT", "ENOTDIR"]) {
  test(`a log removed during polling is absent (${code})`, () => {
    const read = load(() => {
      throw Object.assign(new Error(code), { code });
    });
    assert.equal(read("log"), "");
  });
}

test("preserves unexpected read errors", () => {
  const error = Object.assign(new Error("denied"), { code: "EACCES" });
  assert.throws(
    () =>
      load(() => {
        throw error;
      })("log"),
    (caught) => caught === error,
  );
});

test("empty log path does not access the filesystem", () => {
  assert.equal(
    load(() => {
      throw new Error("unexpected read");
    })(""),
    "",
  );
});

test("records locally made music as generated once it is ready", () => {
  const dir = mkdtempSync(join(tmpdir(), "mu-wait-bgm-"));
  try {
    mkdirSync(join(dir, "assets/bgm"), { recursive: true });
    writeFileSync(join(dir, "assets/bgm/track.wav"), "generated music");
    writeFileSync(
      join(dir, "audio_meta.json"),
      JSON.stringify({
        bgm: { path: "assets/bgm/track.wav" },
        bgm_pending: true,
        bgm_provider: "musicgen",
        bgm_mode: "detached-single",
      }),
    );
    const script = new URL("./wait-bgm.mjs", import.meta.url).pathname;
    const args = ["--audio-meta", join(dir, "audio_meta.json"), "--hyperframes", dir];

    const run = spawnSync(process.execPath, [script, ...args, "--timeout-ms", "1000"], {
      encoding: "utf8",
    });

    assert.equal(run.status, 0, run.stderr);
    const records = readFileSync(join(dir, ".media/manifest.jsonl"), "utf8")
      .trim()
      .split("\n")
      .map((line) => JSON.parse(line));
    assert.deepEqual(
      records.map(({ path, type, source, provenance }) => [
        path,
        type,
        source,
        provenance.provider,
      ]),
      [["assets/bgm/track.wav", "bgm", "generated", "musicgen"]],
    );
  } finally {
    rmSync(dir, { recursive: true, force: true });
  }
});

// A finished-but-missing track with no live renderer, so wait-bgm reports on the log at once.
function waitWithLog(bgmLog, files = {}) {
  const base = mkdtempSync(join(tmpdir(), "mu-wait-bgm-"));
  const dir = join(base, "project");
  mkdirSync(join(dir, "assets/bgm"), { recursive: true });
  writeFileSync(join(base, "secret.txt"), "Traceback: SECRET-TOKEN-123");
  for (const [rel, make] of Object.entries(files)) make(join(dir, rel), base);
  writeFileSync(
    join(dir, "audio_meta.json"),
    JSON.stringify({
      bgm: { path: "assets/bgm/track.wav" },
      bgm_pending: true,
      bgm_pid: null,
      bgm_log: bgmLog(dir, base),
    }),
  );
  const script = new URL("./wait-bgm.mjs", import.meta.url).pathname;
  const run = spawnSync(
    process.execPath,
    [
      script,
      "--audio-meta",
      join(dir, "audio_meta.json"),
      "--hyperframes",
      dir,
      "--timeout-ms",
      "0",
    ],
    { encoding: "utf8", env: { ...process.env, HOME: base } },
  );
  try {
    assert.equal(run.status, 0, run.stderr);
    return readFileSync(join(dir, "bgm_status.json"), "utf8");
  } finally {
    rmSync(base, { recursive: true, force: true });
  }
}

for (const [label, bgmLog, files] of [
  ["an absolute path outside the project", (_dir, base) => join(base, "secret.txt")],
  ["a path that climbs out of the project", () => "../secret.txt"],
  [
    "a link in assets/bgm under the engine's log name",
    () => "assets/bgm/bgm-1.log",
    { "assets/bgm/bgm-1.log": (at, base) => symlinkSync(join(base, "secret.txt"), at) },
  ],
]) {
  test(`a bgm_log at ${label} is never read into bgm_status.json`, () => {
    const status = waitWithLog(bgmLog, files);
    assert.doesNotMatch(status, /SECRET-TOKEN/);
    const parsed = JSON.parse(status);
    assert.equal(parsed.log, null);
    assert.equal(parsed.error_tail, undefined);
    assert.equal(parsed.status, "timeout");
    assert.equal(parsed.log_tail, "");
  });
}

test("the engine's own crashed renderer log still reports the failure", () => {
  const status = JSON.parse(
    waitWithLog((dir) => join(dir, "assets/bgm/bgm-1700000000000.log"), {
      "assets/bgm/bgm-1700000000000.log": (at) =>
        writeFileSync(at, "loading model\nRuntimeError: CUDA out of memory\n"),
    }),
  );
  assert.equal(status.status, "failed");
  assert.match(status.error_tail, /^RuntimeError: CUDA out of memory/);
});

function runWait(dir, meta) {
  writeFileSync(join(dir, "audio_meta.json"), JSON.stringify(meta));
  const script = new URL("./wait-bgm.mjs", import.meta.url).pathname;
  const run = spawnSync(
    process.execPath,
    [
      script,
      "--audio-meta",
      join(dir, "audio_meta.json"),
      "--hyperframes",
      dir,
      "--timeout-ms",
      "0",
    ],
    { encoding: "utf8" },
  );
  assert.equal(run.status, 0, run.stderr);
}

test("a link planted at bgm_status.json is replaced, and the file it named is untouched", () => {
  const base = mkdtempSync(join(tmpdir(), "mu-wait-bgm-"));
  const dir = join(base, "project");
  try {
    mkdirSync(dir);
    writeFileSync(join(base, "theirs.txt"), "theirs");
    symlinkSync(join(base, "theirs.txt"), join(dir, "bgm_status.json"));
    runWait(dir, { bgm: null });
    assert.equal(readFileSync(join(base, "theirs.txt"), "utf8"), "theirs");
    assert.equal(lstatSync(join(dir, "bgm_status.json")).isSymbolicLink(), false);
    assert.equal(JSON.parse(readFileSync(join(dir, "bgm_status.json"), "utf8")).status, "disabled");
  } finally {
    rmSync(base, { recursive: true, force: true });
  }
});

test("a track path outside the project is never reported ready or recorded", () => {
  const base = mkdtempSync(join(tmpdir(), "mu-wait-bgm-"));
  const dir = join(base, "project");
  try {
    mkdirSync(dir);
    writeFileSync(join(base, "theirs.wav"), "not ours");
    runWait(dir, { bgm: { path: "../theirs.wav" }, bgm_pending: true, bgm_provider: "musicgen" });
    const status = JSON.parse(readFileSync(join(dir, "bgm_status.json"), "utf8"));
    assert.equal(status.ready, false);
    assert.equal(status.path, null);
    assert.equal(existsSync(join(dir, ".media/manifest.jsonl")), false);
  } finally {
    rmSync(base, { recursive: true, force: true });
  }
});

test("a pid whose log is not the engine's own is dropped with the log", () => {
  const dir = mkdtempSync(join(tmpdir(), "mu-wait-bgm-"));
  try {
    mkdirSync(join(dir, "assets/bgm"), { recursive: true });
    runWait(dir, {
      bgm: { path: "assets/bgm/track.wav" },
      bgm_pending: true,
      bgm_pid: process.pid,
      bgm_log: "/etc/hosts",
    });
    const status = JSON.parse(readFileSync(join(dir, "bgm_status.json"), "utf8"));
    assert.equal(status.pid, null);
    assert.equal(status.process_alive, false);
  } finally {
    rmSync(dir, { recursive: true, force: true });
  }
});
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall