Repository navigation
Releases: eliorpom-cmd/to-be-downloaded
Release list
v1.2.0
Installing is one command again.
brew install --cask eliorpom-cmd/tap/to-be-downloaded
The app is signed with an Apple Developer ID certificate and notarized by Apple, so macOS opens it without the xattr line every previous version needed. Four people paid for the developer account between them — they are named in the README.
If you already have the app, it updates itself and there is nothing to redo.
Full notes in CHANGELOG.md.
v1.1.0
A release made of other people's reports.
Two of the changes are about the app taking decisions that were never its to
take: opening a network port on your machine at launch, and downloading 56 MB
onto it without asking. Both are questions now.
The bigger ones
- The LAN server is opt-in. Launching the app binds nothing. Turning
Remote Control on opens the port and remembers the choice; turning it off,
or quitting, closes it. - Network Access is called Remote Control, and its screen says what the
feature is for instead of showing a dimmed QR code. - First launch asks two questions — where downloads go, and whether to
fetch FFmpeg. Nothing is downloaded before you answer, and an FFmpeg
already on your Mac is linked instead of duplicated. Upgrading from 1.0
skips all of it. - A pasted link is identified before it downloads: thumbnail, title,
channel and length, for the price of one small request. - A failed download retries itself once, in the row it already has.
- ⌘Z takes back a library removal.
- A warning on Max quality, once: YouTube only serves H.264 up to 1080p,
so 4K arrives as VP9 and QuickTime opens it with no picture. The file is
fine; VLC plays it. - Subtitle language and automatic captions are now settings.
Fixed
- Removing a library entry now removes the download it came from — it used to
linger on the Download screen and on any phone pointed at the Mac. - FFmpeg is checked for updates at launch, not only after an hour of uptime.
A Mac opened and closed inside an hour updated it exactly never. - No subprocess can hang the app any more.
- One window, always. A link from the share extension or the
tbd://scheme
used to open a second one. - The Video/Audio toggle stops sliding sideways, in the app and on the web
page, and the web page stops offering a menu with one item in it. - Settings centre on a wide window and their scroll bar sits on the window
edge.
Removed
- "New Window", ⌘N, and the tab bar. One queue, one window.
- ⌘L and ⌘⇧V. The field is already focused when the window opens. The
system-wide ⌥⌘V in Settings is untouched.
The full list is in CHANGELOG.md.
Installing. brew install --cask eliorpom-cmd/tap/to-be-downloaded, then
xattr -dr com.apple.quarantine "/Applications/TBD - To be downloaded.app".
Or take TBD.dmg below. The app is signed but not notarised, which is what
the xattr step is for.
Already have it? It updates itself, once a day, after checking the
signature on this release.
v1.0.0 — TBD goes public
The first public release. Paste a YouTube link, get the file — and drive the
same downloads from your phone over your own Wi-Fi.
Install
brew install --cask --no-quarantine eliorpom-cmd/tap/to-be-downloaded--no-quarantine is needed because the app is ad-hoc signed and not notarised
by Apple. Without it, macOS refuses to open it. Or download the ZIP below and
drop the app in /Applications.
What's in it
A native macOS app on top of yt-dlp — no
Chromium, no bundled browser. Video or audio, quality picking, burned-in
subtitles, filename templates, a queue that resumes interrupted downloads, a
library with duplicate detection, and a LAN web server with a phone-installable
UI and a QR code to reach it. Menu bar extra, Dock progress, Quick Look, a
global shortcut, a Services entry, and a tbd:// scheme.
From this release on the app updates itself: it checks this repository once a
day and verifies the Ed25519 signature of the archive before installing
anything. That is what the .sig file attached here is for.
FFmpeg is downloaded on first launch rather than bundled, verified against both
its published SHA-256 and an Apple Developer ID signature pinned to its
publisher. Nothing this project distributes contains FFmpeg — see
docs/THIRD-PARTY.md.
Limits, up front
- YouTube only. Other sites are not supported, even though yt-dlp handles them.
- Apple Silicon only, macOS 13 Ventura or later. No Intel build.
- Not notarised. Hence
--no-quarantine. - Above 1080p YouTube only serves VP9 and AV1, which QuickTime cannot play. The
app prefers H.264 up to 1080p so everything opens; higher resolutions need a
player like IINA or VLC. - The Share extension is embedded but inactive — PlugInKit does not register
ad-hoc signed extensions. The Services menu covers the same need.
Full list of changes in CHANGELOG.md.
AGPL-3.0.
0.1.0 — private beta
First build handed out for testing. Everything in the app works; nothing here is a mockup.
Installing
- Download
TBD-0.1.0-macos.zipbelow and unzip it. - Drag TBD - To be downloaded.app into your Applications folder.
- Right-click the app → Open → Open. A normal double-click will be refused.
That last step is needed because the app is ad-hoc signed and not notarized by
Apple (notarization needs a paid developer account). You only do it once.
On first launch the app fetches FFmpeg (~56 MB) and says so while it does. It
is checked against a published SHA-256 and must carry a valid Developer ID
signature from its publisher, or it is thrown away rather than installed.
Requirements
macOS 13 Ventura or later, Apple Silicon. No Intel build.
Updating
There are none while this repository is private: the app asks GitHub for
releases, gets a 404, and treats that as "nothing published". You will get the
next build the same way you got this one.
What to report
Anything that breaks, one line is enough. Also worth telling me: a link that
downloaded the wrong quality, a file that would not open, anything that felt
slow or unclear. Send it to eliorpom@gmail.com or wherever you got this link.
Known issues
- 4K is VP9 (YouTube serves no H.264 above 1080p) and needs IINA or VLC rather
than QuickTime. - The Share extension is embedded but inactive: macOS does not register ad-hoc
signed extensions. The Services menu does the same job. - First launch needs a network connection for FFmpeg. No offline first run.