Release Notes

Software Client for macOS 23.01.1

Release 23.01.1 of the Software Client for macOS is a maintenance release which replaces and deprecates 23.01.

It includes the following:

  • Health Menu on MacOS 13 (Ventura) with AV-Lock Fixed (174037)


    Anyware Health Monitor now shows correct color space when in GPU Offload Mode (171126)


    Cancel button now works as expected when exiting a connection (158607)

Previous release information:

The PCoIP Software Client for macOS 23.01 introduces the following features and enhancements:

  • Connection Health Indicator: This release introduces a new Connection Health Indicator to the Software Client for macOS. This feature allows users to monitor the health of an active PCoIP session, including live statistics for frame rate, network packet loss, and network latency. See Connection Health Indicator for more information.

  • Collaboration: A new Collaboration manager replaces the collaboration management console, providing an improved interface and streamlining the process of generating and accepting collaborators. The collaboration manager displays a list of connected users, and allows the session owner to enable or disable input control for collaborators during the session.

    Important: Note that all of the session owner's monitors that are in the PCoIP session will be shared when collaborating. In windowed mode or fullscreen one monitor mode, this will be the a single display. In fullscreen all monitors mode, all screens are shared.

    For more information, see the PCoIP agent guide for your host system:

  • Interface Improvements: Continued improvements have been added to the Software Client for macOS:

    • You can now set the client to remember your username on the client authentication page.

    • The domain name is now visible on the authentication page, making it clear what domain you're logging into.

    • A new Desktop info option has been added to the desktop selection screen. This feature allows you to view information about the remote desktop, such as its resource name, ID, and available protocol. See Viewing Information About Your Desktops for more information.

  • Smoother video playback with AVLock when using High Performance (Legacy) mode.

  • Wacom Tablet Force Proportions: You can now enable the Tablet Force Proportions feature of your Wacom tablet in a PCoIP session to constrain the horizontal and vertical proportions of your display to the proportions of the tablet. For more information, see Tablet Force Proportions.

  • Bug fixes and stability enhancements.

Resolved Issues

Health Menu on MacOS 13 (Ventura) with AV-Lock Fixed


When accessing the Anyware Health monitor on a Mac running MacOS 13 (Ventura) with AV-Lock enabled, the client would unexpectedly disconnect. This issue is now fixed.

Anyware Health Monitor now shows correct color space when in GPU Offload Mode


The Anyware Health Monitor now indicates the correct color space when in GPU offload mode. Previously, the health monitor could incorrectly show BGRA 8|8|8|8 when in GPU offload mode.

Custom Broker Authentication Prompt Field is Scrollable


If the text provided by a custom broker is longer than the available space on the authentication forms a scrollbar will appear to be able to scroll to see the entire text.

Cancel button now works as expected when exiting a connection


The cancel button now works as expected when exiting a connection. Previously, the cancel button could have no effect under certain conditions.

Known Issues

PCoIP Client quits unexpectedly when exiting full screen while audio source is running (MacBook Pro)


Exiting full screen mode while an audio source is running may cause the session to quit unexpectedly. This issue affects clients running on recent MacBook Pro hardware.


Stop audio sources, including video with audio, before leaving full-screen mode to avoid this issue.

If the session does disconnect, reconnecting will resume the session.

Bottom of the screen is cut off on MacBook with Notch Screen


On recent models of MacBook Air and MacBook Pros with a camera notch in the display, the bottom of a full-screen session may be cut off. This can result in UI elements, including the system dock, not being fully visible or accessible.


On MacBook's with a camera notch screen, turn on 'Scale to fit below built-in camera' for the Anyware Client application to avoid this issue.

See instructions here: How to adjust an app's settings to appear below the camera area on your 13.6-inch MacBook Air, 14-inch MacBook Pro, or 16-inch MacBook Pro - Apple Support (CA)

Anyware Health Monitor Shows Extra Displays in Dropdown List


When switching from Full Screen All Monitors to a single monitor or window, the Anyware Health window display selection drop-down beside the framerate field may show more than one display on the list.


If more than one display is listed when there is only one monitor or window in the session, be sure to select "Display 1" to see the correct framerate data.

The name of network shown in Anyware Health Monitor does not change during a session


In Anyware Health Monitor, the name of network shown will not change during a session even if the actual network changes.

