Support
Get help with Viddl — Universal Video Downloader for Mac.
Getting Started
Installation & Requirements
Viddl requires macOS 12 Monterey or later on Apple Silicon or Intel. No additional tools required — yt-dlp, ffmpeg, and ffprobe are all bundled inside the app.
Open the DMG, drag Viddl into your Applications folder, and launch it. If macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway. You only need to do this once.
Activating Your Business License
Personal use is free and needs no license at all. If you purchased a Business License, your license key will be delivered to your email within a few minutes.
To activate: open Viddl and look for the license banner in the sidebar. Paste your key (format: VIDDL-XXXX-XXXX-XXXX-XXXX) and click Activate. Internet is required for the first activation; after that, Viddl checks in once per day and works offline for up to 72 hours.
Troubleshooting
Download failed / HTTP 403 error
YouTube and other sites frequently change their internal APIs. This is usually fixed by clicking Update yt-dlp in the Viddl app footer, then retrying the download.
Private / age-restricted videos won't download
Viddl automatically reads cookies from Chrome, Brave, Edge, Firefox, or Safari (whichever is installed). Make sure you are logged in to the site in your browser, then retry the download from Viddl.
License key not working
- Make sure you're copying the full key including all dashes:
VIDDL-XXXX-XXXX-XXXX-XXXX - Check your spam folder — the delivery email comes from
noreply@twoplus11.com - If you need to transfer a seat to a new Mac, contact us and we can reset it
Smart Trim isn't removing segments
Smart Trim uses the SponsorBlock community database. If a video has no community-submitted segments, nothing will be removed — this is expected. Well-known YouTube channels typically have good SponsorBlock coverage.
Smart Trim only works on YouTube videos.
Browser extension not working
The Chrome extension requires Viddl.app to be running in the background. Start Viddl first, then click the extension button (or press ⌘⇧Y) on any video page to send it to Viddl instantly.
If it still doesn't work, check that no firewall or Little Snitch rule is blocking 127.0.0.1:8766 (the local bridge port).
Multiple downloads failed at once
If several downloads fail (e.g., after a network interruption), click the Retry Failed button that appears in the Downloads header to re-queue all failed items at once — no need to retry each one individually.
Alternatively, click the ↺ retry button on any individual download card.
Clipboard watch keeps popping up
Viddl watches your clipboard and offers to download any URL you copy. To disable this, open the settings panel (bottom of the sidebar) and toggle Clipboard Watch off. This preference is saved and persists between app launches.
Drag & drop and other ways to start a download
- Drag a link from Chrome, Safari, or any app directly onto the Viddl window — the download starts immediately.
- Paste a URL with ⌘V anywhere in the app to focus the URL field and fill it.
- Clipboard watch — copy a video URL in any app and a banner appears in Viddl with a one-click download option.
- Chrome extension — press ⌘⇧Y on any video page to send it to Viddl instantly.
Keyboard Shortcuts
All Keyboard Shortcuts
Viddl is designed to be keyboard-first. Press ? inside the app to open the cheat-sheet at any time.
| Key | Action |
|---|---|
| ⌘V | Focus URL field and paste from clipboard |
| Return | Start downloading the current URL |
| V | Switch to Video (MP4) mode |
| A | Switch to Audio (MP3) mode |
| ⌘⇧Y | Send current tab from Chrome (requires extension) |
| Esc | Close any open modal or toast |
| ? | Show the keyboard shortcut cheat-sheet |
Contact
support@viddl.twoplus11.com
We respond within one business day.