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 config
prosey help

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

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

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

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

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"
  }
]

JSON मोड में timestamp हमेशा मौजूद रहता है। वीडियो विवरण दबा दिए जाते हैं (मौन रूप से) क्योंकि 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 बेस डायरेक्टरी स्पेसिफिकेशन (~/.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 के प्लेयर प्रतिक्रिया द्वारा प्रदान किए गए क्रम में भाषाओं में गिरता है।