Bhemu UNI Downloader
✨ Features
- 🌐 1000+ Websites - YouTube, Instagram, TikTok, Twitter, Vimeo, and more
- 🎬 Multiple Quality Options - Best, 1440p, 1080p, 720p, 480p, or Audio-only (MP3)
- 📋 Playlist Support - Download entire playlists with concurrent downloads
- 💬 Subtitle Support - Download and embed subtitles in multiple languages
- ⚡ Real-time Progress - Live speed, percentage, and ETA tracking
- 🔄 Auto-Retry - Failed downloads automatically retry up to 3 times
- 🎭 Drag & Drop - Drop URLs directly into the app
- 🔒 100% Private - All processing happens locally on your Mac
🚀 Quick Start
For Users (Download Pre-built App)
- Download the latest
.dmg from Releases
- Open the DMG and drag the app to Applications
- Launch the app - it will automatically install dependencies
- Start downloading! 🎉
For Developers (Build from Source)
1. Prerequisites
- macOS 13.0+ (Ventura or later)
- Xcode 14.0+
2. Clone & Build
# Clone the repository
git clone https://github.com/adarsh3699/Bhemu-UNI-Downloader.git
cd Bhemu-UNI-Downloader
# Open in Xcode
open BhemuUNIDownloader.xcodeproj
# Build and run (⌘+R)
The app will automatically install yt-dlp and ffmpeg on first launch.
📖 Usage
Downloading Videos
- Paste URL - Copy any video URL and paste it into the app
- Select Quality - Choose from Best, 1080p, 720p, 480p, or Audio-only
- Choose Folder (optional) - Select where to save the video
- Start Download - Click the button or press
⌘↩
Downloading Playlists
- Paste Playlist URL - The app will detect it's a playlist
- Select Videos - Choose which videos to download
- Pick Quality - Select preferred quality
- Download - Up to 3 videos download simultaneously
Subtitles
- Open Settings (⌘,)
- Enable "Download Subtitles"
- Enter language codes (e.g.,
en, es, fr)
- Enable "Embed in Video" to include subtitles in the file
Supported Websites
YouTube • Instagram • TikTok • Twitter/X • Facebook • Reddit • Vimeo • Twitch • SoundCloud • 1000+ more
Keyboard Shortcuts
⌘↩ - Start download
⌘. - Cancel download
⌘, - Open settings
⌘? - Help
🛠️ Troubleshooting
"Cannot be opened because Apple cannot verify it is free from malware"
This is a normal macOS security warning for unsigned apps. To fix:
- Go to System Settings → Privacy & Security
- Scroll down to the Security section
- You'll see a message: "Bhemu UNI Downloader was blocked from use because it is not from an identified developer"
- Click Open Anyway
- In the confirmation dialog, click Open
The app will now launch normally. This only needs to be done once.
Alternative methods:
Method 2 - Right-click:
- Right-click the app → Open → Click Open in the warning dialog
Method 3 - Terminal command:
xattr -cr /Applications/Bhemu\ UNI\ Downloader.app
This removes the quarantine attribute. Run this in Terminal if the app is in your Applications folder.
Download fails?
- Check if the URL works in your browser
- Update yt-dlp:
brew upgrade yt-dlp
- Check the Download Log for error details
Build issues?
- Clean build folder:
⇧⌘K then rebuild in Xcode
- Make sure you're running macOS 13.0+ and Xcode 14.0+
Still stuck? Open an issue or check the built-in Help (⌘?)
🏗️ Project Structure
BhemuUNIDownloader/
├── Views/ # SwiftUI UI components
├── ViewModels/ # Business logic & state management
├── Models/ # Data structures
├── Services/ # yt-dlp & ffmpeg integration
└── Utilities/ # Helper functions
Architecture: MVVM (Model-View-ViewModel) with SwiftUI
🤝 Contributing
We welcome contributions! Whether it's bug reports, feature requests, or code improvements.
Quick Start:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature)
- Commit your changes (
git commit -m 'Add AmazingFeature')
- Push to the branch (
git push origin feature/AmazingFeature)
- Open a Pull Request
See CONTRIBUTING.md for detailed guidelines.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
TL;DR: Free to use, modify, and distribute. No warranties provided.
🙏 Acknowledgments
- yt-dlp - The powerful download engine
- FFmpeg - Media processing toolkit
- Apple - Swift and SwiftUI frameworks
⭐ Support
If you find this project useful, please give it a star! ⭐
Author: Adarsh Suman (adarsh3699@gmail.com)
Website: bhemu.in