Dokumentation
Subquill nutzen
Ein praktischer Guide zu Setup, Notizen generieren, Markdown exportieren und wo deine Daten liegen. Für den Quellcode siehe das GitHub-Repository.
Überblick
Subquill ist eine Desktop-App für macOS und Windows, gebaut auf Tauri 2 (React-Frontend über einem Rust-Kern). Sie erzeugt Lernnotizen aus den offiziellen Untertiteln öffentlicher Bilibili- und YouTube-Videos mit jedem OpenAI-kompatiblen Modell, das du einrichtest.
- Eine oder mehrere Video-URLs einfügen — Bilibili (BV-Links) oder YouTube
- Holt echte Untertitelspuren, inklusive KI- und login-geschützter Bilibili-Spuren, wenn ein SESSDATA-Cookie eingerichtet ist
- Schreibt eine Markdown-Notiz: eine Summary plus eine Section-Aufschlüsselung mit hh:mm:ss-Timestamps aus den Untertiteln
- Kopieren, .md exportieren oder jede fertige Notiz automatisch in einen Ordner deiner Wahl speichern
Einstieg
Installier Subquill und öffne es. Der erste Start führt dich durchs Onboarding:
- Base URL einer OpenAI-kompatiblen API
- Modellname
- API Key — wird sofort auf die Platte geschrieben und nie wieder in der Oberfläche angezeigt
- Oberflächensprache: Chinesisch, Englisch oder System folgen
- Optionales Bilibili-SESSDATA-Cookie, nur nötig für login-geschützte oder manche KI-Untertitelspuren
Subquill wird nur als Quellcode verteilt — keine vorgefertigten Installer. Klone das Repository, installiere Node.js LTS und Rust, erfülle die Tauri-2-Voraussetzungen für dein OS und führe npm install und npm run tauri build aus.
Notizen generieren
Im Workspace eine Video-URL pro Zeile einfügen und auf Generieren drücken. Bevor der Job startet, zeigt Subquill die Metadaten jedes Videos in der Vorschau, damit du siehst, was es gefunden hat:
- Videotitel und Dauer, und welchen Teil (P) du ansteuerst — häng ?p=2 an eine Bilibili-URL, um einen Teil zu wählen
- „Untertitelspuren erkannt“, wenn Untertitel da sind
- Ein Cookie-Hinweis, wenn ein Bilibili-Video SESSDATA braucht, plus eine Warnung bei veraltetem Cookie, wenn der gespeicherte Wert nicht mehr gilt
Lange Transkripte werden in Chunks geteilt, stückweise generiert und zusammengeführt. Der Fortschritt erscheint als Prozent pro Job mit Abbrechen-Button; eine fertige Vorschau kannst du wieder anwählen, wenn du mehrere Links in einem Batch generiert hast.
Kopieren & exportieren
- Markdown kopieren — legt die Notiz in die Zwischenablage
- Als .md speichern — öffnet den nativen Speichern-Dialog
- Im Ordner zeigen — springt zur automatisch gespeicherten Datei, wenn ein Notizordner eingerichtet ist
- Die Notizvorschau ist bereinigtes Markdown: rohes HTML wird nie gerendert
Einstellungen
In den Einstellungen aktualisierst du den Modell-Endpunkt und testest die Verbindung erneut, wählst den Speicherordner für Notizen und löschst gespeicherte Geheimnisse:
- API Key löschen — du musst ihn vor dem nächsten Generieren erneut eingeben
- Cookie löschen — manche Bilibili-Videos lassen sich dann nicht mehr holen
- Notizordner löschen — stoppt das Auto-Speichern; vorhandene Dateien bleiben unangetastet
Wo was liegt
| Datei | 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 enthält den API Key und das optionale Bilibili-SESSDATA. Beide Dateien liegen außerhalb des Repositories und außerhalb des App-Bundles — commite sie nirgendwohin.
Datenschutz & Netzwerk
- Subquill betreibt keine Backend-Dienste; es gibt keine Telemetrie und kein Konto
- Untertitel-Anfragen gehen direkt von deinem Rechner an Bilibili- / YouTube-APIs
- Die Notizgenerierung schickt Transkript-Chunks nur an den Modell-Endpunkt, den du einrichtest
- Das SESSDATA-Cookie wird ausschließlich gegen Bilibilis offizielle API verwendet
- Nach dem Onboarding bleiben Geheimnisse in der Rust-Schicht; die Oberfläche zeigt Platzhalter „eingerichtet“ und nie den Klartext
Updates
Subquill wird nur als Quellcode verteilt. Zieh den neuesten Code von GitHub und baue lokal neu — es gibt keine vorgefertigten Installer oder In-App-Binary-Updates.