Paste a link, add as many more as you like, and let Downer work through them in order.
No terminal. No browser extension. Just a menu bar icon and a shortcut.
Downer is a lightweight native app for yt-dlp and
ffmpeg. Download video and audio, audio only or video only, pick the quality and format,
and queue single videos and playlists while something is already downloading. Built for macOS 26 with Liquid Glass,
and works on macOS 14 and later.
Features · Install · Using Downer · Settings · Troubleshooting · Building · Changelog
downer-intro.mp4
- Video or playlist? A YouTube link to a video playing inside a playlist or Mix
(
watch?v=…&list=…) now asks whether you want just the video or the whole list, instead of downloading the whole list. Set a default in Settings → Downloads. - Mixes are never downloaded whole without asking. YouTube makes them on the fly, and one link can hold 100+ videos.
- Large playlists are confirmed first. A playlist of 200 or more videos asks once before it starts.
2.1 added optional sign-in, Best Compatibility, extra yt-dlp arguments, tool update buttons and self-updating. Every version is in the changelog.
- Video + audio, audio only or video only.
- Resolution from 240p up to 8K (capped at what the video offers), container (MP4, MKV, WebM or MOV), audio quality (best, or capped at 128, 70 or 50 kbps) and audio format (keep the source, or convert to MP3, AAC or Opus).
- Best Compatibility for H.264 + AAC MP4s that play everywhere.
- Every choice is remembered, and shared between the window and the menu bar.
- Add links at any time. Paste and press Return; the field clears for the next one. Pasting several links adds them all. Invalid or duplicate links are ignored.
- Videos and playlists, mixed freely. A playlist shows one row per video, each with its own progress.
- Video or playlist? A link to a video inside a playlist asks which you meant before anything is downloaded.
- One at a time, in order, so your connection and disk are never hammered. Each link keeps the settings it was added with.
- A tray that comes up from the bottom shows every link and video. Drag or two-finger swipe it up and down.
- Control each item: remove, cancel, retry, reorder (press, hold and drag), or swipe a row sideways.
- Automatic retry for network hiccups. Videos that are genuinely unavailable are not retried.
- Show in Finder reveals every file the queue produced.
Downer lives in the menu bar. Click the icon for a compact popover, or set a global shortcut: copy a link anywhere, press the shortcut, and the popover opens with the link already filled in.
| Menu bar icon | Meaning |
|---|---|
| Double chevron | Idle |
| Ring with a percentage | Downloading one video |
Ring with 3/12 |
Downloading from a queue or playlist (video 3 of 12) |
| Check mark | Finished |
| Orange dot | Something needs attention: a tool is missing, a download failed, or an update is ready |
You need macOS 14 or later. Downer uses yt-dlp and ffmpeg, and recommends deno for YouTube; it can install
them for you.
-
Download the latest
.dmgfrom Releases, open it and drag Downer onto Applications. -
Allow it to run. Downer is signed with its own certificate rather than a paid Apple Developer ID, so macOS may say "Downer.app can't be opened." Run this once in Terminal:
xattr -dr com.apple.quarantine /Applications/Downer.app
Or, without Terminal: open the app once, then go to System Settings → Privacy & Security and press Open Anyway next to the message about Downer.
Don't re-sign the app (for example with
codesign --sign -): macOS would forget the permissions you gave it. -
Install the tools. Open Settings → Requirements and press Install next to anything missing.
ffmpegneeds Homebrew; you can also runbrew install yt-dlp ffmpeg denoyourself. -
Allow folder access. The first time Downer saves to a protected folder such as Downloads, macOS asks. Choose Allow.
From 2.1 on, Downer updates itself.
- Open Downer, or click its menu bar icon.
- Paste a video or playlist link and press Return. If the link is a video inside a playlist or Mix, choose Download Video or the whole list.
- Choose Video + Audio, Audio Only or Video Only, and the quality and format you want.
- Paste more links while it downloads. They join the queue.
- Drag the tray up to see what is happening to each video.
- When the queue finishes, press Show in Finder.
Closing the window hides it and the Dock icon. Click the menu bar icon to bring it back, or right-click it for Open Downer, Check for Updates… and Quit Downer.
| Section | What it does |
|---|---|
| Appearance | Theme (Device, Light or Dark), background glow and haptic feedback |
| Global Shortcut | The key combination that opens the quick download popover |
| Downloads | What a link to a video inside a playlist does: Ask Each Time (the default), Just the Video or The Whole Playlist. See below. |
| Sign-in (browser cookies) | Optional sign-in through your browser, off by default. See below. |
| Requirements | Shows yt-dlp, ffmpeg, ffprobe and deno with their versions, with Install, Update and Browse… |
| Updates | Check for updates automatically (on by default) and Check now |
| Advanced | Extra yt-dlp arguments |
About the tools:
- With Homebrew, Downer installs and updates them with
brew. Without it,yt-dlpanddenoare downloaded from their official releases into Downer's own folder, and only installed if they match their published checksum.ffmpegneeds Homebrew. - Update is disabled while something is downloading, and downloads wait while a tool is being updated. Tools you installed some other way show Manual.
denois a JavaScript runtime, recommended for YouTube: without it some videos may fail or offer fewer formats. Downer passes it toyt-dlp2025.11.12 or newer automatically, so updateyt-dlpif yours is older.
A YouTube link like youtube.com/watch?v=…&list=… (for example a video you clicked inside a playlist or a Mix, often
with &start_radio=1) names one video and a list. yt-dlp downloads the whole list for these by default, so
Downer asks first:
- Download Video (the default, or press Return) downloads just that video. Download Playlist or Download Whole Mix downloads every video in the list. Cancel puts the link back in the field.
- Remember my choice makes your answer the default. Change it any time in Settings → Downloads → Video in a playlist.
- Pasting or dropping several such links lists them in the queue with Video and Playlist buttons on each row, and All: Just Videos / All: Whole Lists for all of them at once.
- Mixes (lists made by YouTube,
list=RD…) can hold 100+ videos and change each time. Downer never downloads a whole Mix without asking, whatever the setting. - A link to a whole Mix (
playlist?list=RD…) asks once before it downloads. - Large playlists: a playlist of 200 or more videos, or one too long to list in time, asks once before it starts.
- Picked the wrong one? Swipe the row for Whole Mix/Whole Playlist or Just Video to queue the other choice.
- Links to a playlist page (
playlist?list=…) always download the playlist, as before. On other sitesyt-dlpdecides, unless the setting is Just the Video or The Whole Playlist.
Some videos need a signed-in session, such as YouTube's age check and "confirm you're not a bot". Downer can let
yt-dlp use your browser's sign-in for those, on YouTube and other sites.
- Off by default. Turn on Settings → Sign-in → Sign in with a browser, pick a browser and read the consent screen. Nothing changes until you press Turn on.
- Only when needed. Downer always tries without cookies first, and uses the browser's cookies only when a site says sign-in is required.
- Stays on your Mac.
yt-dlpreads the cookies locally and sends them only to the site you are downloading from. Downer never saves, copies, uploads or logs them, and never sees your password.yt-dlpconfig files can't turn cookies on behind Downer's back. - Off means off. Turning it off applies immediately, including to links already queued.
- What macOS may ask:
- Chrome, Brave, Edge, Chromium, Vivaldi, Opera: once, for the browser's "Safe Storage" Keychain item, which is how the cookies are decrypted. Choose Allow.
- Safari: Downer needs Full Disk Access. Settings shows whether it has it and opens the right pane. After allowing it, quit and reopen Downer.
- Firefox: nothing.
Using your account with a downloader can lead a site to rate-limit or flag it. A secondary account is safer.
Turn on Best Compatibility (under the Container picker) to save H.264 video with AAC audio in an MP4. These files play in QuickTime, on iPhone and almost anywhere else. It fixes MP4s that play sound but show no picture in QuickTime, which happens when a YouTube MP4 holds AV1 video or Opus audio.
- The container is MP4 while it is on.
- Most YouTube videos offer H.264 only up to 1080p, so higher resolutions fall back to that.
- Files are usually larger.
- The MOV container always uses H.264 and AAC, since MOV can't hold the other codecs.
Settings → Advanced → Extra yt-dlp arguments adds your own options to every download, for example
--limit-rate 2M, --embed-subs or -t mp4. Quotes and backslashes work as in a shell, and the field tells you
whether what you typed is accepted.
Only common download options are allowed:
| Kind | Examples |
|---|---|
| Format selection and sorting | -f, -S, --merge-output-format, -t with mp3, aac, mp4, mkv or sleep |
| Audio and containers | -x, --audio-format, --remux-video, --recode-video |
| Network | --limit-rate, --retries, --proxy, --sleep-interval, -N, -4, -6 |
| Subtitles and thumbnails | --write-subs, --embed-subs, --sub-langs, --embed-thumbnail |
| Metadata, chapters, SponsorBlock | --embed-metadata, --embed-chapters, --split-chapters, --sponsorblock-remove |
| Files | --restrict-filenames, --no-overwrites, --no-part |
| What to download | --download-sections, --match-filters, --max-filesize, the date filters |
| Site settings | --extractor-args, only for settings such as youtube:player_client=web |
Everything else is refused, with the reason shown. That includes options Downer manages itself (output names and
folders, progress, playlist items, --no-playlist/--yes-playlist, which are set in Settings → Downloads), options that run commands or change Downer's tools (--exec, --update, config
locations), and anything that touches cookies (use the Sign-in setting instead). Write long options in full; an
abbreviation such as --verb is refused.
Good to know:
- Your options come after Downer's format options, so they can override them. Downer's own output, cookie and progress options always win.
- Extra files, such as split chapters, thumbnails and subtitles, are saved next to the video.
- The quick look-up that reads a link's title only uses connection options (
--proxy,--geo-verification-proxy,--xff,--source-address,--socket-timeout,-4,-6,--extractor-retries,--extractor-args), so filters and waits can't stall it.
Downer updates itself with Sparkle.
- It checks when it starts and then once a day (turn this off in Settings). If a new version is out at launch, an update window opens; later checks show an Update available button and an orange dot on the menu bar icon instead.
- Choose Install Update, Remind Me Later or Skip This Version. Downer verifies the update's signature, replaces itself and relaunches, and waits for running downloads to finish first.
- Check now in Settings, or Check for Updates… in the menu bar icon's right-click menu, checks right away.
- Updates are signed, and Downer refuses one whose signature doesn't match.
Downer has no accounts, analytics or tracking. It connects to:
- the sites you download from (through
yt-dlp), - GitHub, to check for Downer updates (a small
appcast.xml, with no information about your Mac), and to downloadyt-dlpordenowhen you press Install, - Homebrew, when you install or update tools with it.
Browser cookies are only used if you turn on Sign-in.
| Problem | What to try |
|---|---|
| "Downer.app can't be opened" | See Installation, step 2. |
| A "Setup needed" banner | Open Settings → Requirements and press Install next to what is missing. |
| Install is greyed out for ffmpeg | Install Homebrew first. |
| Downloads suddenly stop working for a site, or "yt-dlp may be out of date" | Press Update next to yt-dlp in Settings → Requirements. Sites change often. |
| "YouTube wants you signed in" | Turn on Sign in with a browser. |
| "Still blocked. Sign in to YouTube in …" | Sign in to the site in that browser, then press Retry. |
| "Downer needs Full Disk Access to use Safari's sign-in" | Press Open Full Disk Access Settings, allow Downer, then quit and reopen it. Or pick another browser. |
| macOS asks about a "Safe Storage" Keychain item | That is how Chrome-based browsers' cookies are decrypted. Choose Allow, then retry. |
| "Couldn't find … cookies" | Open that browser, sign in once, then retry. |
| An MP4 plays sound but no picture | Turn on Best Compatibility. |
| A video failed with an HTTP error | Downer retries once by itself. If it still fails, press Retry. |
| "This video is unavailable" | It is private, removed or blocked in your region. Retrying won't help. |
| "The site is limiting requests" | Wait a while and try again. |
| Nothing is saved | Check that the Save to folder exists and that Downer may write to it. |
| An extra argument is refused | The field says why. Only common options are allowed. |
| An update is waiting | It installs when your downloads finish. |
You need Xcode 26 or later (for the Liquid Glass APIs).
git clone https://github.com/dsameendra/Downer.git
cd Downer
open Downer.xcodeprojSelect the Downer target, choose your own team under Signing & Capabilities, then build and run. The Swift packages (Sparkle and KeyboardShortcuts) are fetched automatically.
To install your build, choose Product → Archive, then Distribute App → Custom → Copy App, and copy
Downer.app into /Applications.
Run the tests:
xcodebuild test -project Downer.xcodeproj -scheme Downer -destination 'platform=macOS' -only-testing:DownerTests
./scripts/test-gestures.shMaking a signed release (certificate, Sparkle key, DMG, appcast and publishing) is described in
docs/RELEASING.md.
| File | Role |
|---|---|
DownloadManager.swift |
The queue: looks links up, runs yt-dlp one at a time, turns its output into progress |
QueueLogic.swift |
The queue's decisions (retry, cancel, video or playlist), the output reader and the cancellable look-up |
LinkScope.swift |
Reads a link: one video, a playlist, or a video inside a playlist or Mix |
PlaylistChoiceView.swift |
The "just the video or the whole list?" card and the row buttons |
DownloadJob.swift |
One queued link and the settings it was added with |
PlaylistModel.swift |
Follows a playlist run line by line (current video, progress, failures) |
QueueTray.swift |
The draggable tray with every link and video |
YtDlpArguments.swift |
Builds every yt-dlp command line, for look-ups and downloads |
ExtraArguments.swift |
Splits and checks your extra yt-dlp arguments |
CookieBrowser.swift, CookieConsentSheet.swift |
The opt-in browser sign-in and its consent screen |
FullDiskAccess.swift |
Checks Safari's Full Disk Access and builds yt-dlp's environment |
ErrorHints.swift |
Turns yt-dlp errors into a next step |
UpdateChecker.swift |
Connects Sparkle to Downer's Settings, update button and menu |
DependencyManager.swift |
Finds, installs and updates yt-dlp, ffmpeg, ffprobe and deno |
DesignSystem.swift |
Liquid Glass, materials, motion, buttons and window chrome |
MenuBarIcon.swift |
The menu bar icon and its states, drawn in code |
scripts/make-dmg.sh |
Builds the installer DMG and the signed appcast.xml |
PRODUCT.md describes who Downer is for, and DESIGN.md the design decisions behind it.
Issues and pull requests are welcome.
- Open pull requests against
main. CI builds the app, runs the tests and checks the release pipeline; it must pass before a merge, and every pull request is reviewed by the maintainer. - Add tests for new behaviour, and update this README and the changelog when users will notice the change.
- Please report security problems privately, as described in
SECURITY.md, not in a public issue.
Downer is released under the MIT License.
It is meant for personal use and for educational or research purposes. Downloading from YouTube may break its Terms of Service unless the video has a download button or its license allows it. You are responsible for what you download and how you use it. The developer does not support using Downer to infringe copyright or break platform rules.
Built with ❤️ on yt-dlp and ffmpeg. Huge thanks to the people behind them.
If Downer is useful to you and you'd like to support it (entirely optional):







