Installation Guide: OS X

From UVLayout Docs

(Difference between revisions)
Jump to: navigation, search
Revision as of 07:43, 23 June 2016 (edit)
Headus (Talk | contribs)
(→El Capitan vs USB Dongles)
← Previous diff		 Current revision (02:25, 18 October 2024) (edit) (undo)
Headus (Talk | contribs)
(→Known Problems)
 
(10 intermediate revisions not shown.)
Line 1: Line 1:
-{{:Installation Guide: Menu}} [[Image:Install-X11-Prefs.png|right]] This page describes how to install or upgrade UVLayout onto OS X systems. Currently only Intel powered Macs running OS X Leopard (10.5) or newer are supported.+{{:Installation Guide: Menu}} [[Image:Install-X11-Prefs.png|right]] This page describes how to install or upgrade UVLayout onto OS X systems.
UVLayout runs under the X11 environment, but X11 is no longer bundled with the OS X UVLayout runs under the X11 environment, but X11 is no longer bundled with the OS X
operating system. You can however get a compatible version of X11/XQuartz from ... operating system. You can however get a compatible version of X11/XQuartz from ...
-:: http://www.xquartz.org/releases/XQuartz-2.7.8.html+:: https://www.xquartz.org/releases/XQuartz-2.8.1.html
- +
-{{warning|If prompted to upgrade to XQuartz 2.7.9 or later, select '''Skip''', as UVLayout doesn't currently work on those releases.}}+
We recommend before you install UVLayout that you run X11/XQuartz first, to make sure that it is working OK, and enable the "Focus Follows Mouse" preference (see image right). This only affects applications run through the X11 environment, which is most likely only going to be UVLayout, so don't worry about any adverse effects. We recommend before you install UVLayout that you run X11/XQuartz first, to make sure that it is working OK, and enable the "Focus Follows Mouse" preference (see image right). This only affects applications run through the X11 environment, which is most likely only going to be UVLayout, so don't worry about any adverse effects.
-To install UVLayout, open the supplied UVLayout.dmg disk image file and follow the instructions in the Read-Me.txt file.+:1. To install UVLayout, open the supplied UVLayout.dmg disk image file and follow the instructions in the Read-Me.txt file.
-If this is the first time you have installed UVLayout, you will need to activate it by cut'n'pasting your license key into the keys file. Instructions on that are [[Installation_Guide:_Licensing#Running_the_licensing_GUI|here]].+:2. If this is the first time you have installed UVLayout, you will need to activate it by cut'n'pasting your license key into the keys file. Instructions on that are [[Installation_Guide:_Licensing#Running_the_licensing_GUI|here]].
 + 
 +== Gatekeeper ==
 + 
 +[https://en.wikipedia.org/wiki/Gatekeeper_%28macOS%29 Gatekeeper], first introduced in OS X Mountain Lion, is a Mac security feature which prevents the user from launching potentially harmful applications downloaded from the internet and not the Apple Store.
 + 
 +Because UVLayout will get caught out by this, you need to tell Gatekeeper that UVLayout is a trusted application. Right-click (or Control-click) on the UVLayout icon and select Open. You’ll still receive an alert message, but this time an Open button will be visible in the message panel, so click that and UVLayout will then run.
== Known Problems == == Known Problems ==
 +
 +* Because an Apple Magic Mouse has no middle button, open up the [[User Guide: About UVLayout#Mouse_Settings|Mouse Settings]] and select '''2''' buttons. You can then use the Left button to rotate, the Right to move, and both together or Ctrl-Right to scale/zoom.
* If UVLayout stops working after upgrading your version of OS X, try removing and reinstalling X11/XQuartz (see above). * If UVLayout stops working after upgrading your version of OS X, try removing and reinstalling X11/XQuartz (see above).
Line 30: Line 36:
chmod -R a=u-w,u+w /Applications/headus-UVLayout-*.app chmod -R a=u-w,u+w /Applications/headus-UVLayout-*.app
</ul></ul> </ul></ul>
- 
-== El Capitan vs USB Dongles == 
- 
-In our own testing, we had no problems with OS X El Capitan recognizing  
-a UVLayout Pro version USB Dongle, but one of our users reported that 
-their dongle wasn't being detected.  
- 
-It turned out that  
-[https://en.wikipedia.org/wiki/System_Integrity_Protection SIP] was causing 
-their issues, so they disabled it. Here are those instructions in 
-case anyone else encounters the same problem: 
- 
-# Reboot and hold Command + R to go into Recovery Mode. 
-# Go to Terminal under Utilities. 
-# Type in '''csrutil disable'''. A comment will be displayed that your csrutil has been disabled. 
-# Reboot normally. 

Current revision

Cover Page
Introduction
Requirements
Windows
Linux
OS X
Licensing
Download PDF
This page describes how to install or upgrade UVLayout onto OS X systems.

UVLayout runs under the X11 environment, but X11 is no longer bundled with the OS X operating system. You can however get a compatible version of X11/XQuartz from ...

https://www.xquartz.org/releases/XQuartz-2.8.1.html

We recommend before you install UVLayout that you run X11/XQuartz first, to make sure that it is working OK, and enable the "Focus Follows Mouse" preference (see image right). This only affects applications run through the X11 environment, which is most likely only going to be UVLayout, so don't worry about any adverse effects.

1. To install UVLayout, open the supplied UVLayout.dmg disk image file and follow the instructions in the Read-Me.txt file.
2. If this is the first time you have installed UVLayout, you will need to activate it by cut'n'pasting your license key into the keys file. Instructions on that are here.

[edit] Gatekeeper

Gatekeeper, first introduced in OS X Mountain Lion, is a Mac security feature which prevents the user from launching potentially harmful applications downloaded from the internet and not the Apple Store.

Because UVLayout will get caught out by this, you need to tell Gatekeeper that UVLayout is a trusted application. Right-click (or Control-click) on the UVLayout icon and select Open. You’ll still receive an alert message, but this time an Open button will be visible in the message panel, so click that and UVLayout will then run.

[edit] Known Problems

  • Because an Apple Magic Mouse has no middle button, open up the Mouse Settings and select 2 buttons. You can then use the Left button to rotate, the Right to move, and both together or Ctrl-Right to scale/zoom.
  • If UVLayout stops working after upgrading your version of OS X, try removing and reinstalling X11/XQuartz (see above).
  • If you launch UVLayout and nothing appears to happen, check if you have your display configured for dual monitors, but only one is plugged in or turned on. If you turn on the second screen and find UVLayout there, you can drag it back to the main screen and "pin" it with the top left most button in the UVLayout GUI.
  • If you launch UVLayout and the "Starting UVLayout" dialog appears, but nothing happens after that, try starting X11/XQuartz first and then launch UVLayout. If that doesn't help, reboot your Mac to kill any zombie processes that might be interfering with UVLayout's normal start-up procedure.
  • If your whole screen goes gray after launching UVLayout, it means that X11 is running in full screen mode. You can toggle this with Cmd-Opt-A, and then go to the X11 preferences to turn it off permanently.
  • Very poor drawing performance? See the OpenGL preference.
  • If users other than the installing user get "Permission Denied" errors when trying to run UVLayout, open a Terminal window and run ...
      chmod -R a=u-w,u+w /Applications/headus-UVLayout-*.app
Retrieved from "http://doc.uvlayout.com/Installation_Guide:_OS_X"