Snatch

Download Anything, Anywhere, Anytime

Features • Installation • Quick Start • Usage • Supported Sites • Troubleshooting

What's New in v1.8.0

🎯 Major New Features & Enhancements

🎵 Comprehensive Audio Enhancement System

AI-Powered Audio Enhancement: Advanced noise reduction, frequency extension, and stereo widening
Professional Audio Presets: 5 curated presets (podcast, music, speech, broadcast, restoration)
Sample Rate Upscaling: Intelligent upsampling to higher quality audio
Dynamic Range Processing: Professional loudness normalization and compression
Audio Quality Analysis: Automatic preset recommendations based on content analysis
CLI Integration: Complete command-line interface for audio enhancement

🔧 Fixed Resolution Selection Bug

RESOLVED: Resolution flags (--resolution, -r) now work correctly
IMPACT: When requesting 2160p/4K, system now properly selects the highest available quality
IMPROVEMENT: Enhanced format string generation with proper fallback chains

🚀 AI-Powered Video Upscaling

NEW: Real-ESRGAN integration for AI-enhanced video quality
METHODS: Support for both AI (Real-ESRGAN) and traditional (Lanczos, Bicubic) upscaling
FLEXIBLE: 2x and 4x upscaling factors with quality preservation options
EFFICIENT: Optimized processing pipeline with progress tracking

🎮 Interactive Mode Enhancements

Enhanced UI: Modern Textual-based interface with rich components
Audio Processing: Built-in audio conversion and enhancement tools
File Management: Advanced file organization and management features
Real-time Processing: Background audio/video processing with progress tracking

📚 Comprehensive Documentation

🎯 Features Update Guide - Detailed overview of new features
📖 Usage Guide - Complete command examples and workflows
🔧 Technical Documentation - Architecture and implementation details

Quick Examples:

# Fixed resolution selection (now works correctly)
snatch download "URL" --resolution 2160  # Actually gets 4K!

# AI video upscaling
snatch download "URL" --upscale --upscale-method realesrgan --upscale-factor 2

# Audio enhancement with presets
snatch audio enhance myfile.mp3 --preset music
snatch audio enhance podcast.wav --preset podcast --output enhanced_podcast.wav

# Audio quality analysis and recommendations
snatch audio analyze myfile.wav
snatch audio presets --detailed

# Batch audio processing
snatch audio batch "*.mp3" --preset restoration

# Combine resolution + upscaling for optimal results
snatch download "URL" --resolution 720 --upscale --upscale-factor 4 --replace-original

🎯 Major Architectural Overhaul

Complete Package Refactoring & Modularization

Modular Architecture: Split monolithic Snatch.py into a well-structured package under modules/:
- cli.py - Command-line interface and argument parsing
- manager.py - Core download management and orchestration
- config.py - Configuration loading, validation, and management
- audio_processor.py - Advanced audio enhancement and processing
- ffmpeg_helper.py - Video upscaling and FFmpeg processing
- p2p.py - Peer-to-peer networking and file sharing
- cache.py - Intelligent caching and metadata storage
- session.py - Network session management and optimization
- progress.py - Enhanced progress tracking and display
- utils.py - Shared utilities and helper functions
- plugins.py - Plugin system and hook management
- logging_config.py - Comprehensive logging configuration
- constants.py - Application constants and defaults
- metadata.py - Media information extraction and processing
- cyberpunk_ui.py - Cyberpunk-themed UI components

Enhanced Plugin System

Hook-Based Architecture: Comprehensive plugin system with multiple hook points
Plugin Interfaces: Support for DownloadHooks, ProcessingPlugin, and UIPlugin
Dynamic Loading: Automatic plugin discovery and registration
Event System: Pre/post download hooks, format processing, and UI customization

Advanced Audio Processing

AI-Enhanced Audio: Intelligent audio enhancement using machine learning algorithms
Multi-Format Support: Opus, MP3, FLAC, WAV, and M4A with quality optimization
Audio Normalization: Automatic loudness normalization and dynamic range processing
Surround Sound: Support for stereo and 7.1 surround sound configurations

Peer-to-Peer Networking

P2P File Sharing: Share downloaded content directly with other users
Share Code System: Generate unique codes for easy file sharing
Network Discovery: Automatic peer discovery and connection management
Distributed Caching: Leverage peer network for faster downloads

