Jable Video Downloader Skill

This tool is dedicated to high-speed video downloads from Jable.tv, with automatic organization based on the actress's name and real-time progress web page.

Dependencies

Before executing the download, the AI Agent MUST ensure the following tools are installed. If missing, prompt the user for installation or attempt to install them automatically:

1. yt-dlp (Core download and decryption tool)
2. ffmpeg (Muxing and format correction tool)
3. python3 (Script execution environment)
4. flask (Web server for progress page)

Usage

# Single video download (auto start server + send Telegram)
/skill jable "Video ID or URL" "Save Directory (Optional)"

# Actress search download (auto start server + send Telegram)
/skill jable --search "Actress Name" "Count" "Save Directory (Optional)"

# Start progress web server (manual)
/skill jable --server

Input Formats:

• Video ID: e.g., dass-402, mina-340 (will be automatically expanded to https://jable.tv/videos/ID/)
• Full URL: e.g., https://jable.tv/videos/mina-340/
• Save Directory (Optional): Custom path, defaults to the system "Videos" directory.

New Feature: Auto Server Start + Telegram Notification

Automated Workflow:

1. When executing download, automatically check if server is running
2. If server not running, automatically start in background
3. Send progress page link via Telegram
4. Download progress displays in real-time on the web page

Telegram Notification Content:

📥 Jable Download Started!

🔗 Progress Page: http://100.64.0.5:5000

Access the Progress Page

• Local: http://localhost:5000
• Network: http://100.64.0.5:5000

The page shows:

• Current download status (idle/downloading/completed/error)
• Progress bar with percentage
• Download speed and ETA
• Number of completed/failed downloads
• Current file being downloaded

Execution Steps

1. Environment Check: Verify if yt-dlp, ffmpeg, and flask are available.
2. Auto Start Server: When you start a download, the script automatically checks if the server is running. If not, it starts it in the background.
3. Telegram Notification: You'll receive a Telegram message with the progress page URL.
4. Parse Input: Identify whether the input is a Video ID or a URL.
5. Execute Download: Run python3 jable_downloader.py .
• The script automatically simulates browser headers to obtain the correct hlsUrl.
• Invokes yt-dlp for high-speed downloading with 16 concurrent threads.
• Updates progress in real-time to the web page.
6. Post-processing:
• After the download completes, extract the actress's name from the video title.
• Create a folder named after the actress in the target directory.
• Move the .mp4 video into that folder.
7. Completion: The page will show "completed" status when done.

Examples

# Single video download (auto start server + send Telegram)
/skill jable "dass-402"
/skill jable "https://jable.tv/videos/mina-340/"

/skill jable "mina-300" "/home/user/Downloads"

# Actress search download (auto start server + send Telegram)
/skill jable --search "Mei" 10
/skill jable --search "Sakura" 5

# Manual server start
/skill jable --server

Web Page Features

The progress page at http://100.64.0.5:5000 includes:

• 🎨 Beautiful gradient UI design
• 📊 Real-time progress bar
• ⚡ Download speed display
• ⏱️ ETA (estimated time of arrival)
• 📁 Current file name
• ✅/❌ Completed/Failed counters
• 📱 Mobile-friendly responsive design