VideoToObsidian

VideoToObsidian

Flujo completo de captura de cualquier vídeo de YouTube a una nota técnica lista para el Second Brain en Obsidian. Combina descarga automática de metadatos + transcripción con análisis inteligente del contenido para generar el documento adecuado al tipo de vídeo.

Depende de: skill TranscribeYoutube (debe estar instalado en el directorio hermano)

Cuándo usar este skill

• El usuario da una URL de YouTube y quiere una nota técnica completa
• El usuario dice "captura esto a Obsidian", "crea nota de este vídeo", "VideoToObsidian"
• El usuario quiere documentar un tutorial, concepto o demo de YouTube en su vault
• El usuario comparte un link y dice "quiero aprenderlo bien"

Requisitos

• Python 3.9+ — solo stdlib
• Skill TranscribeYoutube instalado en ~/.copilot/skills/TranscribeYoutube/
• El vídeo debe tener subtítulos disponibles (automáticos o manuales)
• Variable OBSIDIAN_VAULT (opcional, por defecto usa el vault Luna)

Comando a ejecutar

python3 ~/.copilot/skills/VideoToObsidian/scripts/video_to_obsidian.py <URL>

El script emite el JSON por stdout. Capturarlo así:

JSON=$(python3 ~/.copilot/skills/VideoToObsidian/scripts/video_to_obsidian.py <URL>)

Flujo completo paso a paso

Paso 1 — Ejecutar el script

python3 ~/.copilot/skills/VideoToObsidian/scripts/video_to_obsidian.py <URL_YouTube>

El script hace:

1. Llama a InnerTube API → obtiene title, channel, description, duration
2. Delega en TranscribeYoutube → crea Atlas/Recursos/Transcripciones/VIDEO_ID - Título.md
3. Lee el fichero de transcripción
4. Emite un JSON con todos los datos por stdout

Paso 2 — Leer el JSON

El JSON contiene estos campos clave:

Objeto persona:

Paso 2.5 — Gestión automática de Personas

El script verifica automáticamente si existe Atlas/Personas/<ChannelName>.md:

• Si NO existe: Crea un nuevo archivo de Persona con este vídeo marcado como [p] (procesado)
• Si SÍ existe: Agrega el vídeo al checklist existente y actualiza la sección "Notas generadas"

Esta integración permite que VideoToObsidian sea totalmente compatible con ChannelToObsidian:

• Descargas vídeos individuales → se registran en su Persona
• Luego descargas todo el canal → el índice ya tiene los vídeos previos como [p]

Plantilla generada (igual a ChannelToObsidian):

---
tags: [atlas, persona, canal-youtube]
canal: "Nombre del Canal"
url: https://www.youtube.com/@canalhandle
updated: 2026-04-16
total-videos: 3
---

# Nombre del Canal — Índice de vídeos

## Vídeos

- [p] **Título del vídeo** · 12:34 · hoy · `VIDEO_ID`
- [ ] **Otro vídeo** · 45:12 · ayer · `OTRO_ID`

---

## Notas generadas

- [[Atlas/Recursos/Título del vídeo procesado]]

Paso 3 — Detectar el tipo de contenido

Analiza transcript_content + title + description para clasificar el vídeo:

Paso 4 — Generar la nota con la plantilla correcta

Usa la plantilla del tipo detectado. El frontmatter y el bloque de vídeo son siempre iguales:

---
tags: [atlas, recurso, youtube, <topic_tags separados por coma>]
url: <url>
canal: "<channel>"
persona: "<persona_wikilink>"
duracion: "<duration>"
fecha-guardado: <fecha_guardado>
temas: [<topics separados por coma entre comillas>]
---

# <title>

> 👤 Por: <persona_wikilink>
> 🎥 [ver en YouTube](<url>)
> <iframe width="100%" height="400" src="<embed_url>" allowfullscreen></iframe>
>
> 📄 Transcripción completa: <wikilink_transcript>
> 🔗 Vídeo original: [youtube.com/watch?v=<video_id>](<url>)
>
> **Resumen:** <resumen de 3-5 frases generado desde la transcripción>