🚀 Performance & User Experience Improvements

Smart Performance Optimization

Adaptive Resource Management: Dynamic chunk sizes based on system resources
Network Speed Testing: Automatic optimization based on connection speed
Smart Format Selection: Intelligent format selection without testing all possibilities
Concurrent Processing: Enhanced multi-threaded download and processing

Enhanced User Interface

Cyberpunk Theme: Futuristic, neon-styled interface with animations
Interactive Progress: Real-time progress bars with detailed statistics
Spinner Animations: Enhanced visual feedback during operations
Rich Console Output: Color-coded messages and status indicators

Improved Error Handling & Recovery

Intelligent Retry Logic: Exponential backoff with smart failure recovery
Detailed Error Messages: Actionable error descriptions with solutions
Advanced Logging: Comprehensive logging with configurable verbosity levels
Graceful Degradation: Fallback mechanisms for various failure scenarios

📚 Comprehensive Documentation Suite

We've created an extensive documentation ecosystem to support developers and users:

📖 Technical Documentation

Complete system architecture overview with visual diagrams
Component interaction flows and data flow analysis
Dependency relationships and module hierarchies
Comprehensive file structure documentation

🔧 Module Documentation

In-depth analysis of all core modules
Function signatures, parameters, and return values
Usage examples and best practices
Module interaction patterns

🔌 Plugin Development Guide

Complete plugin architecture documentation
Hook system explanation with practical examples
Plugin registration and lifecycle management
Sample plugin implementations

📋 API Reference

Comprehensive API documentation
Method signatures with detailed parameters
Error handling and return codes
Usage examples for all major functions

🚀 Deployment Guide

Development environment setup
Production deployment strategies
Docker containerization
Platform-specific installation guides
Security considerations and best practices

⚡ Performance Optimization Guide

System resource optimization strategies
Network performance tuning
Memory and CPU optimization techniques
Caching strategies and storage optimization
Platform-specific performance tips

🔍 Troubleshooting Guide

Quick diagnostic procedures
Common issues and solutions
Platform-specific troubleshooting
Error codes reference
Advanced debugging techniques

🧪 Integration Testing

Comprehensive testing strategies
Test suite documentation
Continuous integration setup
Quality assurance procedures

🛠️ Technical Improvements

Code Architecture Enhancements

Circular Dependency Resolution: Eliminated circular dependencies for better stability
Import Optimization: Improved import hygiene and reduced startup times
Memory Management: Enhanced memory efficiency and garbage collection
Type Safety: Comprehensive type hints and validation

Configuration Management

Flexible Configuration: JSON-based configuration with validation
Environment Variables: Support for environment-based configuration
Profile System: Multiple configuration profiles for different use cases
Dynamic Reloading: Hot-reload configuration changes without restart

Security & Reliability

Input Validation: Comprehensive input sanitization and validation
Secure Networking: Enhanced SSL/TLS handling and certificate validation
Rate Limiting: Intelligent rate limiting to prevent API abuse
Crash Recovery: Automatic crash detection and recovery mechanisms

🚀 Overview

Snatch is a powerful and user-friendly media downloader that lets you grab videos, audio, and more from hundreds of websites in various formats and qualities. With its sleek interface, comprehensive customization system, and powerful features, downloading media has never been easier or more satisfying!

✨ Features

🎨 Comprehensive Customization System

8 Built-in Themes - Default, Dark, Light, High Contrast, Cyberpunk, Minimal, Ocean, and Forest themes
3 Interactive Interfaces - Enhanced, Modern, and Textual TUI modes with rich interface options
Performance Tuning - Fine-tune download speeds, connection limits, memory usage, and resource management
Behavior Customization - Configure confirmations, auto-organization, session management, and error handling
Interface Personalization - Customize progress styles, keyboard shortcuts, display options, and accessibility features
Command Aliases - Create custom shortcuts for frequently used commands
Profile System - Save and switch between different configuration profiles
Import/Export Settings - Share configurations in YAML, JSON, or TOML formats

🖥️ Enhanced Interactive Modes

Cyberpunk Interface - Futuristic themed interface with neon aesthetics and advanced features
Modern Interface - Clean, contemporary design with intuitive controls and beautiful animations
Textual TUI - Advanced terminal user interface with rich components and responsive design
Enhanced CLI - Rich-powered command line with syntax highlighting and interactive prompts

🎯 Core Download Features

Fixed Resolution Selection - Properly working --resolution/-r flags for accurate quality selection
AI Video Upscaling - Enhance video quality with Real-ESRGAN or traditional upscaling methods (2x/4x)
Dynamic Resource Management - Adaptive chunk sizes based on your system's resources
Site Explorer - Browse and search through 1000+ supported sites
Advanced Audio Options - Choose between Opus (default), MP3, FLAC formats and stereo/surround sound
Smart Conversion - High-quality audio extraction with format options
Concurrent Downloads - Download multiple files simultaneously
Quality Selection - Choose specific video resolutions with reliable format selection
Video Enhancement - Upscale videos with configurable factors (2x, 4x) and quality preservation
Playlist Support - Download entire playlists with options to select specific videos
Cache System - Optimized repeat downloads with smart caching
Error Recovery - Robust error handling and helpful suggestions
Format Flexibility - Video, Opus, MP3, FLAC, WAV, and more
Universal Compatibility - Works on Windows, macOS, and Linux
Automatic File Organization - Organize downloads based on metadata
Resume Downloads - Continue interrupted downloads from where they left off
Download Statistics - Track and display download performance metrics
aria2c Support - Optional high-speed download engine for better performance
Network Speed Testing - Automatically optimize settings based on your connection speed
Smart Format Selection - Intelligently selects best format without testing all possibilities
Temporary File Management - Advanced handling of temporary files to prevent disk space waste

🎨 Customization System

Snatch features a comprehensive customization system that allows you to personalize every aspect of the application to match your preferences and workflow.

🎭 Theme Management

Available Themes:

default - Standard Snatch appearance
dark - Dark mode with comfortable contrast
light - Clean light theme
high_contrast - Enhanced visibility for accessibility
cyberpunk - Futuristic neon aesthetics
minimal - Clean, distraction-free interface
ocean - Calming blue tones
forest - Nature-inspired green palette

Quick Theme Commands:

# View current theme
snatch customize theme show

# List all available themes
snatch customize theme list

# Switch themes
snatch customize theme set --theme cyberpunk
snatch customize theme set --theme dark

# Create custom theme with JSON colors
snatch customize theme create --colors '{"primary": "#ff0000", "secondary": "#00ff00"}'

🖥️ Interactive Interface Modes

Launch Snatch with different interface experiences:

# Enhanced interactive mode (default)
snatch interactive

# Modern beautiful interface
snatch modern

# Advanced Textual TUI
snatch textual

# Direct cyberpunk-themed interface
snatch  # Uses current theme setting

⚙️ Performance Customization

Fine-tune performance settings for optimal downloads:

# View all performance settings
snatch customize performance --show

# Adjust concurrent downloads
snatch customize performance --setting max_concurrent_downloads --value 8

# Set bandwidth limits (0 = unlimited)
snatch customize performance --setting global_bandwidth_limit --value 1000

# Configure memory usage
snatch customize performance --setting max_memory_usage_mb --value 1024

# Optimize chunk sizes for your connection
snatch customize performance --setting chunk_size --value 2097152

🎛️ Interface Personalization

Customize the interface to your preferences:

# Show interface settings
snatch customize interface --show

# Enable detailed interface mode
snatch customize interface --setting interface_mode --value detailed

# Customize progress animations
snatch customize interface --setting animate_progress --value true

# Set display limits
snatch customize interface --setting max_display_items --value 100

🎯 Behavior Configuration

Control how Snatch behaves during operations:

# View behavior settings
snatch customize behavior --show

# Configure file overwrite confirmations
snatch customize behavior --setting confirm_file_overwrite --value true

# Auto-organize downloads by type
snatch customize behavior --setting auto_organize_downloads --value true

# Set large download threshold (MB)
snatch customize behavior --setting large_download_threshold_mb --value 500

🔗 Command Aliases

Create shortcuts for frequently used commands:

# List current aliases
snatch customize alias list

# Add custom aliases
snatch customize alias add --alias "dl" --command "download"
snatch customize alias add --alias "4k" --command "download --resolution 2160"

