git404hub

what is topic-material-collector fr?

macong0420/topic-material-collector — explained in plain English

Analysis updated 2026-05-18

19PythonAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

tl;dr

A Codex skill that researches, downloads, and organizes video clips for a topic, tracking sources and copyright risk for each piece.

vibe map

mindmap
  root((Material Collector))
    What it does
      Searches YouTube
      Finds timestamps
      Downloads clips
      Builds manifests
    Tech stack
      Python
      yt-dlp
      FFmpeg
    Requirements
      Python 3.10 plus
      Codex skill format
    Safety
      No DRM bypass
      Risk labeled clips
      Not copyright clearance
    Use cases
      Video explainer research
      B-roll gathering

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automatically gather relevant video clips and images for a script or narration you already wrote.

VIBE 2

Research a topic on YouTube and get a catalog of candidate clips before downloading anything.

VIBE 3

Build a traceable material manifest with source, timestamp, and copyright risk for each clip.

VIBE 4

Assemble B-roll footage for a video explainer about a person or event.

what's the stack?

Pythonyt-dlpFFmpeg

how it stacks up fr

macong0420/topic-material-collector16nic/comfyui-agnes-ai6c696e68/gpt_signup_hybrid
Stars191919
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/52/54/5
Audiencevibe codervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Needs Python, yt-dlp, ffmpeg, and a Codex-compatible agent environment installed first.

MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

in plain english

Topic Material Collector is an open source skill for the Codex agent environment that helps someone gather video material for a topic, script, narration, or shot list. You give it a subject, and it searches YouTube first, looks at subtitles and creator chapters to find the exact time ranges that are relevant, then downloads either full videos or just the clipped portions you need. It can also pull in reviewed candidate videos and images from other platforms, rename everything consistently, and write out a manifest of what it collected in Markdown, CSV, and JSON formats. That manifest tracks where each clip came from, who made it, its timestamps, how confident the tool is that it found the right moment, license information, and a label describing how risky it would be to reuse. To run it, you need Python 3.10 or newer, the yt-dlp download tool, ffmpeg and ffprobe for handling video, and either Codex or another agent environment that supports the SKILL.md format the project uses. Installation means cloning the repository and copying its skill folder into your Codex skills directory, after which you can invoke it inside Codex with a command like asking it to collect footage about a specific person or event, or to find supporting clips for a narration script you already have. There are also standalone Python scripts you can run directly outside of Codex to search YouTube, build a catalog of candidates without downloading anything, or download from a manually reviewed list of candidates. The README is explicit that broad searching does not mean covering every page on the internet, and that downloading a video or image does not grant permission to publish it. It also states plainly that the tool does not bypass DRM, paywalls, logins, region restrictions, or watermarks. Collected material gets labeled low, medium, or high risk depending on whether it is clearly public domain or openly licensed, has unclear reuse rights, or looks like protected content such as films or paid news. The project describes itself as a research and organizing tool, not a source of copyright clearance, and tells users to verify rights before using anything publicly or commercially. It is released under the MIT license.

prompts (copy fr)

prompt 1
Help me install this Codex skill and set up yt-dlp and ffmpeg on my system.
prompt 2
Use topic-material-collector to gather clips for a 10 minute explainer about a given topic.
prompt 3
Explain the difference between clips mode and catalog mode in this tool's scripts.
prompt 4
Show me the format of the candidate-schema.md file used for manual review lists.

Frequently asked questions

what is topic-material-collector fr?

A Codex skill that researches, downloads, and organizes video clips for a topic, tracking sources and copyright risk for each piece.

What language is topic-material-collector written in?

Mainly Python. The stack also includes Python, yt-dlp, FFmpeg.

What license does topic-material-collector use?

MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

How hard is topic-material-collector to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is topic-material-collector for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.