Repository navigation
B roll
The b-roll library (#229) keeps short clips that are free to use, for story cuts, explainers and the weekly issue: footage made by the US government has no copyright, the Internet Archive and Wikimedia Commons state each item's licence, and Pixabay's own licence allows commercial use without a credit. Each clip keeps where it came from, its credit line and its licence. Still pictures (engravings, drawings, emoji, icons) are in the clip art library.
-
nasa: the NASA Image and Video Library (images.nasa.gov): space, Earth from orbit, storms, archive film. No key. -
dvids: the Defense Visual Information Distribution Service (dvidshub.net), the armed forces' own video: aircraft, ships, training, disaster relief. Only its B-Roll category is searched (footage without narration;[broll] dvids_category,""for all of it). It needs a free key: register at dvidshub.net and copy the API keys from your account intosecrets/dvids_secret.txt([paths] dvids_key), the public key on the first line and the private one on the second, or setDVIDS_API_KEYto the public key. Only the public key is used, and it is never written tobroll.jsonor printed. Without a key, DVIDS is skipped. -
prelinger: the Internet Archive's Prelinger films: ads, industrial and educational films from the 1930s to the 1970s. No key. -
commons: Wikimedia Commons video, a lot of it government footage already. No key. -
pixabay: Pixabay's stock video (city streets, buildings, nature, everyday objects) under the Pixabay Content License. Only live footage is searched ([broll] pixabay_type = "film";"animation"or""for both), with safe search on. It needs a free key, the same one clip art uses: sign up at pixabay.com, copy your key from pixabay.com/api/docs intosecrets/pixabay_secret.txt([paths] pixabay_key), or setPIXABAY_API_KEY. The key is never written tobroll.jsonor printed, and each search's answer is kept for 24 hours in.pixabay_cache.json, as Pixabay's API terms ask. Without a key, Pixabay is skipped.
The National Archives needs a key from NARA and comes later (#229).
-
clippa broll find "hurricane from orbit": searches every source in[broll] sourcesand adds up to[broll] per_sourcenew clips from each, tagged with the search.--source nasasearches one source. -
clippa broll list [--tag storm] [--status new|kept|long] [--json]: the library, newest first.--jsonadds each file's path, which you can import into Resolve. -
clippa broll add <address|id|file> [--from 0:01:20 --to 0:01:45] [--tag X]: one clip, from an images.nasa.gov/details, dvidshub.net/video, archive.org/details, pixabay.com/videos or CommonsFile:page. With a library id it takes a part of that clip. A video file you downloaded yourself needs--credit "U.S. Navy video by ...". -
clippa broll keep|drop <id> ...: a dropped clip's file is deleted, and the next find doesn't bring its source back.
Times read as everywhere else: 0:01:20 (H:MM:SS), 1m20s, or seconds. 1:20 means one
hour and twenty minutes.
Clips up to [broll] max_s (3 minutes) are downloaded whole and re-encoded to at most
[broll] max_height. A longer one, like most Prelinger films, is listed as long with no
file; add <id> --from --to takes the part you want. Raise max_s and a long clip that now
fits is downloaded whole: by the next find that returns it, or by add <id> with no times.
The files and broll.json are in [paths] broll.
A clip is kept only when its licence is in [broll] licences (pd, public domain, cc0
and pixabay by default) and nothing in its title, description or credit names an outside owner
(©, "copyright", "all rights reserved", Getty, AP, Reuters ...). Anything else is skipped,
and the reason is printed. Adding cc-by keeps attribution-licensed clips too, but then every
video that uses one must credit its author. A noncommercial or no-derivatives clause (NC, ND)
is never kept, whatever else the licence says, even "public domain, non-commercial use only".
- Credits. Put the clip's credit line in the description of any video that uses it.
-
Sound. Clips have no sound unless
[broll] audio = true. NASA videos often carry licensed music; with the sound on, a NASA clip whose credits mention music is skipped. - No endorsement. Nothing may suggest an agency endorses us: no insignia or recognizable service member on a cover or as the subject of a title.
-
Pixabay's limits. Its licence needs no credit (the uploader's name is kept anyway), but it
bans selling a clip unaltered, using one that shows a brand or a logo commercially, and
showing a recognisable person in a bad light or as if they endorse something. On a channel
that mocks people, use Pixabay for places and things, never a stranger's face next to a
joke. Take
pixabayout oflicencesto stop keeping its clips.
State and foreign government footage (ESA, the EU, UK Parliament) has its own licences and isn't a source. Nor is C-SPAN, whose own camera footage is copyrighted.
[broll] in clippa/defaults.toml: sources, dvids_category, pixabay_type, per_source,
max_s, max_height, licences, audio, codec (empty uses [cut] clip_codec), crf,
timeout_s. clippa doctor checks the source and licence names and pixabay_type, warns when
DVIDS or Pixabay has no key, and counts the library.
Home · Getting started · clippa doctor · These pages are built from docs/wiki/ in the repo, so edits made here are overwritten: how to edit them
Run it
- Overview
- Getting started
- Roles and services
- Configuration
- Pipeline
- Review
- Reviewing
- War room
- Clippa messenger
- Scheduling and uploads
- Costs
- Checkup
- Audit
- Backups
Install
- Install
- Install checklist
- Kitsu
- Discord app
- YouTube sign-in
- Windows
- macOS
- Transcribe on Modal
- NAS recorder
- NAS hub
- Claude on the NAS
- Phone access
- Model providers
- Adding a show
- YouTube channel
Features
- Pre-shows
- Fetching VODs
- Speakers
- Faces
- Covers
- Cast library
- B-roll
- Clip art
- Weekly issue
- X posts
- TikTok
- News watcher
- Character pieces
- Documentaries
Research
Working on Clippa