# Remove aliases
snatch customize alias remove --alias "dl"

📁 Profile Management

Save and switch between different configuration profiles:

# List available profiles
snatch customize profile list

# Create new profile
snatch customize profile create --name "work"

# Load a profile
snatch customize profile load --name "work"

# Delete profile
snatch customize profile delete --name "old-profile"

📤 Import/Export Settings

Share configurations across devices or backup your settings:

# Export settings to YAML
snatch customize export my-settings.yaml

# Export to JSON format
snatch customize export my-settings.json --format json

# Import settings from file
snatch customize import my-settings.yaml

# Reset to defaults
snatch customize reset

🔧 Installation

Prerequisites

Before installing Snatch, make sure you have:

Python: Version 3.8 or higher

python --version  # Should show 3.8 or higher

Git: For cloning the repository

git --version  # Should show git version

FFmpeg: Required for audio/video processing
- Windows users can run setupfiles/setup_ffmpeg.py after installation
- Linux/macOS users can use their package manager

Step-by-Step Installation

Clone the Repository

git clone https://github.com/Rashed-alothman/Snatch.git
cd Snatch

Create a Virtual Environment

# Create a new virtual environment
python -m venv .venv

# Activate it:
# On Windows PowerShell:
.\.venv\Scripts\Activate.ps1
# On Windows CMD:
.\.venv\Scripts\activate.bat
# On Linux/macOS:
source .venv/bin/activate

Install Dependencies

# Install required packages
pip install -r setupfiles/requirements.txt

# Install Snatch in development mode
pip install -e .

Setup FFmpeg (Windows)

# Automatic FFmpeg setup for Windows
python setupfiles/setup_ffmpeg.py

Verify Installation
```
snatch --version
```

Quick Start Guide

Once installed, you can use Snatch in several ways:

Interactive Mode (Recommended)
```
snatch
```

Direct Download Commands

# Download video in best quality
snatch download "https://youtube.com/watch?v=example"

# Download audio only (Opus format)
snatch download "https://youtube.com/watch?v=example" --audio-only

# Download with specific format
snatch download "https://youtube.com/watch?v=example" --audio-only --format mp3

Common Operations

# List supported sites
snatch sites

# Check system info
snatch info

# Run speed test
snatch speedtest

# Show help
snatch --help

Configuration

The default configuration file is created at first run. You can customize it:

# Open config in default editor
snatch config edit

# Show current config
snatch config show

Updating

To update Snatch to the latest version:

git pull
pip install -e .

💻 Advanced Usage

Audio Downloads & Enhancement

# Download in Opus format (default, best quality-to-size)
snatch download "URL" --audio-only

# Download in MP3 format
snatch download "URL" --audio-only --format mp3

# Download in FLAC format with surround sound
snatch download "URL" --audio-only --format flac --channels 8

# Download with custom quality
snatch download "URL" --audio-only --format mp3 --quality 320

# Audio Enhancement Commands (NEW in v1.8.0)
# Enhance downloaded audio with AI-powered processing
snatch audio enhance "myfile.mp3" --preset music
snatch audio enhance "podcast.wav" --preset podcast --output "enhanced_podcast.wav"

# Analyze audio quality and get recommendations
snatch audio analyze "myfile.wav"

# List available enhancement presets
snatch audio presets --detailed

# Batch process multiple files
snatch audio batch "*.mp3" --preset restoration

# Create custom enhancement preset
snatch audio create-preset "my-preset" "Custom settings for my content"

Audio Enhancement Presets

Preset	Description	Best For
`podcast`	Speech optimization with noise reduction	Podcasts, interviews, voice recordings
`music`	Stereo enhancement and dynamic preservation	Music tracks, albums
`speech`	Strong noise reduction and clarity	Lectures, audiobooks, presentations
`broadcast`	Professional broadcast standards	Radio shows, professional content
`restoration`	Maximum enhancement for damaged audio	Old recordings, low-quality sources

Video Downloads & Enhancement

# Download in best quality
snatch download "URL"

# Download in specific resolution (FIXED: now works correctly)
snatch download "URL" --resolution 2160  # 4K/2160p
snatch download "URL" --resolution 1440  # 1440p
snatch download "URL" --resolution 1080  # 1080p
snatch download "URL" --resolution 720   # 720p

