👻 GhostGram

Download disappearing Telegram photos and videos before they vanish.

GhostGram is a powerful Python CLI tool built on Telethon that allows you to browse, preview, and download self-destructing or restricted Telegram media — including photos, videos, and documents — from your personal chats.

---

✨ Features

• 🔥 Detects and downloads TTL (self-destructing) media messages.
• 📸 Supports photos, videos, audio, and documents.
• 📂 Automatically saves media in the downloads/ directory.
• 📤 Optional auto-forwarding to your private channel for safe archiving.
• 🧭 Built-in interactive CLI to browse chats, preview media, and select downloads.
• 🧱 Clean terminal UI with colored output and progress logs.

---

⚙️ Setup

1. Clone the repository

git clone https://github.com/ayxkaddd/GhostGram.git
cd GhostGram

2. Install dependencies

pip install -r requirements.txt

Install ffprobe from ffbinaries.com for your OS.

3. Create .env

Put your Telegram API credentials (from my.telegram.org) in .env:

API_ID=123456
API_HASH=your_api_hash_here

4. (Optional) Set forwarding channel

In .env:

FORWARD_CHANNEL_ID=1234567890

---

🚀 Usage

python3 ghostgram.py

Then:

1. Select a chat from your contacts list.
2. Browse media files (including TTL content 🔥).
3. Choose which ones to download or forward to a channel.

---

⚠️ Disclaimer

This tool is for personal archival and educational use only. Downloading or redistributing private, ephemeral, or copyrighted content may violate Telegram’s Terms of Service.

Use responsibly.