From 70f4f1bbc2c73cfa54f50b546651bac0cd2d6740 Mon Sep 17 00:00:00 2001 From: Keith Packard Date: Mon, 18 Dec 2017 12:43:55 -0800 Subject: [PATCH] Add page to help people with Mac OS X --- AltOS/MacOSX.mdwn | 34 ++++++++++++++++++++++++++++++++++ AltOS/index.mdwn | 4 ++++ 2 files changed, 38 insertions(+) create mode 100644 AltOS/MacOSX.mdwn diff --git a/AltOS/MacOSX.mdwn b/AltOS/MacOSX.mdwn new file mode 100644 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 288f375..ca69cf5 100644 --- 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. -- 2.47.2