--- name: archive-broll description: Find, preview, cut and credit archival B-roll from the Internet Archive (archive.org) for a Helios video — public-domain, CC BY and CC BY-SA film plus Prelinger Archives. Use when a Helios composition needs real footage as a plate, cutaway, masked fill or texture. Not for generating footage or editing the user's own camera video. --- # Archive B-roll The [Internet Archive](https://archive.org/developers/) holds millions of films: Prelinger Archives (industrial, educational, advertising), NASA, newsreels, home movies and Creative Commons uploads. No API key is needed. [`scripts/archive-broll.mjs`](scripts/archive-broll.mjs) (Node 18+, ffmpeg for `clip`) wraps three endpoints: | Command | Endpoint | Does | |---|---|---| | `search` | `advancedsearch.php` | Lists movie items with reusable rights | | `inspect` | `metadata/` | Picks the best MP4, saves thumbnails named by second offset | | `clip` | `download//` | Cuts only the seconds you need over HTTP, writes credits | ## 1. Search ```bash node /scripts/archive-broll.mjs search "factory assembly line" --rows 12 node /scripts/archive-broll.mjs search "city traffic" --collection prelinger --years 1945-1965 node /scripts/archive-broll.mjs search 'title:(rocket launch)' --collection nasa --json ``` Terms use Archive search syntax (`title:(...)`, `subject:(...)`, `AND`, `OR`); results are ranked by relevance (`--sort downloads` for popularity). Every result carries a rights label: | Label | Meaning | |---|---| | `public-domain` | Public-domain mark or CC0. Credit anyway. | | `cc-by` | Credit required. | | `cc-by-sa` | Credit required, and the finished video must use the same license. Tell the user before using it in a commercial video. | | `collection-policy` | No item license; the collection publishes a rights statement (Prelinger Archives). Credit the collection and link the statement. | Non-commercial, no-derivatives and unknown-rights items are left out. `--include-unknown` shows unknown items; use one only after the user confirms they hold the rights. Labels come from uploader metadata: they're a filter, not legal advice. Flag anything that looks like a commercial film, TV show or trademark-heavy footage even when it's labelled public domain. ## 2. Preview ```bash node /scripts/archive-broll.mjs inspect --out videos//broll --thumbs 16 ``` Writes `item.json` and thumbnails named by offset (`00450s.jpg` = 7:30 in). Open them with your image tool and pick start times. `--large` grabs sharper 640 px frames with ffmpeg when the archive's 160 px thumbnails aren't enough. ## 3. Cut ```bash node /scripts/archive-broll.mjs clip --start 450 --duration 3 \ --out videos//broll --name traffic-01.mp4 ``` Output is H.264, no audio (`--audio` keeps it), short keyframe interval so per-frame seeking stays cheap; `--width 1920` upscales. Cut about 0.5 s extra on each side for transitions. Each clip appends to `CREDITS.md` and `credits.json` in the output folder. ## 4. Use in the page The renderer seeks every `