summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFlorian Bruhin <git@the-compiler.org>2016-07-25 19:41:29 +0200
committerFlorian Bruhin <git@the-compiler.org>2016-07-25 19:41:29 +0200
commit2751e5795809356c27de78cc127370caabd3e76c (patch)
tree3ad1f2e70c9ef769fa45516446ed0cd45199e504
parentc618983b3da3f5867a2eeb9ac932e9dbaebe3e2a (diff)
downloadqutebrowser-2751e5795809356c27de78cc127370caabd3e76c.tar.gz
qutebrowser-2751e5795809356c27de78cc127370caabd3e76c.zip
Update OS X install instructions
Closes #1656
-rw-r--r--INSTALL.asciidoc12
1 files 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 <<tox,install qutebrowser via tox>>.
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: