Prosey

Prosey एक CLI टूल है जो YouTube से वीडियो ट्रांसक्रिप्शन डाउनलोड और प्रदर्शित करता है, ताकि आप घंटों बर्बाद किए बिना वह जानकारी प्राप्त कर सकें जिसकी आप तलाश कर रहे हैं।

मुख्य उपयोग के मामले हैं:

• सारांशित करें एक YouTube वीडियो को और एक ही कमांड से CLI में प्रदर्शित करें (तेज़)।
• पढ़ें वीडियो कैप्शन, मूल वीडियो की तरह अध्यायों में स्वरूपित और व्यवस्थित (अक्सर अधिक समय लगता है)।

दोनों उपयोगों के लिए आपके सिस्टम पर एक AI सहायक की आवश्यकता होती है (डिफ़ॉल्ट: opencode, अपना स्वयं का कॉन्फ़िगर करने के लिए prosey config का उपयोग करें)।

यदि हम आपके सिस्टम पर सिंटैक्स हाइलाइटर का पता लगाते हैं, तो आपको सुंदर रंगीन आउटपुट मिलेगा।

Prosey मूल json प्रारूप को शब्दशः आउटपुट या संग्रहीत भी कर सकता है।

विशेषताएँ

त्वरित आरंभ

npx के साथ तुरंत आज़माएँ:

npx @tacone/prosey 771PQEDeRmw
npx @tacone/prosey https://youtu.be/771PQEDeRmw --lang es -o transcript.txt

स्थापना

अपने पसंदीदा पैकेज मैनेजर के साथ वैश्विक रूप से स्थापित करें:

npm install -g @tacone/prosey
# या
yarn global add @tacone/prosey
# या
pnpm add -g @tacone/prosey
# या
bun install -g @tacone/prosey

फिर इसे कहीं भी उपयोग करें:

prosey 771PQEDeRmw

स्रोत से

विकास के लिए Bun का उपयोग करता है — स्क्रिप्ट, पैकेज प्रबंधन, और TypeScript स्रोत को सीधे चलाना।

git clone https://github.com/tacone/prosey.git
cd prosey
bun install
bun run start -- 771PQEDeRmw

उपयोग

prosey [options] <video controls-url-or-id>
prosey read [options] <video controls-url-or-id>
prosey info [options] <video controls-url-or-id>
prosey summarize [options] <video controls-url-or-id>
prosey index
prosey render
prosey config
prosey help

summarize डिफ़ॉल्ट कमांड है, इसलिए prosey <id> AI सारांशकर्ता चलाता है। समृद्ध रूप से स्वरूपित ट्रांसक्रिप्ट डाउनलोड और प्रिंट करने के लिए prosey read <id> का उपयोग करें।

summarize कमांड एक ट्रांसक्रिप्ट प्राप्त करता है, [summarize] कॉन्फ़िगरेशन अनुभाग से प्रॉम्प्ट को आगे जोड़ता है, और परिणाम को कॉन्फ़िगर किए गए AI कमांड में पाइप करता है।

read कमांड ट्रांसक्रिप्ट डाउनलोड करता है और इसे stdout पर प्रिंट करता है (सादा पाठ, markdown, या JSON)। यह तब उपयोगी होता है जब आपको AI प्रोसेसिंग की आवश्यकता नहीं होती है।

info कमांड वीडियो मेटाडेटा (शीर्षक, चैनल, अवधि, दृश्य) दिखाता है।

index कमांड दस्तावेज़ अनुक्रमणिका का पुनर्निर्माण करता है और इसे ब्राउज़र में खोलता है। अनुक्रमणिका डेटा निर्देशिका में संग्रहीत प्रत्येक सारांश और ट्रांसक्रिप्शन को सूचीबद्ध करती है और प्रत्येक summarize/transcribe रन के बाद स्वचालित रूप से पुनर्निर्मित होती है। किसी भी सामग्री पृष्ठ पर Prosey लोगो पर क्लिक करने से उस पर वापस नेविगेट होता है।

render कमांड कैश किए गए markdown से प्रत्येक HTML पृष्ठ को पुनर्जीवित करता है (कोई नेटवर्क या AI प्रोसेसिंग नहीं) और अनुक्रमणिका को फिर से लिखता है।

config कमांड आपकी कॉन्फ़िगरेशन फ़ाइल को संपादन के लिए $EDITOR में खोलता है। यदि $EDITOR सेट नहीं है, तो कॉन्फ़िगरेशन फ़ाइल पथ प्रिंट किया जाता है।

help कमांड सहायता संदेश दिखाता है, --help के समान।

उदाहरण

# सारांशित करें (AI सारांश + स्वरूपण + सिंटैक्स हाइलाइटिंग)
prosey 771PQEDeRmw

# सारांशित करें (ऊपर के समान)
prosey summarize 771PQEDeRmw

# ट्रांसक्राइब करें (AI सारांश + स्वरूपण + सिंटैक्स हाइलाइटिंग)
prosey read 771PQEDeRmw

# वीडियो मेटाडेटा दिखाएँ
prosey info 771PQEDeRmw

# $EDITOR में कॉन्फ़िग संपादित करें
prosey config

# उपलब्ध भाषाएँ सूचीबद्ध करें
prosey read https://youtu.be/771PQEDeRmw --list

# भाषा निर्दिष्ट करें
prosey read https://youtu.be/771PQEDeRmw --lang es

# JSON प्रदर्शित करें (कोई AI ट्रांसक्रिप्शन नहीं)
prosey read 771PQEDeRmw

# सादा पाठ प्रदर्शित करें (कोई AI ट्रांसक्रिप्शन नहीं)
prosey read 771PQEDeRmw

# ट्रांसक्रिप्ट को फ़ाइल में सहेजें
prosey read 771PQEDeRmw -o transcript.txt

विकल्प

JSON प्रारूप

जब --json का उपयोग किया जाता है, तो आउटपुट वस्तुओं की एक सरणी होती है:

[
  {
    "text": "♪ We're no strangers to love ♪",
    "offset": 18.64,
    "duration": 3.24,
    "timestamp": "00:18"
  }
]

timestamp JSON मोड में हमेशा मौजूद होता है। वीडियो विवरण दबाए जाते हैं (चुपचाप) क्योंकि JSON संरचित डेटा है।

विकास

यह परियोजना विकास के लिए Bun का उपयोग करती है।

bun run typecheck   # TypeScript जाँच
bun run start       # स्रोत से CLI चलाएँ
bun run test        # यूनिट परीक्षण चलाएँ
bun run build       # Node बंडल को bin/prosey में संकलित करें

npm पर प्रकाशित करने से पहले, bun run build prepack हुक के माध्यम से स्वचालित रूप से चलता है, जो bin/prosey पर Node-संगत JS बंडल उत्पन्न करता है।

कॉन्फ़िगरेशन

Prosey एक TOML फ़ाइल से कॉन्फ़िगरेशन पढ़ता है। स्थान XDG Base Directory Specification (~/.config/prosey/config.toml) का पालन करता है, या आप कस्टम पथ का उपयोग करने के लिए PROSEY_CONFIG_PATH पर्यावरण चर सेट कर सकते हैं।

कॉन्फ़िगरेशन फ़ाइल पहले रन पर डिफ़ॉल्ट मानों के साथ स्वचालित रूप से बनाई जाती है। किसी भी समय डिफ़ॉल्ट को पुनर्स्थापित करने के लिए --reset-config का उपयोग करें।

pager

ट्रांसक्रिप्ट और सारांश आउटपुट के लिए पेजर कमांड। डिफ़ॉल्ट "auto" है, जो निम्न में से पहले उपलब्ध का पता लगाता है: bat -lmd --style plain → glow -p → mdcat -l -p → less। ओवरराइड करने के लिए कस्टम कमांड (जैसे "less -R") सेट करें। PROSEY_PAGER पर्यावरण चर इस सेटिंग पर प्राथमिकता लेता है।

[summarize]

[summarize] अनुभाग summarize कमांड को कॉन्फ़िगर करता है:

PROSEY_PAGER

पेजर कमांड सेट करने के लिए पर्यावरण चर। pager कॉन्फ़िग मान पर प्राथमिकता लेता है। स्वतः-पता लगाने के लिए "auto" या खाली सेट करें।

कैश

ट्रांसक्रिप्ट और सारांश /tmp/prosey/ में कैश किए जाते हैं। समान वीडियो और विकल्पों के लिए बार-बार कॉल तत्काल होती हैं और ऑफ़लाइन काम करती हैं। कैश रीड छोड़ने और ताज़ा फ़ेच को बाध्य करने के लिए --no-cache का उपयोग करें।

जब prosey summarize चलता है, तो कमांड उस वीडियो के लिए कैश निर्देशिका के अंदर चलता है। यह AI एजेंट को वर्तमान फ़ोल्डर से AGENTS.md या CLAUDE.md जैसी परियोजना-विशिष्ट फ़ाइलों को उठाने से रोकता है, और उस निर्देशिका के बाहर फ़ाइलों को संशोधित करने की उसकी क्षमता को सीमित करता है।

निकास कोड

यह कैसे काम करता है

prosey YouTube के Innertube API का उपयोग youtube-transcript-plus लाइब्रेरी के माध्यम से करता है। कोई API कुंजी या ब्राउज़र स्वचालन की आवश्यकता नहीं है।

यह टूल मैन्युअल रूप से बनाए गए कैप्शन और स्वतः-उत्पन्न ट्रांसक्रिप्ट (YouTube की स्पीच-टू-टेक्स्ट) दोनों के साथ काम करता है। स्वतः-पता लगाना YouTube के प्लेयर प्रतिक्रिया द्वारा प्रदान किए गए क्रम में भाषाओं के माध्यम से गिरता है।