YouTube Notetaker

Quando Usar

Use quando o seguinte fluxo de trabalho corresponder à solicitação do usuário: >

Fonte: dair-ai/dair-academy-plugins (MIT).

Crie uma biblioteca pessoal de vídeos do YouTube que você estuda. Cada vídeo se torna um arquivo markdown simples: instantâneos de slides em seus carimbos de data/hora, uma transcrição completa com carimbos de data/hora e notas editáveis. Um pequeno servidor agrupado renderiza a biblioteca como um mergulho profundo interativo no navegador. Sem banco de dados, sem serviço em nuvem. Tudo são arquivos em disco que você possui totalmente.

Arquitetura (leia isso primeiro)

A biblioteca markdown é a única fonte de verdade. O artefato é um invólucro HTML fino que busca do servidor e grava notas de volta. Nunca codifique dados de vídeo no HTML.

• Biblioteca: uma pasta simples, definida por VIDEO_LIBRARY_DIR (padrão ~/video-deepdives/).
  • Um arquivo markdown por vídeo, nome do arquivo slug = ID do YouTube (por exemplo, RtywqDFBYnQ.md).
  • Frontmatter contém metadados do vídeo + um array slides.
  • O corpo contém a transcrição completa como linhas [HH:MM:SS] text.
  • _media/ contém imagens de slides, nomeadas por vídeo como <youtube_id>-slide-NN.jpg para evitar conflitos entre vídeos.
• Servidor: scripts/serve.py, um único arquivo stdlib + PyYAML. Inicie-o com:

  python3 scripts/serve.py --dir ~/video-deepdives --port 8000
  

  Ele serve o artefato em / e uma pequena API com a qual o artefato interage:
  • GET /api/video-deepdives (a página inicial busca isso) lista todos os vídeos.
  • GET /api/video-deepdives/<id> retorna um vídeo {meta, body}.
  • GET /api/video-deepdives/_media/<file> serve uma imagem de slide.
  • PATCH /api/video-deepdives/<id> com {fields:{slides:[...]}} grava notas de volta.
  • Ele detecta novos vídeos automaticamente no momento em que um arquivo markdown existe. Adicionar um vídeo significa escrever um arquivo markdown + mídia; você quase nunca mexe no HTML.
  • O namespace de URL /api/video-deepdives é local para o servidor agrupado.
• Artefato: reference/artifact.html, servido por serve.py em /. Uma cópia de referência limpa; reescreva-o apenas se o usuário desejar uma alteração na interface. Para novos vídeos, deixe-o como está.

Requisitos

• yt-dlp e ffmpeg no PATH (extração de download + frame/cena).
• Python 3 com Pillow (folha de contato) e PyYAML (arquivo markdown + servidor).

  pip install yt-dlp pillow pyyaml      # ffmpeg via your package manager
  

Adicionando um vídeo — o pipeline

Todos os scripts auxiliares estão em scripts/. setup.sh cria um diretório temporário privado e imprevisível; copie o caminho SCRATCH impresso para uma variável de shell, em seguida, copie os ativos finais para a biblioteca. Defina VIDEO_LIBRARY_DIR uma vez por shell se você não quiser o padrão. Não use travessões (—) ou setas (→) em notas/títulos.

1. Resolva o ID e verifique a incorporação

bash scripts/setup.sh "<youtube_url_or_id>"

Imprime o YTID de 11 caracteres, o diretório temporário, o caminho de destino da biblioteca e se a incorporação do YouTube é permitida (oembed 200) ou bloqueada (oembed 401, por exemplo, algumas palestras universitárias). Se bloqueado, a reprodução inline não funcionará, mas o artefato se degradará graciosamente para um link "abrir neste momento no YouTube", então prossiga normalmente.

Copie o caminho imprevisível exato impresso pelo comando antes de continuar:

SCRATCH="/path/printed/by/setup.sh"

2. Baixe o vídeo + legendas

bash scripts/download.sh "<YTID>" "$SCRATCH"

Usa yt-dlp para obter o vídeo (≤720p é suficiente para quadros de slides) e as melhores legendas disponíveis (manuais, se presentes, caso contrário, legendas automáticas) como .vtt. Também busca título/uploader.

3. Detecte carimbos de data/hora de slides candidatos

bash scripts/detect_slides.sh "$SCRATCH/video.mp4" "$SCRATCH"

Executa a detecção de cena do ffmpeg (select='gt(scene,0.3)') e grava scene_times.txt (segundos). 0.3 é um bom padrão; diminua-o (0.2) para apresentações de slides sutis, aumente-o (0.4) para vídeos movimentados.

4. Crie uma folha de contato e CURATE

python3 scripts/contact_sheet.py "$SCRATCH/video.mp4" "$SCRATCH/scene_times.txt" "$SCRATCH/contact.jpg"

Leia contact.jpg (rotulado com índice + carimbo de data/hora). Esta é a etapa de julgamento humano: mantenha quadros que são slides de conteúdo real; descarte tomadas de cabeça falante, transições, duplicatas e quadros em meio a animação borrados. Salve os carimbos de data/hora mantidos (segundos) em $SCRATCH/keep.txt, um por linha. Uma palestra típica gera 15-25 slides.

5. Extraia os slides selecionados com qualidade total e instale em _media