Fetchy is a high-performance, privacy-focused Discord bot designed to extract and deliver media from across the web with unparalleled ease. Built on a modern asynchronous architecture, Fetchy provides a clean, automated environment for all your media needs.
Fetchy was engineered to simplify the complex world of media extraction. Operating as a professional personal assistant, Fetchy handles everything from high-resolution 4K encoding to smart link detection, ensuring that your favorite content is always just a click away—all while maintaining absolute user anonymity.
- 🎥 Elite Quality Selection: Choose your preferred resolution, from 720p up to Ultra HD 4K.
- 🔄 Live Progress Tracking: Stay informed with real-time status updates including download percentage, size, and speed.
- ❌ Cancel Support: Abort any active download instantly with a single button click.
- 🧠 Smart Link Detection: Fetchy proactively notices media links in your channel and offers to assist immediately.
- 🎬 Full Format Support: High-quality MP4 video, high-fidelity MP3 audio, and high-res PNG pictures.
- 🧹 Daily Auto-Cleanup: Automated maintenance task that purges abandoned files to save disk space.
- 🛡️ URL Validation: Protects against invalid or malicious inputs before any download begins.
- 💬 Detailed Error Feedback: Human-friendly responses for private videos or unsupported platforms.
- ⚡ Asynchronous Engine: Non-blocking operations ensure the bot remains lightning-fast under load.
- 🛡️ Privacy First: Every interaction is ephemeral and anonymous. No tracking, no logs, just media.
- 🐳 Docker Powered: Fully containerized for easy deployment and zero-maintenance operation.
Fetchy is configured entirely via the .env file in the root directory:
| Key | Description | Default |
|---|---|---|
DISCORD_BOT_TOKEN |
Your Discord bot token. | (required) |
CHANNEL_ID |
The ID of the Discord channel for the dashboard. | (required) |
STATUS_ROTATION_SPEED |
Seconds between status changes. | 10 |
BASE_URL |
Public URL for large-file downloads. | http://YOUR_IP:8080 |
INSTAGRAM_USERNAME |
Instagram username for session auth. | (optional) |
LINK_REGEX |
Pattern for automatic link detection. | (Common platforms) |
The most efficient way to deploy Fetchy is via Docker.
-
Clone the Repository:
git clone https://github.com/CRZX1337/Fetchy cd Fetchy -
Configure Environment:
cp .env.example .env # Edit .env and supply your DISCORD_BOT_TOKEN -
Launch:
sudo docker compose up -d --build
For direct host execution:
-
Requirements:
- Python 3.11+
- FFmpeg (Must be in your system PATH)
-
Install:
pip install -r requirements.txt
-
Run:
python main.py
- Interactive Dashboard: Click a format button and follow the quality selection prompts.
- Auto-Detection: Simply drop a supported link (YouTube, TikTok, X, Instagram) into the channel, and Fetchy will prompt you for the next steps.
- Download: Your file is delivered via a private ephemeral message.
Fetchy is built on the shoulders of these incredible open-source projects:
- yt-dlp — The engine for media extraction!
- discord.py — The interface for Discord interactions!
- FFmpeg — The power behind media conversion and merging!
Developed with ❤️ by CRZX1337