Safari Extension
Import any YouTube or Vimeo video into Harvestry with a single click — no copying, no switching apps.
What It Does
The Harvestry Safari extension adds a toolbar button to Safari. When you're on a video page, clicking it sends the URL directly to Harvestry, which opens the Import sheet with everything already filled in. You just click Import.
The extension is bundled inside the Harvestry app — there is nothing extra to download. You just need to enable it once in Safari.
Enabling the Extension
In Safari, choose Safari → Settings… from the menu bar, or press ⌘,.
It's the last tab in the Settings window, with a puzzle piece icon.
Harvestry appears in the list automatically once the app has been launched at least once. Check the box next to it to enable the extension. The Harvestry icon will appear in your Safari toolbar.
The first time you click the toolbar button, Safari asks whether to allow Harvestry to read the current page. Click Allow — the extension only reads the page URL and title, nothing else.
Using the Extension
Go to any YouTube video, Vimeo page, or other supported site. The extension works wherever yt-dlp can download — over a thousand platforms.
The button appears in your Safari toolbar. A small popup confirms the page is being sent to Harvestry.
The app comes to the foreground and the Import sheet opens with the URL already in the URL field. Click Download & Import to start.
Troubleshooting
The toolbar button isn't visible
Safari may have hidden the button to save space. Right-click the Safari toolbar and choose Customize Toolbar…, then drag the Harvestry icon to a visible position. Alternatively, click the Extensions button (jigsaw icon) in the toolbar to access all extension buttons from a single menu.
Clicking the button does nothing
This usually means the extension doesn't have permission to read the current page. Click the toolbar button, then look for a permission prompt in the popup, or go to Safari → Settings → Extensions → Harvestry and check that permissions are set to Allow for the relevant sites.
The app doesn't open
If clicking the button opens a browser dialog asking how to handle a harvestry:// URL, click Open. macOS should remember this choice and not ask again. If the dialog keeps appearing, make sure Harvestry is installed in your Applications folder (not run directly from a DMG).