https://github.com/imnotrei0x/reidl
reiDL - Multi-platform Video Downloader
https://github.com/imnotrei0x/reidl
desktop-application python tiktok-downloader twitter-downloader video-downloader youtube-downloader yt-dlp
Last synced: 3 months ago
JSON representation
reiDL - Multi-platform Video Downloader
- Host: GitHub
- URL: https://github.com/imnotrei0x/reidl
- Owner: imnotrei0x
- License: mit
- Created: 2025-03-14T05:18:37.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-03-14T09:10:51.000Z (3 months ago)
- Last Synced: 2025-03-14T10:22:45.028Z (3 months ago)
- Topics: desktop-application, python, tiktok-downloader, twitter-downloader, video-downloader, youtube-downloader, yt-dlp
- Language: Python
- Homepage:
- Size: 21.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# reiDL - A Video Downloader
reiDL was created out of frustration with unreliable video download websites that either don't work. This desktop application provides a dependable, free solution for downloading videos from YouTube, Twitter/X, and TikTok with a clean interface and robust functionality. Nothing more, nothing less.
## Features
- 🎥 **Multi-platform Support**:
- YouTube (including shorts)
- Twitter/X
- TikTok
- 🎬 **Format Selection**:
- HD/4K video quality options (platform dependent)
- High-quality audio extraction
- Automatic format detection
- ⏯️ **Download Management**:
- Pause/Resume downloads
- Cancel with automatic cleanup
- Progress tracking with size/percentage display
- 🔄 **Platform Detection**:
- Automatic URL type recognition
- Seamless switching between platforms
- Format caching for improved performance
- 🎨 **Simple UI**:
- Clean, dark-themed UI
- System tray integration
- Global hotkey support for quick access
- Customizable download location
## Quick Access & Convenience
- **Global Hotkey**: Press your configured hotkey (set in settings) to instantly show/hide the app from anywhere
- **System Tray**: The app minimizes to system tray instead of taskbar for clutter-free desktop
- **Always Ready**: Even when minimized, reiDL remains running and instantly accessible
- **Smart Focus**: When shown via hotkey, the app automatically appears on top of other windows
- **Persistent Settings**: Your download location, hotkey preferences, and other settings are saved between sessions
## Requirements
- Python 3.7+
- FFmpeg (included in releases or install separately)
- Required packages (install via pip):
```
customtkinter>=5.2.0
yt-dlp>=2024.5.31
Pillow>=10.0.0
keyboard>=0.13.5
pystray>=0.19.4
pynput>=1.7.6
pywin32>=305 (Windows only)
```
## Installation
### Option 1: Run from Source
1. Clone this repository:
```bash
git clone https://github.com/yourusername/reidl.git
cd reidl
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Run the application:
```bash
python reidl_ui.py
```
## Usage Guide
1. **Launch the application** - Either run from source or use the executable
2. **Paste a URL** - Support for YouTube, Twitter/X, and TikTok
3. **Select quality options** - Choose from available video and audio qualities
4. **Download** - Click the Download button to start
5. **Manage downloads** - Pause, resume or cancel as needed
6. **Access quickly** - Use the configurable global hotkey to show/hide the app
## Technical Details
reiDL uses yt-dlp under the hood, providing:
- Adaptive format selection based on platform
- Reliable downloading with error handling
- Proper handling of platform-specific URLs and formats
- Efficient cleanup of partial files on cancellation
- Thread-based downloading for responsive UI
## Configuration
- Settings are stored in `config.json`
- Default download location: User's Downloads folder
- Global hotkey configurable through the settings menu (⚙️)
- Automatic filename generation based on platform
## Troubleshooting
- **File Format Issues**: Make sure FFmpeg is installed or included
- **Download Failures**: Check your internet connection or try a different format
- **Platform Support**: If a platform changes its API, update yt-dlp to the latest version
## Author
- [@imnotrei0x](https://x.com/imnotrei0x)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.