From 1327812087784722268d123931e7550918487e6f Mon Sep 17 00:00:00 2001
From: miruka <miruka@disroot.org>
Date: Fri, 27 Mar 2020 17:29:42 -0400
Subject: [PATCH] INSTALL.md: improve flatpak instructions

---
 INSTALL.md | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/INSTALL.md b/INSTALL.md
index 0347f149..928f25aa 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -47,18 +47,25 @@ released in April 2016 or later.
 
 #### Flatpak
 
-For **other architectures or musl-based systems**, Mirage is also available
-as a Flatpak
-on the [release page](https://github.com/mirukana/mirage/releases).
+Mirage is also available as a Flatpak
+on the [release page](https://github.com/mirukana/mirage/releases).  
+Follow [these instructions](https://flatpak.org/setup/) to install the flatpak
+command on your system.
 
-To install and run it:
+To then install and run the downloaded `.flatpak` file:
 
 ```sh
-    flatpak install --user flathub org.kde.Platform//5.12 mirage-*.flatpak
+    flatpak remote-add --user --if-not-exists \
+        flathub https://flathub.org/repo/flathub.flatpakrepo
+
+    flatpak install --user flathub org.kde.Platform//5.12
+    flatpak install --user mirage-*.flatpak
+
     flatpak run io.github.mirukana.mirage
 ```
 
-If the download fails for some reason, run `flatpak repair` before retrying.
+If downloading the dependencies fail due to e.g. connection error,
+run `flatpak repair` before retrying.
 
 If your architecture is not listed on the release page, clone the repository
 and see [packaging/flatpak/README.md](packaging/flatpak/README.md) to build the