From b7630bdaedc6ff7e0f0f854dfd0ed43b3e774118 Mon Sep 17 00:00:00 2001
From: Alexander Batalov <alex.batalov@gmail.com>
Date: Wed, 6 Jul 2022 09:47:19 +0300
Subject: [PATCH] Update installation instructions

---
 README.md | 42 +++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 41 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 01388e8..6099943 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,47 @@
 
 ## Installation
 
-You must own the game to play. Purchase your copy on [GoG](https://www.gog.com/game/fallout_2) or [Steam](https://store.steampowered.com/app/38410). Download latest build or build from source. The `fallout2-ce.exe` serves as a drop-in replacement for `fallout2.exe`. Copy it to your Fallout 2 directory and run.
+You must own the game to play. Purchase your copy on [GOG](https://www.gog.com/game/fallout_2) or [Steam](https://store.steampowered.com/app/38410). Download latest build or build from source.
+
+### Windows
+
+Download and copy `fallout2-ce.exe` to your `Fallout2` folder. It serves as a drop-in replacement for `fallout2.exe`.
+
+### Linux
+
+- Use Windows installation as a base - it contains data assets needed to play. Copy `Fallout2` folder somewhere, for example `/home/john/Desktop/Fallout2`.
+
+- Download and copy `fallout2-ce` to this folder.
+
+- Fix permissions (GitHub artifacts issue):
+
+```console
+chmod a+x /home/john/Desktop/Fallout2/fallout2-ce
+```
+
+- Install [SDL2](https://libsdl.org/download-2.0.php):
+
+```console
+$ sudo apt install libsd2-2.0-0
+```
+
+- Run `./fallout2-ce`.
+
+### macOS
+
+> **NOTE**: macOS Monterey is required. The app is not universal. It should run on Apple Silicon under Rosetta 2, but I haven't tried it. The app is neither signed, nor notarized.
+
+- Use Windows installation as a base - it contains data assets needed to play. Copy `Fallout2` folder somewhere, for example `/Applications/Fallout2`.
+
+- Download and copy `fallout2-ce.app` to this folder.
+
+- Run `fallout2-ce.app`.
+
+- When running for the first time, macOS will complain that the app is not signed and you'll be present two options - `Move to bin`, and `Cancel`. Click `Cancel`, open `System Preferences`, go to `Security & Privacy`. The pane at the bottom will say `fallout2-ce was blocked from use because it is not from an identified developer`. Click `Open Anyway`. Confirm once again. Alternatively you can remove quarantine attribute from terminal:
+
+```console
+$ xattr -d com.apple.quarantine /Applications/Fallout2/fallout2-ce.app
+```
 
 ## Contributing