telegram-history-dump

यह उपयोगिता telegram-json-backup का उत्तराधिकारी है, जिसे Ruby में शुरू से लिखा गया है। यह telegram-cli की रिमोट कंट्रोल सुविधा का उपयोग करके आपके Telegram उपयोगकर्ता और (सुपर)ग्रुप संवादों का बैकअप बना सकता है।

पुराने प्रोजेक्ट की तुलना में, telegram-history-dump:

• मीडिया डाउनलोड के लिए बेहतर समर्थन है
• JSON के अलावा अन्य आउटपुट प्रारूपों का समर्थन करता है और कस्टम प्रारूपों के साथ विस्तार योग्य है
• वृद्धिशील बैकअप का समर्थन करता है (केवल नए संदेश डाउनलोड किए जाते हैं)
• telegram-cli के भीतर अस्थिर Python/Lua बाइंडिंग पर निर्भर नहीं करता
• एक अलग YAML स्वरूपित कॉन्फ़िगरेशन फ़ाइल है

डिफ़ॉल्ट कॉन्फ़िगरेशन सभी संवादों को output नामक निर्देशिका में, JSON प्रारूप में, बिना कोई मीडिया डाउनलोड किए बैकअप करेगा।

उपयोग

पहली बार सेटअप

1. telegram-cli को कंपाइल करें, अपने Telegram खाते को लिंक करने के लिए इसे एक बार शुरू करें
2. सुनिश्चित करें कि आपके सिस्टम पर Ruby 2+ स्थापित है: ruby --version
3. वैकल्पिक रूप से config.yaml को संपादित करके अपनी बैकअप दिनचर्या कॉन्फ़िगर करें

बैकअप लेना

1. कम से कम निम्नलिखित विकल्पों के साथ telegram-cli शुरू करें: telegram-cli --json -P 9009
2. जब telegram-cli चल रहा हो, स्क्रिप्ट निष्पादित करें: ruby telegram-history-dump.rb

फ़ॉर्मेटर

इतिहास हमेशा JSON Lines अनुरूप फ़ाइलों में संग्रहीत किया जाएगा। हालांकि, कॉन्फ़िगरेशन फ़ाइल में कुछ पंक्तियों को अनकमेंट करके अतिरिक्त आउटपुट प्रारूप तैयार किए जा सकते हैं।

आप निम्नलिखित फ़ॉर्मेटर मॉड्यूल में से एक या अधिक को सक्षम कर सकते हैं:

html वेब ब्राउज़र से देखने योग्य स्टाइलिश, पेजिनेटेड चैट लॉग बनाता है।

plaintext मानव-पठनीय टेक्स्ट फ़ाइलें बनाता है, प्रति दिन एक फ़ाइल के रूप में व्यवस्थित।

bare बिना किसी संदर्भ के केवल वास्तविक संदेश टेक्स्ट आउटपुट करता है। यह भाषाई/सांख्यिकीय विश्लेषण के लिए है।

pisg PISG चैट सांख्यिकी जनरेटर के लिए इनपुट के रूप में EnergyMech IRC लॉगिंग प्रारूप के साथ संगत दैनिक लॉग बनाता है। telegram-pisg भी देखें।

आप एक कस्टम फ़ॉर्मेटर भी लागू कर सकते हैं; विवरण के लिए formatters/lib/formatter_base.rb देखें।

कमांड लाइन विकल्प

अधिकांश बैकअप कॉन्फ़िगरेशन कॉन्फ़िग फ़ाइल के माध्यम से किया जाता है, लेकिन कुछ विशिष्ट विकल्प CLI विकल्पों के रूप में उपलब्ध हैं। उनमें से कोई भी अनिवार्य नहीं है।

Usage: telegram-history-dump.rb [options]
    -c, --config=cfg.yaml            Path to YAML configuration file
    -k, --kill-tg                    Kill telegram-cli after backup
    -h, --help                       Show help
    -d, --dir=DIR                    Subdirectory for output files
                                     (relative to backup_dir in YAML config)
    -l, --limit=LIMIT                Maximum number of messages to backup
                                     for each target (overrides YAML config)

नोट्स

उपयोग नोट्स:

• telegram-cli को किसी अन्य मशीन पर चलाना संभव है, उदा. सर्वर पर डेमॉन के रूप में। इस स्थिति में आपको telegram-cli को --accept-any-tcp पास करना होगा और अनचाहे एक्सपोज़र को रोकने के लिए पोर्ट को उचित रूप से फ़ायरवॉल करना होगा। ध्यान रखें कि मीडिया फ़ाइलों से संबंधित कुछ विकल्प रिमोट सेटअप में काम नहीं करेंगे।
• chunk_delay को कम करने या chunk_size को बढ़ाने में सावधानी बरतें। Telegram इतिहास अनुरोधों को दर-सीमित करता प्रतीत होता है। बहुत तेज़ जाने से कोई ऑपरेशन टाइम आउट हो सकता है और स्क्रिप्ट को डंप के एक भाग को छोड़ने के लिए मजबूर कर सकता है।

Telegram-cli की समस्याएं जो telegram-history-dump को प्रभावित करने के लिए जानी जाती हैं:

• vysheng/tg#947 100 से अधिक संदेशों वाले चैनलों को डंप करते समय क्रैश का कारण बन सकता है।
• vysheng/tg#904 संवादों में कुछ मीडिया फ़ाइलें होने पर क्रैश का कारण बन सकता है। यदि आपको यह मिलता है, तो सुझाए गए वर्कअराउंड के साथ telegram-cli को पुनः कंपाइल करें।