Documentación

Usar Subquill

Una guía práctica de configuración, generación de apuntes, exportación a Markdown y dónde viven tus datos. Para el código, ver el repositorio de GitHub.

Overview

Subquill es una app de escritorio para macOS y Windows, construida sobre Tauri 2 (un front en React sobre un núcleo en Rust). Genera apuntes de estudio a partir de los subtítulos oficiales de vídeos públicos de Bilibili y YouTube, usando cualquier modelo compatible con OpenAI que configures.

  • Pega una o varias URLs de vídeo — Bilibili (enlaces BV) o YouTube
  • Recupera pistas de subtítulos reales, incluidas las de IA y las de Bilibili con login cuando hay una cookie SESSDATA configurada
  • Escribe un apunte Markdown: un Summary más un desglose por secciones con marcas de tiempo hh:mm:ss de los subtítulos
  • Copia, exporta .md o autoguarda cada apunte terminado en una carpeta a tu elección

Getting started

Instala Subquill y ábrelo. El primer arranque te lleva por el onboarding:

  • Base URL de una API compatible con OpenAI
  • Nombre del modelo
  • API Key — se guarda en disco al momento y nunca se vuelve a mostrar en la interfaz
  • Idioma de la interfaz: chino, inglés o el del sistema
  • Cookie SESSDATA de Bilibili opcional, solo necesaria para pistas con login o algunas de IA
Un botón Test connection en el onboarding y en Ajustes verifica tu endpoint y modelo antes de generar nada. ¿Aún no tienes endpoint? Subquill AMP, nuestra pasarela alojada compatible con OpenAI, está disponible en este sitio.

Subquill se distribuye solo como código fuente: no se publican instaladores precompilados. Clona el repositorio, instala Node.js LTS y Rust, cumple los requisitos de Tauri 2 para tu SO y ejecuta npm install y npm run tauri build.

Generating notes

En el espacio de trabajo, pega una URL de vídeo por línea y pulsa Generate. Antes de que arranque el trabajo, Subquill previsualiza los metadatos de cada vídeo para que sepas qué ha encontrado:

  • Título y duración del vídeo, y qué parte (P) estás apuntando — añade ?p=2 a una URL de Bilibili para elegir una parte
  • «Pistas de subtítulos detectadas» cuando hay subtítulos disponibles
  • Un aviso de cookie cuando un vídeo de Bilibili necesita SESSDATA, más un aviso de cookie caducada cuando el valor guardado ya no funciona

Las transcripciones largas se parten en trozos, se generan trozo a trozo y se fusionan. El progreso se muestra como porcentaje por trabajo con un botón de cancelar; una vista previa terminada se puede volver a seleccionar cuando has generado varios enlaces en un lote.

El vídeo tiene que tener subtítulos en línea. Si no tiene, Subquill te lo dice antes de gastar ningún token.

Copying & exporting

  • Copy Markdown — pone el apunte en el portapapeles
  • Save as .md — abre el diálogo nativo de guardar
  • Reveal in folder — salta al archivo autoguardado, si hay una carpeta de apuntes configurada
  • La vista previa de apuntes es Markdown saneado: el HTML crudo nunca se renderiza
Sin una carpeta de apuntes configurada, los resultados viven solo en la vista previa de la app — expórtalos antes de empezar un trabajo nuevo.

Settings

Ajustes te deja actualizar el endpoint del modelo y volver a probar la conexión, elegir la carpeta de apuntes y borrar secretos guardados:

  • Clear API Key — tendrás que volver a introducirla antes de generar
  • Clear cookie — algunos vídeos de Bilibili dejarán de poder recuperarse
  • Clear notes folder — deja de autoguardar; los archivos existentes no se tocan

Where things are stored

ArchivomacOS / LinuxWindows
settings.json~/.config/subquill/settings.json%APPDATA%\subquill\settings.json
auth.json~/.local/share/subquill/auth.json%LOCALAPPDATA%\subquill\auth.json

auth.json guarda la API Key y el SESSDATA opcional de Bilibili. Ambos archivos viven fuera del repositorio y fuera del paquete de la app — no los subas a ningún sitio.

Privacy & network

  • Subquill no opera ningún servicio de backend; no hay telemetría ni cuenta
  • Las peticiones de subtítulos van a las APIs de Bilibili / YouTube directo desde tu máquina
  • La generación de apuntes envía trozos de transcripción solo al endpoint de modelo que configures
  • La cookie SESSDATA se usa exclusivamente contra la API oficial de Bilibili
  • Tras el onboarding, los secretos se quedan en la capa Rust; la interfaz muestra marcadores de «configurado» y nunca el valor en claro

Actualizaciones

Subquill se distribuye solo como código fuente. Obtén el último código en GitHub y recompila localmente: no hay instaladores precompilados ni actualizaciones binarias en la app.