Documentatie
Subquill gebruiken
Een praktische gids voor setup, aantekeningen genereren, Markdown exporteren, en waar je data woont. Voor bron, zie de GitHub-repository.
Overzicht
Subquill is een desktop-app voor macOS en Windows, gebouwd op Tauri 2 (een React-frontend over een Rust-core). Het maakt studienaantekeningen van de officiële ondertitels van openbare Bilibili- en YouTube-video's, met elk OpenAI-compatibel model dat je instelt.
- Plak één of meer video-URL's — Bilibili (BV-links) of YouTube
- Haalt echte ondertitelsporen op, inclusief AI- en inlog-afgeschermde Bilibili-sporen als er een SESSDATA-cookie is ingesteld
- Schrijft een Markdown-aantekening: een Summary plus een Section-breakdown met hh:mm:ss-tijdcodes uit de ondertitels
- Kopiëren, .md exporteren, of elke afgeronde aantekening automatisch in een map van jou zetten
Aan de slag
Installeer Subquill en open het. De eerste start loopt je door de setup:
- Base URL van een OpenAI-compatibele API
- Model name
- API Key — meteen naar schijf, en nooit meer terug in de UI
- Interfacetaal: Chinees, Engels, of het systeem volgen
- Optionele Bilibili SESSDATA-cookie, alleen nodig voor inlog-afgeschermde of sommige AI-ondertitelsporen
Subquill wordt alleen als broncode gedistribueerd — geen voorgebouwde installers. Kloon de repository, installeer Node.js LTS en Rust, voldoe aan de Tauri 2-vereisten voor je OS en voer npm install en npm run tauri build uit.
Aantekeningen genereren
Plak in de werkruimte één video-URL per regel en druk op Generate. Voordat de job start, toont Subquill van elke video de metadata, zodat je weet wat het vond:
- Videotitel en duur, en welk deel (P) je mikt — zet ?p=2 achter een Bilibili-URL om een deel te kiezen
- “Caption tracks detected” als er ondertitels zijn
- Een cookie-hint als een Bilibili-video SESSDATA nodig heeft, plus een waarschuwing als de opgeslagen waarde niet meer werkt
Lange transcripts worden in stukken geknipt, stuk voor stuk gegenereerd en samengevoegd. Voortgang zie je als percentage per job, met een annuleerknop; een afgeronde preview kun je terugschakelen als je meerdere links in één batch deed.
Kopiëren & exporteren
- Copy Markdown — zet de aantekening op je klembord
- Save as .md — opent het native opslagdialoogvenster
- Reveal in folder — springt naar het auto-opgeslagen bestand, als er een notitiemap is ingesteld
- De aantekeningpreview is gesaneerde Markdown: ruwe HTML wordt nooit gerenderd
Settings
In Settings kun je het model-endpoint bijwerken en de verbinding opnieuw testen, de notitiemap kiezen, en opgeslagen geheimen wissen:
- Clear API Key — je moet hem opnieuw invoeren voor je kunt genereren
- Clear cookie — sommige Bilibili-video's zijn dan niet meer op te halen
- Clear notes folder — stopt auto-opslaan; bestaande bestanden blijven staan
Waar dingen staan
| Bestand | macOS / Linux | Windows |
|---|---|---|
| settings.json | ~/.config/subquill/settings.json | %APPDATA%\subquill\settings.json |
| auth.json | ~/.local/share/subquill/auth.json | %LOCALAPPDATA%\subquill\auth.json |
auth.json bevat de API Key en de optionele Bilibili SESSDATA. Beide bestanden staan buiten de repository en buiten de app-bundle — commit ze nergens.
Privacy & netwerk
- Subquill draait geen backends; er is geen telemetry en geen account
- Ondertitelverzoeken gaan vanaf jouw machine rechtstreeks naar Bilibili- / YouTube-API's
- Aantekeninggeneratie stuurt transcriptstukken alleen naar het model-endpoint dat jij instelt
- De SESSDATA-cookie wordt uitsluitend tegen de officiële API van Bilibili gebruikt
- Na de setup blijven geheimen in de Rust-laag; de UI toont “configured”-placeholders en nooit de platte waarde
Updates
Subquill wordt alleen als broncode gedistribueerd. Haal de nieuwste code van GitHub en bouw lokaal opnieuw — geen voorgebouwde installers of in-app binaire updates.