Skip to content

Latest commit

 

History

History
36 lines (32 loc) · 2 KB

safari_12.md

File metadata and controls

36 lines (32 loc) · 2 KB

Installation notes for Safari version 12

A new version of macOS is being released, macOS Mojave, and it's expected to have a stable release out September or October of 2018. With that new version comes Safari 12, and a completely new way of dealing with browser extensions. We have had some issues related to releasing new version of this extension, but they are now fixed and it's possible to install a version of vimari for Safari 12.

How to install

Note: We are currently working on improving this installation flow, as well as the extension itself. Because vimari now has to be released as a Safari App Extension instead of a Safari Extension it requires some fundamental changes to the code. We can't guarantee that all the features work in this version. It's a learning process for us so bare with us.

  1. Clone this repo
    $ git clone git@github.com:guyht/vimari.git
  2. Open the Swift project located at app_extension/vimari in Xcode
  3. Configure the Signing settings for both the vimari and extension targets to use your information rather than the Vimari team's (see this SO answer for more information).
  4. If you want different settings than the default ones, make your changes in settings.js. You can always come back later to change the settings again.
  5. Build and run the project (⌘ + r)
  6. An empty GUI box will show up - ignore it (we'll fix it later). Go to Safari and open up settings (⌘ + ,). Go to Extensions and you should see vimari in the list of extensions. Enable it.
  7. You may now press stop in Xcode and close Xcode. The extension will be available even if you restart Safari.

This was tested on High Sierra with Safari Technology Preview (version 12). Let us know if something is not working for you.