creating index page EasyTimer/v2
[web/altusmetrum] / AltOS / MacOSX.mdwn
1 # Installing AltosUI on Mac OS X
2
3 Mac OS X places barriers to running software from outside of the Apple
4 ecosystem on Apple hardware. Whenever you download softwarae, the
5 browser tags the application as 'foreign' and that prevents the
6 operating system from running it.
7
8 Here's how you can use xattr(1) to clear the protection setting from
9 the AltosUI.app after it is installed.
10
11 1. Display the application extended attributes:
12
13                 $ xattr -l /Applications/AltosUI.app
14                  com.apple.quarantine:
15                  0181;5a380dfb;Google\x20Chrome.app;6B17C3F9-68D3-4C27-A5EA-7ADADE376ACD
16
17     This shows that the app was downloaded using google chrome. Other
18     users' values will be different but the com.apple.quarantine
19     prefix will be the same!). If this attribute is present
20     AltosUI.app won't be allowed to run.
21
22 1. Use the following command to remove the attribute preventing MacOS
23     X from running this application:
24
25                 $ sudo xattr -c /Applications/AltosUI.app
26
27     This clears the extended attribute in question.  You should now be
28     able to run our app!
29
30 1. Check to make sure the attribute has been cleared:
31
32                 $ xattr -l /Applications/AltosUI.app
33
34 NOTE: this has to be run every time one installs a new version!