From 2751e5795809356c27de78cc127370caabd3e76c Mon Sep 17 00:00:00 2001 From: Florian Bruhin Date: Mon, 25 Jul 2016 19:41:29 +0200 Subject: [PATCH] Update OS X install instructions Closes #1656 --- INSTALL.asciidoc | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/INSTALL.asciidoc b/INSTALL.asciidoc index f81ef0b60..0c13e52b5 100644 --- a/INSTALL.asciidoc +++ b/INSTALL.asciidoc @@ -229,11 +229,17 @@ Then <>. On OS X ------- -To install qutebrowser on OS X, you'll want a package manager, e.g. -http://brew.sh/[Homebrew] or https://www.macports.org/[MacPorts]. +The easiest way to install qutebrowser on OS X is to use the prebuilt `.app` +files from the +https://github.com/The-Compiler/qutebrowser/releases[release page]. + +Alternatively, you can install the dependencies via a package manager (like +http://brew.sh/[Homebrew] or https://www.macports.org/[MacPorts]) and run +qutebrowser from source. For Homebrew, a few extra steps are necessary since Homebrew dropped QtWebKit -from Qt 5.6. +from Qt 5.6 - however, some users reported this didn't work for them, so using +the `.app` is strongly encouraged. This installs a Qt 5.5 and symlinks it so PyQt5 will work with it instead of Qt 5.6. This requires that `qt5` is not installed via Homebrew: