diff options
| author | Keith Packard <keithp@keithp.com> | 2017-12-18 12:43:55 -0800 |
|---|---|---|
| committer | Keith Packard <keithp@keithp.com> | 2017-12-18 12:43:55 -0800 |
| commit | 70f4f1bbc2c73cfa54f50b546651bac0cd2d6740 (patch) | |
| tree | 288cacdeecafe2c5411351ecfb81c95e3023265e /AltOS | |
| parent | 23d7a60a20365d6c9b3e6f2a58f6a353de8dd593 (diff) | |
Add page to help people with Mac OS X
Diffstat (limited to 'AltOS')
| -rw-r--r-- | AltOS/MacOSX.mdwn | 34 | ||||
| -rw-r--r-- | AltOS/index.mdwn | 4 |
2 files changed, 38 insertions, 0 deletions
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. |