+
+
+
+ {{ content }}
+
+
+
+
+
diff --git a/assets/images/macosx-open-anyway.png b/assets/images/macosx-open-anyway.png
new file mode 100644
index 0000000..70dae9d
Binary files /dev/null and b/assets/images/macosx-open-anyway.png differ
diff --git a/assets/images/macosx-open-from-sys-prefs.png b/assets/images/macosx-open-from-sys-prefs.png
new file mode 100644
index 0000000..ce85d3e
Binary files /dev/null and b/assets/images/macosx-open-from-sys-prefs.png differ
diff --git a/assets/images/macosx-unidentified-dev.png b/assets/images/macosx-unidentified-dev.png
new file mode 100644
index 0000000..add7b92
Binary files /dev/null and b/assets/images/macosx-unidentified-dev.png differ
diff --git a/index.md b/index.md
index 61f779b..f01ba95 100644
--- a/index.md
+++ b/index.md
@@ -16,6 +16,7 @@ Get the zip file for your operating system (Windows, Linux, macOS) from the [lat
**Linux users** who want to have BeeRef appear in the app menu, save the desktop file from the [release section]({{ site.github.latest_release.html_url }}) in `~/.local/share/applications` and adjust the path names in the file to match the location of your BeeRef installation.
+**MacOS X users**, look at [detailed instructions]({% link macosx-run.md %}) if you have problems running BeeRef.
## Features
@@ -37,4 +38,4 @@ The bee file format is a sqlite database inside which the images are stored in a
sqlite3 myfile.bee -Axv
```
-Options for exporting from inside BeeRef are planned, but the above always works independently of BeeRef.
\ No newline at end of file
+Options for exporting from inside BeeRef are planned, but the above always works independently of BeeRef.
diff --git a/macosx-run.md b/macosx-run.md
new file mode 100644
index 0000000..00b11c8
--- /dev/null
+++ b/macosx-run.md
@@ -0,0 +1,36 @@
+---
+layout: page
+---
+
+## How to run on Mac OS X
+
+When you open the `BeeRef.app` bundle, and you see the following error, keep reading.
+
+
+
+
+
+The following steps will walk you though the process that will allow you to run BeeRef:
+
+* Click **OK** to close the above error
+* Click on the Apple logo in the menu bar and select **System preferences...**
+* Go to **Security & Privacy** tab and select the **General** tab
+* Now you should see the text as shown on the image below:
+
+
+
+
+
+* Click **Open Anyway**
+* Go back to the location where you have `BeeRef.app` and double click it to run it again.
+* You will be greeted by the warning shown below:
+
+
+
+
+
+* Click **Open** and `BeeRef` should run
+
+Luckily, you have to do this only once.
+
+[Back](/)
{{ site.title | default: site.github.repository_name }}
+
+ 
+