For example, if an ethernet cable is pulled out and the system switches to WiFi, the name of network will not change in the Anyware Health Monitor display until the session is disconnected and reconnected.

When entering credentials, pressing Enter in Username field does not advance cursor to Password field


Pressing Enter on the Username field does not advance the text entry cursor to the Password field.


Use the Tab button or mouse to move from the Username field to the Password field.

USB flash drives cannot be connected to a remote PCoIP Agent


Starting with macOS Big Sur, mass storage devices are no longer permitted to be remotely connected to an external system via USB.


File sharing services can be used to share files.

Resizing collaboration session window causes crash


Re-sizing the PCoIP Client window while participating in a PCoIP Ultra Collaboration session may cause the PCoIP client to crash.


Avoid re-sizing client window size while participating in a PCoIP Ultra Collaboration session.

If this occurs, re-start the collaboration session by sending a new invitation to the Guest Collaborator.

MacOS support bundler issues


Several issues have been identified with the support bundler for the macOS client.

Upgrade to 22.07 onward & multi-monitor scenario


From release 22.07, multi-monitor scenario relies on the "Displays have separate Spaces" in Mission Control preferences on macOS client. "Displays have separate Spaces" must be selected for Anyware PCoIP session to work properly in full screen.


If it's unchecked then other displays may go to black in full screen mode.

Keyboard and Mouse Freeze when Connected to Remote Workstation Card in Windowed Mode


Keyboard and Mouse can freeze when connected to a Remote Workstation Card while the Soft Client is in windowed mode.


If this occurs, switch the client to full-screen mode to reestablish Keyboard and Mouse functionality.

Black Screen on Full Screen All Monitors


The PCoIP Client for macOS can generate an additional black desktop when going to full-screen all monitors on certain hardware configurations. This can appear as a black desktop in Mission Control, and  one of your monitors may appear black.


Revert to PCoIP Client 22.04, or check "Displays have separated Spaces" in Mission Control Preferences on 22.07.0+.


High Performance Client in PCoIP Ultra GPU Offload stops responding after extended period of inactivity


A session accessed with High Performance Client in PCoIP Ultra GPU Offload mode may stop responding after an extended period of inactivity, such as being left running overnight.


If a session becomes non-responsive, restart the client and reconnect the session.

If a session is required to stay running for an extended period of inactivity, use PCoIP  or PCoIP Ultra CPU offload to avoid this issue.

Starting a PCoIP session using a browser URI while another instance is running


If a PCoIP client instance is already running, attempting to launch a new PCoIP sesion with a browser URI will not work.


Close the running instance before launching a new instance.

Menu can only be brought up on primary display


On the Software Client for macOS, when in full-screen all monitors mode, the in-session menu may only be available from the primary monitor.


If you are unable to make the menu appear on a secondary monitor, use local mission control, select full screen on that monitor to re-set focus on that screen.

Local spotlight search may not function


Local Spotlight Search may not function on the local machine while the PCoIP Client has an active session.

Resizing PCoIP client window may cause client to be non-responsive (High Performance Client mode only)


Resizing PCoIP client window while a video is played on agent may cause client to be non-responsive.


Avoid resizing while video is played on agent.

Topology changes may cause client to be non-responsive (High Performance Client mode only)


Topology changes such as moving windows across monitors may cause client to be non-responsive.


Avoid moving windows across the monitors or resizing them while in High Performance Client mode.

Client machine reboot interrupted while session is in progress


If you attempt to re-start your client Mac while your PCoIP client is in session, the session will terminate, but the Mac restart will be disrupted.  When this occurs, you will have to close the PCoIP Client application and initiate the OS restart a second time.

Session recovery after macOS sleep


If the client machine is put to sleep during a PCoIP session, it may not successfully re-connect to the PCoIP session once the client machine wakes up. If this occurs restart the PCoIP Client application to reconnect to the session.

Frozen session


Frequent switching between window and full screen modes can result in a frozen session. If this occurs disconnect the session and reconnect.

Changing the audio sample rate during session


Changing the audio sample rate when using a media application while connected to a PCoIP session will cause distorted audio quality. To correct this audio quality issue, you will need to disconnect and re-establish the PCoIP connection.


Disconnect and re-establish the PCoIP connection to correct this audio quality issue.

Quitting the application from the macOS dock & reconnect