---

Nota: Si topic_section viene relleno en el JSON, insertarlo al final de la nota (antes de ## Fuentes si existe, o al final). Los wikilinks [[Atlas/Temas/...]] conectan la nota con los hubs de temas del vault.

Luego añade las secciones según el tipo:

Plantilla TUTORIAL

## Cuándo usar esto
- <caso de uso 1 extraído de la transcripción>
- <caso de uso 2>

---

## Pasos

- [ ] 1. **<acción>** — <detalle>
- [ ] 2. **<acción>** — <detalle>
- [ ] ...

---

## Consejos
- <consejo 1 extraído de la transcripción>
- <consejo 2>

---

## Fuentes consultadas
- Vídeo: [<title>](<url>) — <channel>

<topic_section>

*(Si `topic_section` está vacío en el JSON, añade aquí manualmente wikilinks a notas relacionadas del vault)*

Plantilla CONCEPTO/TEORÍA

## Qué es
<explicación de 2-3 párrafos>

## Por qué importa
- <razón 1>
- <razón 2>

## Puntos clave
- **<concepto>**: <definición breve>
- **<concepto>**: <definición breve>

---

## Fuentes consultadas
- Vídeo: [<title>](<url>) — <channel>

<topic_section>

*(Si `topic_section` está vacío en el JSON, añade aquí manualmente wikilinks a notas relacionadas del vault)*

Plantilla DEMO/SHOWCASE

## Qué muestra el vídeo
<descripción de lo que se demuestra>

## Aspectos destacados
- <punto 1>
- <punto 2>

## Aplicación práctica
- <cómo podría usarse en mi contexto>

---

## Fuentes consultadas
- Vídeo: [<title>](<url>) — <channel>

<topic_section>

*(Si `topic_section` está vacío en el JSON, añade aquí manualmente wikilinks a notas relacionadas del vault)*

Plantilla CHARLA/ENTREVISTA

## Sobre qué
<contexto del guest o tema general>

## Ideas principales
- <idea 1>
- <idea 2>

## Citas destacadas
> "<cita literal de la transcripción>"

---

## Fuentes consultadas
- Vídeo: [<title>](<url>) — <channel>

<topic_section>

*(Si `topic_section` está vacío en el JSON, añade aquí manualmente wikilinks a notas relacionadas del vault)*

Paso 5 — Guardar la nota

Guarda la nota generada en la ruta target_note del JSON.
Si ya existe un fichero con ese nombre, pregunta al usuario si sobreescribir.

Paso 6 — Abrir en Obsidian

import subprocess, platform, os
vault    = "<vault del JSON>"
rel_path = "<ruta relativa dentro del vault>"
if platform.system() == "Darwin":
    os.system(f'open "obsidian://open?vault={os.path.basename(vault)}&file={rel_path}"')

O simplemente ejecuta:

open "obsidian://open?vault=Luna&file=Atlas/Recursos/<safe_title>"

Convenciones

• Nombre del fichero: título del vídeo limpio, máx 60 caracteres, sin caracteres especiales
• Ubicación: VAULT/Atlas/Recursos/<Título>.md
• Transcripción: VAULT/Atlas/Recursos/Transcripciones/<VIDEO_ID> - <Título>.md (generada por TranscribeYoutube)
• Tags de tema: infiere del título + descripción (p.ej. affinity-photo, python, ia)

Notas

• El script puede tardar 5-15 segundos (InnerTube + descarga de transcripción)
• Si el vídeo no tiene subtítulos disponibles, se crea la nota sin transcripción y sin wikilink de transcripción
• El campo transcript_found: false en el JSON indica que no hay transcripción
• En ese caso, genera la nota con el resumen basado en description solamente
• Nuevo: El script maneja automáticamente Atlas/Personas/<ChannelName>.md:
  • Si no existe, lo crea con este vídeo marcado como [p]
  • Si ya existe, lo actualiza agregando el vídeo al checklist
  • Totalmente compatible con ChannelToObsidian — puede ejecutarse antes, después o intercalado