stickers-downloader 0.1.0

A Python package to download and convert Telegram animated stickers (TGS) to GIFs.

StickersDownloader

📌 معرفی (فارسی)

StickersDownloader یک بسته پایتون برای دانلود و تبدیل استیکرهای متحرک تلگرام (TGS) به GIF است. با این ابزار می‌توانید کل پک استیکرها را دانلود کنید یا استیکرهای خاص را انتخاب کنید. همچنین در حین پردازش، یک نوار پیشرفت رنگی و زیبا نمایش داده می‌شود.

ویژگی‌ها

• دانلود استیکرهای متحرک تلگرام (.tgs) از هر پک استیکر.
• تبدیل خودکار استیکرها به GIF.
• امکان دانلود همه استیکرها یا انتخاب استیکرهای خاص.
• خروجی زیبا و رنگی در کنسول با استفاده از rich.
• مدیریت خودکار خطاهای شبکه و محدودیت‌های API تلگرام.

نصب

pip install StickersDownloader

نیاز به Python 3.8 یا بالاتر دارد.

استفاده در کد پایتون

from StickersDownloader import TelegramStickerDownloader
import asyncio

TOKEN = "توکن-ربات-تلگرام-شما"
STICKER_PACK_LINK = "https://t.me/addstickers/YourStickerPack"

downloader = TelegramStickerDownloader(TOKEN, STICKER_PACK_LINK)

async def main():
    # دانلود همه استیکرها
    await downloader.run()
    
    # یا دانلود استیکرهای خاص با شماره شاخص
    selected_indexes = [0, 2, 5]
    await downloader.run(selected_indexes=selected_indexes)

asyncio.run(main())

استفاده از طریق خط فرمان (CLI)

python -m StickersDownloader <TOKEN> <STICKER_PACK_LINK>

با این دستور، لیست استیکرها نمایش داده می‌شود و می‌توانید انتخاب کنید کدام استیکرها دانلود شوند.

---

📌 Features (English)

StickersDownloader is a Python package to download and convert Telegram animated stickers (TGS) to GIFs. It allows you to download an entire sticker pack or select specific stickers. A colorful progress bar shows while processing.

Features

• Download Telegram animated stickers (.tgs) from any sticker pack.
• Automatically convert stickers to GIF.
• Download all stickers or select specific ones.
• Beautiful console output with progress bars using rich.
• Handles network errors and Telegram API restrictions.

Installation

pip install StickersDownloader

Requires Python 3.8+.

Usage in Python

from StickersDownloader import TelegramStickerDownloader
import asyncio

TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"
STICKER_PACK_LINK = "https://t.me/addstickers/YourStickerPack"

downloader = TelegramStickerDownloader(TOKEN, STICKER_PACK_LINK)

async def main():
    # Download all stickers
    await downloader.run()
    
    # Or select specific stickers by index
    selected_indexes = [0, 2, 5]
    await downloader.run(selected_indexes=selected_indexes)

asyncio.run(main())

CLI Usage

python -m StickersDownloader <TOKEN> <STICKER_PACK_LINK>

It will show a preview of all stickers, letting you select which ones to download.

---

Dependencies

• aiohttp
• rlottie-python
• rich

---

License

MIT License © Ali Ayati Qaffari

---

Links

• GitHub Repository
• Issues