# Video upscaling with AI enhancement
snatch download "URL" --upscale --upscale-method realesrgan --upscale-factor 2

# Traditional upscaling methods
snatch download "URL" --upscale --upscale-method lanczos --upscale-factor 4
snatch download "URL" --upscale --upscale-method bicubic --upscale-factor 2

# High-quality upscaling with custom settings
snatch download "URL" --upscale --upscale-quality high --upscale-factor 2

# Replace original file after upscaling
snatch download "URL" --upscale --replace-original

# Download with custom format
snatch download "URL" --format mp4

# Download with subtitles
snatch download "URL" --subtitles

Upscaling Methods & Quality Options

Method	Description	Best For	Performance
`realesrgan`	AI-powered upscaling	Anime, cartoons, graphics	Slower, highest quality
`lanczos`	High-quality traditional	Live action, photographs	Medium speed, good quality
`bicubic`	Standard interpolation	General purpose	Fast, decent quality
`bilinear`	Basic interpolation	Quick processing	Fastest, lower quality

Upscaling Quality Presets:

low: Fast processing, basic enhancement
medium: Balanced quality and speed (default)
high: Maximum quality, slower processing

Upscaling Factors:

2: Double resolution (e.g., 1080p → 2160p)
4: Quadruple resolution (e.g., 720p → 2880p)

Advanced Features

# Resume interrupted download
snatch download "URL" --resume

# Use aria2c for faster downloads
snatch download "URL" --aria2c

# Show download statistics
snatch download "URL" --stats

# Save to specific directory
snatch download "URL" --output "D:\Downloads"

# Combine resolution selection with upscaling
snatch download "URL" --resolution 720 --upscale --upscale-factor 4

# Batch download from file
snatch batch urls.txt

# Download playlist with upscaling
snatch download "PLAYLIST_URL" --playlist --upscale

# Download with Real-ESRGAN upscaling and replace original
snatch download "URL" --upscale --upscale-method realesrgan --replace-original

New Video Enhancement CLI Options

Option	Short	Description	Example
`--upscale`	`-u`	Enable video upscaling	`--upscale`
`--upscale-method`		Upscaling method	`--upscale-method realesrgan`
`--upscale-factor`		Scale factor (2x, 4x)	`--upscale-factor 2`
`--upscale-quality`		Quality preset	`--upscale-quality high`
`--replace-original`		Replace source file	`--replace-original`
`--resolution`	`-r`	Target resolution (FIXED)	`--resolution 2160`

Interactive Mode Commands

When using interactive mode (snatch), you have access to these commands:

Command	Description	Example
`download`	Download media	`download https://youtube.com/...`
`queue`	Show active downloads	`queue`
`stats`	Show download statistics	`stats`
`speed`	Run speed test	`speed`
`config`	Show/edit configuration	`config edit`
`clear`	Clear screen	`clear`
`help`	Show help	`help`
`exit`	Exit application	`exit`

Environment Variables

Snatch respects these environment variables:

SNATCH_CONFIG: Custom config file location
SNATCH_OUTPUT: Default output directory
SNATCH_FFMPEG: FFmpeg binary location
SNATCH_CACHE: Cache directory location
SNATCH_LOG_LEVEL: Logging verbosity

Advanced Features

1. Playlist Downloads

When downloading a playlist, Snatch will present options to:

Download the entire playlist
Download only the first few videos
Select specific videos to download

2. Batch Downloads

Download multiple URLs at once:

python Snatch.py "URL1" "URL2" "URL3"

3. Custom Output Directory

python Snatch.py "URL" --output-dir "path/to/directory"

4. Format Specification

python Snatch.py "URL" --format-id 137+140  # For advanced users

5. Automatic File Organization

Snatch can automatically organize your downloaded files based on metadata extracted from the media. This creates a clean folder structure for your library.

Enable organization with:

python Snatch.py --organize URL

Or set it permanently in the configuration:

python setup_ffmpeg.py

Organization Templates

You can customize how files are organized using templates in the config:

Audio: {uploader}/{album}/{title}
Video: {uploader}/{year}/{title}
Podcast: Podcasts/{uploader}/{year}-{month}/{title}
Audiobook: Audiobooks/{uploader}/{title}

