uDownloader 0.1.0__tar.gz

udownloader-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 uDownloader Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

udownloader-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include youdownload *.py

udownloader-0.1.0/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: uDownloader
+Version: 0.1.0
+Summary: Fast, async YouTube/Instagram/TikTok downloader with desktop GUI and CLI
+Author: Developer
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/uDownloader
+Project-URL: Documentation, https://github.com/yourusername/uDownloader#readme
+Project-URL: Repository, https://github.com/yourusername/uDownloader.git
+Project-URL: Issues, https://github.com/yourusername/uDownloader/issues
+Keywords: youtube,instagram,downloader,video,audio,desktop
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp>=2024.8.2
+Requires-Dist: PyQt6>=6.6.0
+Provides-Extra: cli
+Provides-Extra: desktop
+Requires-Dist: PyQt6>=6.6.0; extra == "desktop"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=24.8.0; extra == "dev"
+Requires-Dist: ruff>=0.15.0; extra == "dev"
+Dynamic: license-file
+
+# uDownloader
+
+[![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)
+[![Version 0.1.0](https://img.shields.io/badge/version-0.1.0-green)](./docs/CHANGELOG.md)
+[![License MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![GitHub CI/CD](https://github.com/yourusername/uDownloader/workflows/Tests/badge.svg)](https://github.com/yourusername/uDownloader/actions)
+
+A fast, powerful Python application to download YouTube videos or audio. Supports single videos or entire playlists with both CLI and **Desktop GUI**. Uses `yt-dlp` for efficiency and modern format handling.
+
+**Available as a pip-installable package!** Install with `pip install udownloader`
+
+## Features
+
+### Core Features
+- Download video or audio from YouTube, Instagram, TikTok, Twitter, and more
+- Process single content or playlists
+- Command-line interface with quality and format options
+- Configuration file support with sensible defaults
+- Detailed progress reporting during downloads
+- Automatic retry logic for failed downloads
+- Platform-specific organization (YouTube, Instagram, Twitter, TikTok, etc.)
+
+### Desktop Application
+- **Modern PyQt6 GUI** for intuitive downloading
+- **Async/Concurrent Downloads** - download multiple videos simultaneously
+- **Download History Tracking** - view all past downloads with statistics
+- **Live Progress Monitoring** - track active downloads in real-time
+- **Queue Management** - manage multiple downloads at once
+- **Settings Panel** - configure quality, output, retries, and concurrent limits
+
+## Installation
+
+### Option 1: Install via pip (Recommended)
+
+```bash
+# From PyPI (when published)
+pip install udownloader
+
+# Or install from source (development mode)
+git clone <repository-url>
+cd uDownloader
+pip install -e .
+```
+
+### Option 2: Manual installation from source
+
+```bash
+git clone <repository-url>
+cd uDownloader
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+```
+
+After installation, you'll have two commands available:
+- `udownloader` - CLI version
+- `udownloader-desktop` - Desktop GUI version
+
+
+## Technology Stack
+
+| Component | Technology | Purpose |
+|-----------|-----------|---------|
+| **Language** | Python 3.8+ | Core application |
+| **Video Downloading** | yt-dlp 2024.8.2+ | Format detection & download |
+| **Desktop GUI** | PyQt6 6.6.0+ | Modern graphical interface |
+| **Async Processing** | asyncio + ThreadPoolExecutor | Concurrent downloads |
+| **Configuration** | JSON | User settings persistence |
+| **History Tracking** | JSON | Download records database |
+| **Testing** | pytest + pytest-cov | Unit testing & coverage |
+| **Code Quality** | black + flake8 | Formatting & linting |
+| **Packaging** | setuptools + wheel | PyPI distribution |
+| **CI/CD** | GitHub Actions | Automated testing & publishing |
+
+**Key Dependencies:**
+- `yt-dlp` - Video downloading engine
+- `PyQt6` - Desktop application framework
+- `pytest` - Testing framework (dev only)
+- `black` - Code formatter (dev only)
+- `flake8` - Code linter (dev only)
+
+## Quick Start
+
+### CLI Mode
+
+```bash
+# Initialize config file (creates ~/.uDownloader/config.json)
+udownloader --init-config
+
+# Download best quality video
+udownloader --url https://youtube.com/watch?v=VIDEO_ID
+
+# Download as MP3 audio only
+udownloader --url https://youtube.com/watch?v=VIDEO_ID --audio
+
+# Download specific quality (best, 1080p, 720p, 480p, 360p)
+udownloader --url https://youtube.com/watch?v=VIDEO_ID --quality 720p
+
+# Download entire playlist to custom location
+udownloader --url https://youtube.com/playlist?list=PLAYLIST_ID --output ~/Downloads --retries 5
+
+# Verbose logging for debugging
+udownloader --url https://youtube.com/watch?v=VIDEO_ID --verbose
+```
+
+### Desktop Application
+
+```bash
+# Launch desktop app (from installed package)
+udownloader-desktop
+
+# Or if running from source directory
+python launcher_desktop.py
+```
+
+**Features in Desktop App:**
+- **Download Tab**: Paste URLs and start downloads with quality selection
+- **Queue Tab**: Monitor active downloads in real-time
+- **History Tab**: View all previous downloads with details
+- **Statistics Tab**: See download stats by platform and overall success rate
+- **Settings**: Configure output directory, quality, concurrent limits, and retry attempts
+
+## Configuration
+
+The configuration file is automatically created at `~/.uDownloader/config.json` when you run `--init-config`.
+
+### Default Settings:
+```json
+{
+    "output_dir": "uDownload",
+    "audio_only": false,
+    "video_quality": "best",
+    "audio_quality": "192",
+    "format_preference": "mp4",
+    "max_concurrent_downloads": 1,
+    "timeout": 300,
+    "retries": 3,
+    "verbose": false
+}
+```
+
+You can edit this file directly to change defaults, or override with command-line arguments (CLI) or settings dialog (Desktop app).
+
+## Command-line Options
+
+```
+--url URL, -u URL              YouTube video or playlist URL (required for downloads)
+--output OUTPUT, -o OUTPUT     Directory to save downloads (default: config or 'uDownload')
+--audio, -a                    Download audio only (mp3)
+--quality {best,1080p,720p,480p,360p}  Video quality preference
+--config CONFIG, -c CONFIG     Path to custom config file
+--init-config                  Create default config file and exit
+--retries RETRIES, -r RETRIES  Number of retries on failure (default: 3)
+--verbose, -v                  Show detailed logging
+--help, -h                     Show help message
+```
+
+## Architecture
+
+### Modules
+- **`cli.py`** - Command-line interface
+- **`downloader.py`** - Single download handler
+- **`async_downloader.py`** - Async/concurrent download manager
+- **`desktop.py`** - PyQt6 desktop GUI application
+- **`history.py`** - Download history tracking and statistics
+- **`config.py`** - Configuration management
+
+### Key Features in Code
+- **`AsyncDownloader`** class handles concurrent downloads using ThreadPoolExecutor
+- **`DownloadHistory`** class manages download records in JSON format
+- **`uDownloaderApp`** is the main desktop application with multi-tab interface
+- **`DownloadWorker`** runs downloads in separate thread to keep UI responsive
+
+## Documentation
+
+Comprehensive documentation is available in the [docs](docs/) folder:
+
+- **[Installation Guide](docs/INSTALLATION.md)** - Platform-specific installation instructions
+- **[Quick Reference](docs/QUICK_REFERENCE.md)** - Commands, workflows, and FAQ
+- **[Contributing Guide](docs/CONTRIBUTING.md)** - Development setup and contribution guidelines
+- **[CI/CD Setup](docs/CICD_SETUP.md)** - GitHub Actions and testing infrastructure
+- **[Changelog](docs/CHANGELOG.md)** - Version history and planned features
+- **[Security Policy](docs/SECURITY.md)** - Vulnerability reporting and security practices
+
+## License
+
+uDownloader is licensed under the MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+**Made with ❤️ for video downloaders everywhere**

udownloader-0.1.0/README.md

@@ -0,0 +1,191 @@
+# uDownloader
+
+[![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)
+[![Version 0.1.0](https://img.shields.io/badge/version-0.1.0-green)](./docs/CHANGELOG.md)
+[![License MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![GitHub CI/CD](https://github.com/yourusername/uDownloader/workflows/Tests/badge.svg)](https://github.com/yourusername/uDownloader/actions)
+
+A fast, powerful Python application to download YouTube videos or audio. Supports single videos or entire playlists with both CLI and **Desktop GUI**. Uses `yt-dlp` for efficiency and modern format handling.
+
+**Available as a pip-installable package!** Install with `pip install udownloader`
+
+## Features
+
+### Core Features
+- Download video or audio from YouTube, Instagram, TikTok, Twitter, and more
+- Process single content or playlists
+- Command-line interface with quality and format options
+- Configuration file support with sensible defaults
+- Detailed progress reporting during downloads
+- Automatic retry logic for failed downloads
+- Platform-specific organization (YouTube, Instagram, Twitter, TikTok, etc.)
+
+### Desktop Application
+- **Modern PyQt6 GUI** for intuitive downloading
+- **Async/Concurrent Downloads** - download multiple videos simultaneously
+- **Download History Tracking** - view all past downloads with statistics
+- **Live Progress Monitoring** - track active downloads in real-time
+- **Queue Management** - manage multiple downloads at once
+- **Settings Panel** - configure quality, output, retries, and concurrent limits
+
+## Installation
+
+### Option 1: Install via pip (Recommended)
+
+```bash
+# From PyPI (when published)
+pip install udownloader
+
+# Or install from source (development mode)
+git clone <repository-url>
+cd uDownloader
+pip install -e .
+```
+
+### Option 2: Manual installation from source
+
+```bash
+git clone <repository-url>
+cd uDownloader
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+```
+
+After installation, you'll have two commands available:
+- `udownloader` - CLI version
+- `udownloader-desktop` - Desktop GUI version
+
+
+## Technology Stack
+
+| Component | Technology | Purpose |
+|-----------|-----------|---------|
+| **Language** | Python 3.8+ | Core application |
+| **Video Downloading** | yt-dlp 2024.8.2+ | Format detection & download |
+| **Desktop GUI** | PyQt6 6.6.0+ | Modern graphical interface |
+| **Async Processing** | asyncio + ThreadPoolExecutor | Concurrent downloads |
+| **Configuration** | JSON | User settings persistence |
+| **History Tracking** | JSON | Download records database |
+| **Testing** | pytest + pytest-cov | Unit testing & coverage |
+| **Code Quality** | black + flake8 | Formatting & linting |
+| **Packaging** | setuptools + wheel | PyPI distribution |
+| **CI/CD** | GitHub Actions | Automated testing & publishing |
+
+**Key Dependencies:**
+- `yt-dlp` - Video downloading engine
+- `PyQt6` - Desktop application framework
+- `pytest` - Testing framework (dev only)
+- `black` - Code formatter (dev only)
+- `flake8` - Code linter (dev only)
+
+## Quick Start
+
+### CLI Mode
+
+```bash
+# Initialize config file (creates ~/.uDownloader/config.json)
+udownloader --init-config
+
+# Download best quality video
+udownloader --url https://youtube.com/watch?v=VIDEO_ID
+
+# Download as MP3 audio only
+udownloader --url https://youtube.com/watch?v=VIDEO_ID --audio
+
+# Download specific quality (best, 1080p, 720p, 480p, 360p)
+udownloader --url https://youtube.com/watch?v=VIDEO_ID --quality 720p
+
+# Download entire playlist to custom location
+udownloader --url https://youtube.com/playlist?list=PLAYLIST_ID --output ~/Downloads --retries 5
+
+# Verbose logging for debugging
+udownloader --url https://youtube.com/watch?v=VIDEO_ID --verbose
+```
+
+### Desktop Application
+
+```bash
+# Launch desktop app (from installed package)
+udownloader-desktop
+
+# Or if running from source directory
+python launcher_desktop.py
+```
+
+**Features in Desktop App:**
+- **Download Tab**: Paste URLs and start downloads with quality selection
+- **Queue Tab**: Monitor active downloads in real-time
+- **History Tab**: View all previous downloads with details
+- **Statistics Tab**: See download stats by platform and overall success rate
+- **Settings**: Configure output directory, quality, concurrent limits, and retry attempts
+
+## Configuration
+
+The configuration file is automatically created at `~/.uDownloader/config.json` when you run `--init-config`.
+
+### Default Settings:
+```json
+{
+    "output_dir": "uDownload",
+    "audio_only": false,
+    "video_quality": "best",
+    "audio_quality": "192",
+    "format_preference": "mp4",
+    "max_concurrent_downloads": 1,
+    "timeout": 300,
+    "retries": 3,
+    "verbose": false
+}
+```
+
+You can edit this file directly to change defaults, or override with command-line arguments (CLI) or settings dialog (Desktop app).
+
+## Command-line Options
+
+```
+--url URL, -u URL              YouTube video or playlist URL (required for downloads)
+--output OUTPUT, -o OUTPUT     Directory to save downloads (default: config or 'uDownload')
+--audio, -a                    Download audio only (mp3)
+--quality {best,1080p,720p,480p,360p}  Video quality preference
+--config CONFIG, -c CONFIG     Path to custom config file
+--init-config                  Create default config file and exit
+--retries RETRIES, -r RETRIES  Number of retries on failure (default: 3)
+--verbose, -v                  Show detailed logging
+--help, -h                     Show help message
+```
+
+## Architecture
+
+### Modules
+- **`cli.py`** - Command-line interface
+- **`downloader.py`** - Single download handler
+- **`async_downloader.py`** - Async/concurrent download manager
+- **`desktop.py`** - PyQt6 desktop GUI application
+- **`history.py`** - Download history tracking and statistics
+- **`config.py`** - Configuration management
+
+### Key Features in Code
+- **`AsyncDownloader`** class handles concurrent downloads using ThreadPoolExecutor
+- **`DownloadHistory`** class manages download records in JSON format
+- **`uDownloaderApp`** is the main desktop application with multi-tab interface
+- **`DownloadWorker`** runs downloads in separate thread to keep UI responsive
+
+## Documentation
+
+Comprehensive documentation is available in the [docs](docs/) folder:
+
+- **[Installation Guide](docs/INSTALLATION.md)** - Platform-specific installation instructions
+- **[Quick Reference](docs/QUICK_REFERENCE.md)** - Commands, workflows, and FAQ
+- **[Contributing Guide](docs/CONTRIBUTING.md)** - Development setup and contribution guidelines
+- **[CI/CD Setup](docs/CICD_SETUP.md)** - GitHub Actions and testing infrastructure
+- **[Changelog](docs/CHANGELOG.md)** - Version history and planned features
+- **[Security Policy](docs/SECURITY.md)** - Vulnerability reporting and security practices
+
+## License
+
+uDownloader is licensed under the MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+**Made with ❤️ for video downloaders everywhere**

udownloader-0.1.0/pyproject.toml

@@ -0,0 +1,73 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "uDownloader"
+version = "0.1.0"
+description = "Fast, async YouTube/Instagram/TikTok downloader with desktop GUI and CLI"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [{name = "Developer"}]
+keywords = ["youtube", "instagram", "downloader", "video", "audio", "desktop"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: X11 Applications :: Qt",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Utilities",
+]
+
+dependencies = [
+    "yt-dlp>=2024.8.2",
+    "PyQt6>=6.6.0",
+]
+
+[project.optional-dependencies]
+cli = []
+desktop = ["PyQt6>=6.6.0"]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "black>=24.8.0",
+    "ruff>=0.15.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/uDownloader"
+Documentation = "https://github.com/yourusername/uDownloader#readme"
+Repository = "https://github.com/yourusername/uDownloader.git"
+Issues = "https://github.com/yourusername/uDownloader/issues"
+
+[project.scripts]
+udownloader = "youdownload.cli:main"
+udownloader-desktop = "youdownload.desktop:main"
+
+[tool.setuptools]
+packages = ["youdownload"]
+
+[tool.setuptools.package-data]
+youdownload = []
+
+[tool.black]
+line-length = 100
+target-version = ['py38', 'py39', 'py310', 'py311', 'py312']
+
+[tool.ruff]
+line-length = 100
+target-version = "py38"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W"]  # pycodestyle, Pyflakes, warnings

udownloader-0.1.0/requirements.txt

@@ -0,0 +1,2 @@
+yt-dlp>=2024.8.2
+PyQt6>=6.6.0

udownloader-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

udownloader-0.1.0/setup.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python3
+"""
+Setup script for uDownloader.
+Modern approach using pyproject.toml is preferred.
+This file exists for compatibility.
+"""
+
+from setuptools import setup
+
+setup()

udownloader-0.1.0/tests/test_udownloader.py

@@ -0,0 +1,149 @@
+"""Tests for youdownload package."""
+
+import pytest
+from youdownload import __version__
+from youdownload.config import load_config, DEFAULT_CONFIG
+from youdownload.history import DownloadHistory
+from youdownload.async_downloader import AsyncDownloader
+from pathlib import Path
+import tempfile
+
+
+class TestVersion:
+    """Test package version."""
+
+    def test_version_exists(self):
+        """Test that version is defined."""
+        assert __version__ is not None
+        assert isinstance(__version__, str)
+
+    def test_version_format(self):
+        """Test version follows semantic versioning."""
+        parts = __version__.split(".")
+        assert len(parts) >= 2
+
+
+class TestConfig:
+    """Test configuration management."""
+
+    def test_default_config_structure(self):
+        """Test default config has required keys."""
+        required_keys = [
+            "output_dir",
+            "audio_only",
+            "video_quality",
+            "audio_quality",
+            "max_concurrent_downloads",
+            "retries",
+        ]
+        for key in required_keys:
+            assert key in DEFAULT_CONFIG
+
+    def test_load_config_with_no_file(self):
+        """Test loading config returns defaults when no file exists."""
+        # Use temp file that doesn't exist
+        config = load_config("/tmp/nonexistent_config_12345.json")
+        assert config["output_dir"] == "uDownload"
+        assert config["video_quality"] == "best"
+
+
+class TestHistory:
+    """Test download history tracking."""
+
+    def test_history_initialization(self):
+        """Test history object initializes correctly."""
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+            history_file = Path(f.name)
+
+        try:
+            history = DownloadHistory(history_file)
+            assert history.history_file == history_file
+            assert history_file.exists()
+        finally:
+            if history_file.exists():
+                history_file.unlink()
+
+    def test_add_and_get_history(self):
+        """Test adding and retrieving history."""
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+            history_file = Path(f.name)
+
+        try:
+            history = DownloadHistory(history_file)
+
+            record = {
+                "title": "Test Video",
+                "platform": "YouTube",
+                "url": "https://youtube.com/watch?v=test",
+                "success": True,
+            }
+
+            history.add_download(record)
+            records = history.get_history()
+
+            assert len(records) > 0
+            assert records[0]["title"] == "Test Video"
+        finally:
+            if history_file.exists():
+                history_file.unlink()
+
+    def test_get_stats(self):
+        """Test statistics calculation."""
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+            history_file = Path(f.name)
+
+        try:
+            history = DownloadHistory(history_file)
+
+            # Add test records
+            history.add_download(
+                {
+                    "title": "Video 1",
+                    "platform": "YouTube",
+                    "url": "https://example.com",
+                    "success": True,
+                }
+            )
+            history.add_download(
+                {
+                    "title": "Video 2",
+                    "platform": "Instagram",
+                    "url": "https://example.com",
+                    "success": False,
+                }
+            )
+
+            stats = history.get_stats()
+            assert stats["total_downloads"] == 2
+            assert stats["successful"] == 1
+            assert stats["failed"] == 1
+        finally:
+            if history_file.exists():
+                history_file.unlink()
+
+
+class TestAsyncDownloader:
+    """Test async downloader."""
+
+    def test_initialization(self):
+        """Test AsyncDownloader initializes correctly."""
+        downloader = AsyncDownloader(max_concurrent=2)
+        assert downloader.max_concurrent == 2
+        assert downloader.executor is not None
+
+    def test_platform_detection(self):
+        """Test platform detection."""
+        downloader = AsyncDownloader()
+
+        assert downloader.detect_platform("https://youtube.com/watch?v=test") == "YouTube"
+        assert downloader.detect_platform("https://youtu.be/test") == "YouTube"
+        assert downloader.detect_platform("https://instagram.com/p/test") == "Instagram"
+        assert downloader.detect_platform("https://tiktok.com/@user/video/123") == "TikTok"
+        assert downloader.detect_platform("https://twitter.com/user/status/123") == "Twitter"
+        assert downloader.detect_platform("https://x.com/user/status/123") == "Twitter"
+        assert downloader.detect_platform("https://vimeo.com/123") == "Vimeo"
+        assert downloader.detect_platform("https://facebook.com/video/123") == "Facebook"
+
+
+if __name__ == "__main__":
+    pytest.main([__file__, "-v"])