An alternative to Apple's Safari extension converter

Apple's tool, now called safari-web-extension-packager, wraps an extension in an Xcode project. Building it, signing it and fixing what Safari runs differently is left to you.

Viaduct does all of it

  1. Get Viaduct and run its setup. It walks you through installing Xcode (free) and signing in to it with any Apple ID.

  2. Drop the extension's folder on Viaduct. Or its .zip or .crx.

  3. Click Convert & Install. Viaduct runs Apple's packager, patches what Safari handles differently, then builds and signs the app.

  4. Switch it on. It's installed in Safari, with no Xcode project to keep.

What Apple's tool does

It comes with Xcode. Run it in Terminal on the extension's folder:

xcrun safari-web-extension-packager /path/to/extension

It used to be called safari-web-extension-converter. It creates an Xcode project with a Mac or iOS app that installs the extension, and warns about manifest keys Safari doesn't support, as Apple's guide explains.

Side by side

StepApple's packagerViaduct
BuildingYou open the project and build it in XcodeBuilds it with Xcode in the background
SigningYou choose a team in XcodeSigns with the Apple ID you added to Xcode
APIs Safari handles differentlyWarns about manifest keys and leaves the code as it isPatches them while the extension runs
PlatformsMac and iOSMac only
Sharing itYes, with an Apple Developer Program membershipNo, it builds for your own Mac

Questions

Which one should I use?

To publish an extension for other people, Apple's packager and the Apple Developer Program. To run a Chrome extension in your own Safari without keeping an Xcode project, Viaduct.

Can I get the Xcode project?

No, Viaduct doesn't hand you one. Use Apple's packager when you want a project to edit.

Does it convert Manifest V2 extensions?

Yes, both V2 and V3.

What does Viaduct cost?

Two conversions are free, and Viaduct removes them after 7 days. Pro is $19 once: it converts as many as you like and keeps them installed.

Updated

All extension names are trademarks of their respective owners. Viaduct is not affiliated with or endorsed by the developers of the extensions listed here, nor by Apple or Google. Viaduct converts extensions locally on your Mac; nothing is redistributed.