Add page to help people with Mac OS X

diff --git a/AltOS/MacOSX.mdwn b/AltOS/MacOSX.mdwn
new file mode 100644 (file)
index 0000000..2933f28
--- /dev/null
+++ b/AltOS/MacOSX.mdwn
@@ -0,0 +1,34 @@
+# Installing AltosUI on Mac OS X
+
+Mac OS X places barriers to running software from outside of the Apple
+ecosystem on Apple hardware. Whenever you download softwarae, the
+browser tags the application as 'foreign' and that prevents the
+operating system from running it.
+
+Here's how you can use xattr(1) to clear the protection setting from
+the AltosUI.app after it is installed.
+
+1. Display the application extended attributes:
+
+               $ xattr -l /Applications/AltosUI.app
+                com.apple.quarantine:
+                0181;5a380dfb;Google\x20Chrome.app;6B17C3F9-68D3-4C27-A5EA-7ADADE376ACD
+
+    This shows that the app was downloaded using google chrome. Other
+    users' values will be different but the com.apple.quarantine
+    prefix will be the same!). If this attribute is present
+    AltosUI.app won't be allowed to run.
+
+1. Use the following command to remove the attribute preventing MacOS
+    X from running this application:
+
+               $ sudo xattr -c /Applications/AltosUI.app
+
+    This clears the extended attribute in question.  You should now be
+    able to run our app!
+
+1. Check to make sure the attribute has been cleared:
+
+               $ xattr -l /Applications/AltosUI.app
+
+NOTE: this has to be run every time one installs a new version!

diff --git a/AltOS/index.mdwn b/AltOS/index.mdwn
index 288f375492f13d6ae39deefe4f51cf8c14028ca1..ca69cf559fd648bf26124941ead983db64baeb8d 100644 (file)
--- a/AltOS/index.mdwn
+++ b/AltOS/index.mdwn
@@ -34,6 +34,10 @@ If you're running Windows 8, you should take a look at [Installing AltosUI on
 Windows 8](Win8) which will help you install the operating system
 drivers needed to communicate with the USB hardware.
 
+If you're running a recent version of Mac OS X, you'll probably need
+to read [Installing AltosUI on Mac OS X](MacOSX). This describes how
+to get rid of the the 'App is damaged' messages and run the program.
+
 Each available download includes AltosUI, documentation, and firmware updates
 for all current products.