While in High Performance Mode, quitting the application from the macOS dock will result in an error and subsequent connection attempts will fail.  If this occurs close the PCoIP Client application and re-open it to start a new connection.


Use the “Disconnect” in-session menu to disconnect a PCoIP session, while in High Performance Mode.

Caps lock key does not work while in High Performance Mode


Caps Lock does not currently work in the PCoIP Client for macOS while in High Performance Mode


Use the Shift key instead.

Increased memory usage when switching between windowed and full screen modes


Frequent switching between window and full screen modes can result in increased memory usage.

macOS client only detects audio output device at session start


The macOS client will not detect a change in the audio output device while in session.


Disconnect and reconnect to the session when changing the audio output device.

Quitting Mac client while in-session, returns to the pre-session window.


The Mac client cannot be exit while connected to a PCoIP Agent. Selecting the Quit Teradici  PCoIP Client system menu will disconnect the client and return to the pre-session window, but not quit the application. The client application will instead return to the saved desktop selection screen.


To quit the Mac client, first disconnect the session and then quit the client.

macOS client may only minimize one display on OS X 10.11


If you launch the PCoIP Software Client in OS X 10.11 and you have not clicked anywhere within the display before using the minimize hot key (Ctrl+Alt+M), the display that has not been used will not be minimized. This does not occur in macOS 10.12 (Sierra) or 10.13 (High Sierra).


Click with the mouse on both displays of the client any time before pressing Ctrl+Alt+M, and both displays will be minimized.

USB Flash drives fail to bridge at times


USB Devices dialog (from Connection > USB Devices menu) may freeze for a few seconds after clicking the connect or disconnect button associated with a USB Flash drive. When this happens after clicking connect, the device fails to connect. When this happens after clicking disconnect, the device is successfully disconnected.


Retry by clicking connect again on the USB Devices dialog.

USB DVD drive unavailable on client USB Devices dialog in macOS


If a DVD drive is connected to a client via a USB hub and the device is bridged quickly after connecting to a host, or if the device is unplugged from the hub and re-plugged, its status will be Unavailable and users will not be able to bridge the device.


Unplug and re-plug the USB hub.

macOS French localization disables View > Show Fullscreen toolbar menu


When the client locale is set to French in macOS, the View > Show Fullscreen/Leave Fullscreen dropdown menus may not be accessible.


Enter the Ctrl-Alt-Enter key sequence to toggle between fullscreen and windowed modes.

Datalogic barcode scanner cannot be redirected when bridged in macOS


The Datalogic Quickscan QS6500 barcode scanner does not work when the device is bridged.


Do not bridge the device. The device works as expected with the remote host when it is not bridged.

Wacom Intuos Pro and Intuos 5 tablets cannot be bridged


These tablets work as a pointing device when a session is not active, and when the tablet is not bridged while a session is active. When the tablet is bridged, the device manager application running on the remote host displays a warning icon next to the tablet and the tablet does not work.

Intuos PTH-660 and PTH-860 tablets are not impacted by this issue.


Avoid bridging Intuos Pro and Intuos 5 tablets.

USB keyboards do not work in bridged mode


Keyboards do not work when bridged. This affects both Windows and macOS PCoIP Software Client.


Do not bridge the keyboard. Keyboards function correctly when locally terminated.

Client window size is not remembered when crossing multiple monitors


When stretching the client window across multiple monitors, client window size is not remembered for session reconnects.

Zooming in macOS while connected to hard host throws local and remote mouse out of sync


Using the zoom button on PCoIP Software Client for Mac will result in a desynchronization of mouse pointers when connected to hard hosts. Teradici recommends not using the zoom button on macOS while in a PCoIP Software Client session connecting to hard hosts.

Mouse out of sync due to scaling in dual high-resolution displays


Connecting a PCoIP Software Client session with dual high-resolution displays in full-screen mode (2560x1600 for example) to a hard host that does not support high-resolution displays may result in unexpected behavior. For example, one or both displays may be scaled to single link DVI resolutions without the client also scaling, resulting in unsynchronized mouse movement.


Set client desktop to single link DVI resolutions. Alternatively, upgrade host GPU to support dual-link resolutions (Tera2 hosts only)

Audio input in PCoIP Software Client with PCoIP Remote Workstation Card does not work


When in session with a PCoIP Remote Workstation Card, PCoIP Software Client supports audio out from the host, but not audio into the host.