Macabolic 🚀

A modern, fast, and beautiful video downloader for macOS. Powered by yt-dlp.

Macabolic is a native macOS frontend for the powerful yt-dlp command-line tool. It allows you to download videos and audio from YouTube and thousands of other supported sites with ease.

Screenshots 📸

---

Support My Journey ❤️

Note on Sponsorships:
Direct financial support via GitHub Sponsors is currently disabled due to local tax and regulatory complexities. While I truly appreciate the generosity of everyone who wanted to contribute, the best way to support Macabolic right now is by starring the repository, reporting bugs, or sharing the project with the community. Thank you for understanding! 🙏

🏆 The "First 5" Wall of Fame

To show my gratitude, the first 5 sponsors of any amount will be permanently featured in the "About" section of the Macabolic app. Your name will be part of the app's history forever!

1. Iman Montajabi 🌟 (Our first ever sponsor!)
2. Semmelstulle 🌟

---

Roadmap 🗺️

Here is what I'm planning to bring to Macabolic in the near future:

• Browser Cookies Support: Use cookies from your browser to bypass YouTube's bot detection and access age-restricted or private content. ✅ (Completed in v2.2.0)
• Advanced Codec Default Settings & Presets: Save and manage custom download presets with preferred codecs, resolutions, and audio quality settings. ✅ (Completed in v2.2.0)
• Persistent History & Re-download: Categorized completed/failed downloads that persist across sessions and easy re-downloading. ✅ (Completed in v2.3.0)
• Notification Support: Get notified instantly when downloads are finished. ✅ (Completed in v3.0.0)
• Browser Extensions: One-click download directly from Chrome and Firefox. ✅ (Completed in v3.0.0)
• Menu Bar Integration: Manage ind downloads from your menu bar. ✅ (Completed in v3.0.0)
• Official Apple Notarization: Removing the "Unidentified Developer" warning for a professional experience. (Waiting for the project to reach 1,000+ stars and a larger user base).
• Custom Post-Processing: More tools to trim, convert, and manage your downloaded files.

---

Features ✨

• Native macOS Experience: Built with SwiftUI for a seamless look and feel.
• Menu Bar App: Manage your downloads directly from the menu bar. 🆕
• Browser Extensions: Start downloads with one click from Chrome and Firefox. 🆕
• Native Notifications: Instant updates when downloads are finished. 🆕
• Vast Site Support: Downloads from YouTube, Vimeo, Twitter, and thousands more.
• Multiple Formats: Support for MP4, WebM, MP3, Opus, FLAC, and WAV.
• High Quality: Up to 4K (2160p) resolution support.
• Smart Features:
  • Embed subtitles, metadata, and thumbnails into your files.
  • SponsorBlock integration to automatically skip sponsors and intros.
  • Playlist downloading support.
  • Concurrent download management.
• Multi-language: Supports English and Turkish (automatically detects system language).
• Auto-Update: Self-manages yt-dlp updates to ensure maximum compatibility.

Installation 🚀

Option 1: Homebrew (Recommended)

brew tap alinuxpengui/macabolic
brew install --cask macabolic
xattr -cr /Applications/Macabolic.app

Option 2: Manual Download

• Download: Download the latest Macabolic-v3.0.0.dmg from the Releases page.
• Install: Open the DMG file and drag Macabolic to your Applications folder.
• First Launch: Since the app is not notarized, you have two options to open it:
  • Terminal Way: Run the following command to remove the quarantine flag:

xattr -cr /Applications/Macabolic.app

• Other Way: Right-click the app in your Applications folder and select Open, or go to System Settings > Privacy & Security and click Open Anyway.
• Initial Setup: When the app opens, you will be greeted by a Legal Disclaimer. Please read and confirm it. Go to Preferences (⌘,) to set your Language and Default Save Folder.

Option 3: Browser Extensions 🌐

Chrome / Brave / Edge:

1. Download: MacabolicExtension_Chrome.zip and unzip it.
2. Go to chrome://extensions/
3. Enable "Developer mode" (top right).
4. Click "Load unpacked" and select the unzipped folder.

Firefox:

1. Download: MacabolicExtension_Firefox.zip and unzip it.
2. Go to about:debugging#/runtime/this-firefox
3. Click "Load Temporary Add-on...".
4. Select the manifest.json file inside the unzipped folder.

💡 Usage: Once installed, simply right-click on any video link or the page itself on supported sites (like YouTube) and select "Download with Macabolic" to start downloading immediately.

---

Build Requirements 🛠️

• macOS 12.0 or later (Monterey+)
• Xcode 14.0 or later
• Swift 5.7+

Credits ❤️

• Parabolic by Nickvision: This project is a macOS-native port based on the original Parabolic application.
• yt-dlp: The core engine that makes video downloading possible.

Legal Disclaimer ⚖️

This tool is intended solely for personal use and educational or research purposes. Videos on YouTube and other sites may be subject to DMCA protection. The authors of Parabolic/Macabolic do not endorse, and are not responsible for, the use of this application in means that will violate these laws. Downloading videos from YouTube may violate their Terms of Service unless the video has an explicit download button or the content is licensed in a way that permits downloading. By using this app, you assume full responsibility for any content you download and how you use it. The developer does not condone or support any misuse of this tool to infringe upon copyrights or violate platform rules.

License ⚖️

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

---

Maintained by alinuxpengui

Star History