Available variables include:

{title} - Media title
{uploader} - Channel or uploader name
{album} - Album name (for music)
{artist} - Artist name
{year} - Release year
{month} - Release month
{day} - Release day
{track_number} - Track number

6. Advanced Audio Options

Snatch now offers enhanced audio conversion options:

Default Format: Opus audio format (superior quality-to-size ratio)
Channel Configuration:
- Interactive prompt to choose between stereo (2.0) and surround sound (7.1)
- Command-line option: --audio-channels 2 (stereo) or --audio-channels 8 (7.1)
Format Options:
- Opus: --audio-format opus (default, excellent quality at smaller file sizes)
- MP3: --audio-format mp3 (maximum compatibility)
- FLAC: --audio-format flac (lossless audio)
- WAV: --audio-format wav (uncompressed)
- M4A: --audio-format m4a (AAC audio)

# Download with 7.1 surround sound in Opus format
python Snatch.py "URL" --audio-only --audio-channels 8

# Skip interactive prompts (useful for scripting)
python Snatch.py "URL" --audio-only --non-interactive

7. Advanced Command-line Options

Snatch supports several advanced options for more control over your downloads:

# Resume interrupted downloads
python Snatch.py "URL" --resume

# Show download statistics after completion
python Snatch.py "URL" --stats

# Display system resource statistics
python Snatch.py "URL" --system-stats

# Skip using cached media information
python Snatch.py "URL" --no-cache

# Disable automatic retry logic
python Snatch.py "URL" --no-retry

# Limit download speed (e.g., 2M = 2MB/s)
python Snatch.py "URL" --throttle 2M

# Use aria2c as the download engine for better performance
python Snatch.py "URL" --aria2c

# Enable detailed logging for troubleshooting
python Snatch.py "URL" --verbose

# Test all available formats for best quality (slower)
python Snatch.py "URL" --test-formats

# Use fast format selection (default)
python Snatch.py "URL" --fast

8. Network Speed Testing

Snatch can automatically test your network speed to optimize download settings:

# Run a standalone speed test
python Snatch.py speedtest

# Get detailed speed test results
python Snatch.py test

🏗️ Technical Architecture

Modular Design: Core functionality is split into logical modules for maintainability
- common_utils.py: Shared utilities and helper functions
- manager.py: Download orchestration and resource management
- progress.py: Advanced progress tracking and display
- session.py: Network session handling and speed optimization
- metadata.py: Media information extraction and processing
Performance Optimizations:
- Smart caching of download information
- Concurrent downloads with resource monitoring
- Intelligent format selection without testing all possibilities
- Network speed-aware chunk size optimization
Error Handling:
- Graceful recovery from network issues
- Smart retry logic with exponential backoff
- Detailed logging for troubleshooting
- Memory-efficient operation

📊 Performance Insights

Feature	Before	After
Startup Time	~2.5s	~0.8s
Memory Usage	150-200MB	80-120MB
Download Speed*	5-10MB/s	15-25MB/s
CPU Usage	25-30%	10-15%

*With aria2c enabled on a gigabit connection

🌎 Supported Sites

Snatch supports over 1000 websites including:

YouTube
Vimeo
Twitter/X
Instagram
TikTok
Facebook
Twitch
SoundCloud
Reddit
Daily Motion
And many more!

To see the full list of supported sites:

python Snatch.py --list-sites

🔍 Troubleshooting

Common Issues

FFmpeg not found

python setup_ffmpeg.py  # Run this to fix automatically

SSL Errors
- Update Python and dependencies:
```
pip install -U yt-dlp requests
```
Permission Errors
- Run as administrator (Windows)
- Use sudo (Linux/macOS)
Slow Downloads
- Check your internet connection
- Try with --aria2c for faster downloading
- Use --http-chunk-size 10485760 for larger chunks

Need Help?

If you're still having issues:

Check the logs in download_log.txt
Run with --verbose for detailed output
Try --system-stats to check if your system has enough resources

🤝 Contributing

Contributions are welcome! Feel free to:

Report bugs
Suggest new features
Submit pull requests

🗺️ Feature Roadmap

📦 Core Architecture & Packaging

✅ Modular package structure under modules/
✅ modules/__init__.py with __version__ and public API
✅ Basic setup.py configuration
✅ Editable install support
⬜ PyPI packaging and distribution

