The Ultimate Video Downloader for macOS

Download videos from YouTube, TikTok, Instagram, and 1000+ more sites with one click!

VidSnatch is a powerful yet simple video downloader that works seamlessly on macOS. It combines beautiful browser extensions (Chrome and Firefox) with a native menu bar app to make downloading videos as easy as clicking a button.

• One-Click Downloads - Simply click the extension icon on any video page
• Menu Bar Integration - Native macOS app that lives in your menu bar
• Browser Extensions - Chrome and Firefox extensions for direct downloads
• Real-Time Progress - Watch your downloads with live progress tracking
• Multiple Downloads - Download several videos simultaneously
• Smart Management - Organize downloads with custom names and folders
• Dark Mode - Beautiful interface that adapts to your system theme

VidSnatch requires Python 3.10+ installed via Homebrew. If you're starting from a fresh macOS installation, follow these steps:

1. Install Homebrew (if not already installed)

Open Terminal and run:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

After installation, follow the instructions to add Homebrew to your PATH.

2. Install Python 3.12 and tkinter

brew install python@3.12
brew install python-tk@3.12

1. Download VidSnatch - Clone or download this repository
2. Run the installer - Double-click 🎬 VidSnatch Manager.command (or run python3 gui_installer.py from Terminal)
3. Choose "Install" - The installer will set up everything automatically
4. Setup Browser Extension - Follow the guided setup for Chrome or install the Firefox extension manually

That's it! VidSnatch is now running in your menu bar and ready to download videos.

1. Visit any video site (YouTube, TikTok, Instagram, etc.)
2. Click the VidSnatch extension in your browser toolbar
3. Hit "Download Video" - Your video will start downloading immediately
4. Track progress - Watch the real-time progress in the extension popup

VidSnatch consists of three integrated components:

• Lives in your macOS menu bar
• Automatically starts the download server
• Provides quick access to the web interface
• Start/stop server with one click

• Detects videos on any webpage
• One-click downloading directly from sites
• Real-time progress tracking
• Multiple simultaneous downloads
• Smart retry functionality
• Available for both Chrome and Firefox

• Beautiful download management interface
• Add custom names to organize your videos
• Sort and search your downloaded files
• Dark mode support
• File management and playback

• macOS (Intel or Apple Silicon)
• Python 3.10+ via Homebrew (see Prerequisites above)
• Google Chrome or Firefox (for the browser extension)

VidSnatch supports 1000+ video sites through yt-dlp, including:

Most Popular:

• YouTube, YouTube Music
• TikTok, Instagram, Facebook
• Twitter/X, Reddit, 9GAG
• Twitch, Vimeo, Dailymotion
• SoundCloud, Spotify, Bandcamp
• And hundreds more...

Full list: yt-dlp supported sites

• Custom Names - Add person names or custom labels to downloaded videos
• Folder Control - Change download location anytime
• Smart Retry - Failed downloads automatically search your browser history
• Organization - Sort by name, size, or date

• Open from Menu Bar - Click "Open Web Interface"
• Open from Extension - Click "Open Web Interface"
• Smart Tab Switching - Automatically switches to existing web interface tabs

• Reinstall - Use VidSnatch Manager to reinstall/update
• Uninstall - Complete removal including menu bar icon
• Settings - Customize download behavior and interface

• Check that VidSnatch is running in your menu bar
• Try clicking "Start Server" from the menu bar menu
• Restart VidSnatch Manager if needed

• Verify the website is supported
• Check your internet connection
• Try refreshing the page and clicking the extension again

• Make sure VidSnatch Manager installation completed successfully
• Try restarting your computer to refresh the menu bar
• Reinstall using VidSnatch Manager

• Ensure Developer mode is enabled in chrome://extensions/
• Try reloading the extension
• Check for Chrome updates

• Go to about:debugging and click "This Firefox"
• Click "Load Temporary Add-on..." and select firefox-extension/manifest.json
• Check for Firefox updates

• Ensure you have Python 3.10+ installed via Homebrew (not the system Python)
• Run brew install python@3.12 python-tk@3.12
• The installer will use Homebrew Python automatically

• 100% Local - All processing happens on your computer
• No Data Collection - We don't track or store any personal information
• Open Source - Full source code available for review
• Secure Downloads - Downloads go directly to your chosen folder

VidSnatch is built with:

• yt-dlp - The powerful video extraction engine
• rumps - Native macOS menu bar integration
• Created from a fork of PH-DL

Having issues? Need help?

1. Check Troubleshooting - Most issues have simple solutions above
2. Reinstall - Use VidSnatch Manager to reinstall cleanly
3. Report Issues - Open an issue on GitHub with details