दस्तावेज़

Subquill इस्तेमाल करना

सेटअप, नोट्स जनरेट करना, Markdown एक्सपोर्ट, और डेटा कहाँ रहता है — प्रैक्टिकल गाइड। सोर्स के लिए GitHub रिपॉज़िटरी देखो।

ओवरव्यू

Subquill macOS और Windows का डेस्कटॉप ऐप है, Tauri 2 पर बना (React फ्रंट एंड, Rust कोर)। पब्लिक Bilibili और YouTube वीडियो के आधिकारिक कैप्शन से स्टडी नोट्स बनाता है, तुम्हारे सेट किए किसी भी OpenAI-compatible मॉडल से।

  • एक या कई वीडियो URL पेस्ट करो — Bilibili (BV लिंक) या YouTube
  • असली कैप्शन ट्रैक लाता है, SESSDATA कुकी सेट हो तो AI और लॉगिन-गेटेड Bilibili ट्रैक भी
  • Markdown नोट लिखता है: Summary और कैप्शन के hh:mm:ss टाइमस्टैम्प वाला Section breakdown
  • कॉपी करो, .md एक्सपोर्ट करो, या हर पूरा नोट चुने फ़ोल्डर में ऑटो-सेव करो

शुरू करना

Subquill इंस्टॉल करो और खोलो। पहली लॉन्च ऑनबोर्डिंग से गुज़ारती है:

  • OpenAI-compatible API का Base URL
  • मॉडल नाम
  • API Key — तुरंत डिस्क पर सेव, UI में दोबारा नहीं दिखती
  • इंटरफ़ेस भाषा: चीनी, अंग्रेज़ी, या सिस्टम फॉलो करो
  • ऑप्शनल Bilibili SESSDATA कुकी, सिर्फ़ लॉगिन-गेटेड या कुछ AI कैप्शन ट्रैक के लिए
ऑनबोर्डिंग और Settings में Test connection बटन एंडपॉइंट और मॉडल चेक करता है, जनरेट करने से पहले। एंडपॉइंट नहीं है? Subquill AMP, हमारा होस्टेड OpenAI-compatible गेटवे, इसी साइट से उपलब्ध है।

Subquill केवल सोर्स के रूप में है — कोई प्री-बिल्ट इंस्टॉलर प्रकाशित नहीं। रिपो क्लोन करें, Node.js LTS और Rust इंस्टॉल करें, OS के लिए Tauri 2 आवश्यकताएँ पूरी करें, फिर npm install और npm run tauri build चलाएँ।

नोट्स जनरेट करना

वर्कस्पेस में हर लाइन पर एक वीडियो URL पेस्ट करो और Generate दबाओ। जॉब शुरू होने से पहले Subquill हर वीडियो का मेटाडेटा प्रीव्यू करता है, ताकि पता चले क्या मिला:

  • वीडियो टाइटल और अवधि, और कौन सा पार्ट (P) टारगेट है — पार्ट चुनने के लिए Bilibili URL के पीछे ?p=2 लगाओ
  • सबटाइटल उपलब्ध हों तो “Caption tracks detected”
  • Bilibili वीडियो को SESSDATA चाहिए तो कुकी हिंट, और स्टोर वैल्यू काम न करे तो स्टेल-कुकी वॉर्निंग

लंबी ट्रांसक्रिप्ट चंक में बँटती हैं, चंक दर चंक जनरेट होकर मर्ज होती हैं। प्रोग्रेस हर जॉब पर प्रतिशत में, कैंसल बटन के साथ; एक बैच में कई लिंक हों तो तैयार प्रीव्यू पर वापस स्विच कर सकते हो।

वीडियो में ऑनलाइन कैप्शन होने चाहिए। न हों तो Subquill कोई टोकन खर्च करने से पहले बता देता है।

कॉपी और एक्सपोर्ट

  • Copy Markdown — नोट क्लिपबोर्ड पर जाता है
  • Save as .md — नेटिव सेव डायलॉग खुलता है
  • Reveal in folder — ऑटो-सेव फ़ाइल पर जंप, अगर नोट्स फ़ोल्डर सेट है
  • नोट्स प्रीव्यू सैनिटाइज़्ड Markdown है: रॉ HTML कभी रेंडर नहीं होता
नोट्स फ़ोल्डर सेट न हो तो रिजल्ट सिर्फ़ ऐप प्रीव्यू में रहते हैं — नया जॉब शुरू करने से पहले एक्सपोर्ट कर लो।

Settings

Settings में मॉडल एंडपॉइंट अपडेट और दोबारा टेस्ट कर सकते हो, नोट्स सेव फ़ोल्डर चुन सकते हो, और स्टोर सीक्रेट साफ़ कर सकते हो:

  • Clear API Key — जनरेट करने से पहले दोबारा डालनी होगी
  • Clear cookie — कुछ Bilibili वीडियो अब फ़ेच नहीं होंगे
  • Clear notes folder — ऑटो-सेव रुक जाता है; मौजूदा फ़ाइलें नहीं छूतीं

चीज़ें कहाँ स्टोर होती हैं

फ़ाइलmacOS / LinuxWindows
settings.json~/.config/subquill/settings.json%APPDATA%\subquill\settings.json
auth.json~/.local/share/subquill/auth.json%LOCALAPPDATA%\subquill\auth.json

auth.json में API Key और ऑप्शनल Bilibili SESSDATA रहती है। दोनों फ़ाइलें रिपॉज़िटरी और ऐप बंडल के बाहर हैं — उन्हें कहीं भी कमिट मत करना।

प्राइवेसी और नेटवर्क

  • Subquill कोई बैकएंड सेवा नहीं चलाता; टेलीमेट्री नहीं, अकाउंट नहीं
  • कैप्शन रिक्वेस्ट तुम्हारी मशीन से सीधे Bilibili / YouTube API पर जाती हैं
  • नोट जनरेशन ट्रांसक्रिप्ट चंक सिर्फ़ तुम्हारे सेट किए मॉडल एंडपॉइंट को भेजती है
  • SESSDATA कुकी सिर्फ़ Bilibili के आधिकारिक API के ख़िलाफ़ इस्तेमाल होती है
  • ऑनबोर्डिंग के बाद सीक्रेट Rust लेयर में रहते हैं; UI “configured” प्लेसहोल्डर दिखाता है, प्लेनटेक्स्ट कभी नहीं

अपडेट

Subquill केवल सोर्स के रूप में है। GitHub से नवीनतम कोड खींचें और लोकल रीबिल्ड करें — कोई प्री-बिल्ट इंस्टॉलर या इन-ऐप बाइनरी अपडेट नहीं।