🛠️ Logging & Configuration

✅ Root logger with rich formatting
✅ Module-level logging
✅ Color-coded console output
✅ Basic configuration management
⬜ Profile-based configs

🎛️ Interactive Experience

✅ Modern rich UI interface
✅ Command history
✅ Tab completion
✅ Format selection
✅ Download progress tracking
⬜ Playlist management

⚙️ Download Features

✅ Audio/video downloads
✅ Format selection
✅ Resolution control
✅ Download resumption
✅ Network optimization
⬜ Batch processing

🌐 P2P Capabilities

✅ Basic file sharing
✅ Share code generation
✅ File fetching
⬜ DHT implementation
⬜ NAT traversal

🔊 Media Processing

✅ Audio extraction
✅ Format conversion
✅ Metadata handling
✅ Video upscaling with Real-ESRGAN
✅ Resolution selection fixes
⬜ Audio normalization
⬜ Subtitle support

📊 Monitoring

✅ Download statistics
✅ Speed testing
✅ System monitoring
⬜ Usage analytics

Future Plans

⬜ GUI interface
⬜ Plugin system
⬜ RSS feed monitoring
⬜ Remote control API
⬜ Docker support
⬜ Auto-update system

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

📊 System Requirements

Minimum: 2GB RAM, 1GHz CPU, 100MB free space
Recommended: 4GB RAM, 2GHz dual-core CPU, 500MB free space

🙏 Acknowledgements

Built with yt-dlp
Uses FFmpeg for media processing

Made with ❤️ by Rashed Alothman

Name		Name	Last commit message	Last commit date
Latest commit History 130 Commits
.github		.github
Documentation		Documentation
Theme		Theme
main/assets		main/assets
modules		modules
setupfiles		setupfiles
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
Snatch.bat		Snatch.bat
requirements.txt		requirements.txt
setup.py		setup.py
setup_ffmpeg.py		setup_ffmpeg.py

License

Rashed-alothman/Snatch

Folders and files

Latest commit

History

Repository files navigation

Snatch

Download Anything, Anywhere, Anytime

What's New in v1.8.0

🎯 Major New Features & Enhancements

🎵 Comprehensive Audio Enhancement System

🔧 Fixed Resolution Selection Bug

🚀 AI-Powered Video Upscaling

🎮 Interactive Mode Enhancements

📚 Comprehensive Documentation

Quick Examples:

🎯 Major Architectural Overhaul

Complete Package Refactoring & Modularization

Enhanced Plugin System

Advanced Audio Processing

Peer-to-Peer Networking

🚀 Performance & User Experience Improvements

Smart Performance Optimization

Enhanced User Interface

Improved Error Handling & Recovery

📚 Comprehensive Documentation Suite

📖 Technical Documentation

🔧 Module Documentation

🔌 Plugin Development Guide

📋 API Reference

🚀 Deployment Guide

⚡ Performance Optimization Guide

🔍 Troubleshooting Guide

🧪 Integration Testing

🛠️ Technical Improvements

Code Architecture Enhancements

Configuration Management

Security & Reliability

🚀 Overview

✨ Features

🎨 Comprehensive Customization System

🖥️ Enhanced Interactive Modes

🎯 Core Download Features

🎨 Customization System

🎭 Theme Management

🖥️ Interactive Interface Modes

⚙️ Performance Customization

🎛️ Interface Personalization

🎯 Behavior Configuration

🔗 Command Aliases

📁 Profile Management

📤 Import/Export Settings

🔧 Installation

Prerequisites

Step-by-Step Installation

Quick Start Guide

Configuration

Updating

💻 Advanced Usage

Audio Downloads & Enhancement

Audio Enhancement Presets

Video Downloads & Enhancement

Upscaling Methods & Quality Options

Advanced Features

New Video Enhancement CLI Options

Interactive Mode Commands

Environment Variables

Advanced Features

1. Playlist Downloads

2. Batch Downloads

3. Custom Output Directory

4. Format Specification

5. Automatic File Organization

Organization Templates

6. Advanced Audio Options

7. Advanced Command-line Options

8. Network Speed Testing

🏗️ Technical Architecture

📊 Performance Insights

🌎 Supported Sites