🎬 Siphon - JDownloader 2 Telegram Bot

English   •   עברית

Smart Telegram bot for video downloading via JDownloader 2 with automatic upload to Telegram

---

✨ Key Features

Feature	Description
🔗 JDownloader 2 Integration	Full control over JD2 via My.JDownloader API
🚀 Regular & Deep Scanning	Deep-Decrypt for extracting hidden links
📊 Progress Dashboard	Real-time tracking with animated moon progress bar
📤 Automatic Upload	Direct upload to Telegram with streaming support
🔪 Large File Splitting	Automatic splitting for files over 2GB
🔄 MP4 Conversion	Automatic conversion to streaming-compatible format
🖼️ Photo Album Support	Send photos as albums (up to 10 at a time)
🔒 User Permissions	Admins and authorized users only

---

🛠️ System Requirements

• Python 3.8+
• JDownloader 2 with a My.JDownloader account
• FFmpeg installed and accessible in PATH
• Telegram API account

---

🚀 Installation

1. Clone the project

git clone https://github.com/your-username/siphon.git
cd siphon

2. Create a virtual environment

python -m venv venv
venv\Scripts\activate  # Windows
# or
source venv/bin/activate  # Linux/Mac

3. Install dependencies

pip install -r requirements.txt

4. Configure the .env file

Create a .env file in the root directory:

# Telegram
BOT_TOKEN=your_bot_token
API_ID=your_api_id
API_HASH=your_api_hash
ADMIN_IDS=123456789
USER_IDS=111111111,222222222

# JDownloader 2
JD_EMAIL=your_myjdownloader_email
JD_PASSWORD=your_myjdownloader_password
JD_DEVICE_NAME=your_device_name
JD_DOWNLOAD_DIR=C:\Users\you\Downloads\JD

🐧 Optional: Linux Server Deployment (Background Service)

To run the bot in the background continuously on a Linux server and ensure it restarts automatically if the server reboots, you can set it up as a systemd service.

1. Install FFmpeg (if not already installed):

   sudo apt update
   sudo apt install ffmpeg

2. Create a systemd service file:

   sudo nano /etc/systemd/system/siphon-bot.service

3. Paste the following configuration (modify the paths and user accordingly):

   [Unit]
   Description=Siphon JD2 Telegram Bot
   After=network.target
   
   [Service]
   Type=simple
   User=your_linux_user
   WorkingDirectory=/path/to/siphon
   ExecStart=/path/to/siphon/venv/bin/python bot.py
   Restart=always
   RestartSec=10
   
   [Install]
   WantedBy=multi-user.target

4. Enable and start the service:

   sudo systemctl daemon-reload
   sudo systemctl enable siphon-bot
   sudo systemctl start siphon-bot

5. View logs:

   sudo journalctl -u siphon-bot -f

---

⚙️ JDownloader 2 Setup

1. Download and install JDownloader 2
2. Create an account at My.JDownloader
3. Connect in JD2: Settings → My.JDownloader
4. Note the Device Name - this is what you'll enter in JD_DEVICE_NAME

---

🤖 Usage

Running the bot (Windows / Local)

python bot.py

Or:

run_bot.bat

Available Commands

Command	Description
/start	Start and display welcome message

Workflow

graph LR
    A[📎 Send Link] --> B{Choose Scan Type}
    B -->|🚀 Regular| C[Quick Scan]
    B -->|🕷️ Deep| D[Deep-Decrypt]
    C --> E[📋 Select Files]
    D --> E
    E --> F[⬇️ Download in JD2]
    F --> G[📤 Upload to Telegram]

Loading

1. Send a link → Bot detects automatically
2. Choose scan type → Regular (fast) or Deep (comprehensive)
3. Select files → Interactive interface with Toggle
4. Click Download → JD2 downloads, bot uploads to Telegram

---

📁 Project Structure

Siphon/
├── 📄 bot.py           # Main bot + Telegram interface
├── 📄 jd_client.py     # JDownloader API wrapper
├── 📄 utils.py         # Helper functions (FFmpeg, formats)
├── 📄 requirements.txt # Python dependencies
├── 📄 run_bot.bat      # Run script (Windows)
├── 📄 .env             # Environment settings (not in Git)
└── 📄 README.md        # You are here! 👋

---

🎨 Interface Features

🌙 Moon Progress Bar

🌕🌕🌕🌕🌖🌑🌑🌑🌑🌑 45%

📊 Download Dashboard

📥 Downloading... (Total)
━━━━━━━━━━━━━━━━━━
🌕🌕🌕🌕🌖🌑🌑🌑🌑🌑 45.2%
📊 4.0GB/8.9GB
📥 Current file: video_file.mp4
⚡ Speed: 15.3MB/s
⏱️ ETA: 05:23
🗂 Files: 2/5
━━━━━━━━━━━━━━━━━━

---

📦 Dependencies

Package	Description
pyrogram	Telegram Client API
myjdapi	JDownloader 2 API
ffmpeg-python	FFmpeg wrapper
python-dotenv	Environment variables loader

---

⚠️ Important Notes

Important

JDownloader 2 must be running in the background for the bot to work!

Tip

Use Deep scanning for sites with protections or hidden links.

Note

Files over 2GB will be automatically split into parts.

---

📜 License

MIT License - See LICENSE for details.

---

Made with ❤️ by Omer