Release Notes

Software Client for macOS 21.10

Release Overview

These release notes provide a summary of key additions, compatibility notes, resolved issues, and known issues for the PCoIP Software Client 21.10 for macOS.

What's New in This Release

This release of the PCoIP Software Client for macOS contains the following updates:

Security and Stability Updates

Increased security and stability updates and enhancements around the PCoIP Client.

Multi-Channel Audio Output Supported

Support for Multi-Channel Audio Output (2.1, 5.1, 7.1 channel configuration) is now supported when connecting the PCoIP Software Client for macOS to PCoIP Agent for macOS.

PCoIP High Performance Client

The PCoIP High Performance Client enables higher frame-rates with fewer dropped frames than the default PCoIP Software Client. Standard PCoIP Client mode is still recommended for most use cases, the High Performance Client is recommended for the presentation of high frame rate content such as video or animations.

Audio Output Devices

With this release users can now change audio output devices in-session. For example, plugging in headphones on a MacBook will switch audio output from built in speakers to the headphones for the PCoIP session. This is limited to audio output devices with the same number of output channels. For example, when switching between stereo speakers to stereo headphones. If a user needs to switch between devices with a different number of channels, they will still have to re-start the PCoIP session to negotiate the change in audio channels.

Release History

Version/Build

Date

Description

3.5 April 2018 GA release
3.6.1 July 2018 GA release
3.7.0 October 2018 GA release
3.8.0 February 2019 GA release
19.05 May 2019 GA release
19.08 August 2019 GA release
19.11 November 2019 GA release
20.01 January 2020 GA release
20.04 April 2020 GA release
20.07 July 2020 GA release
20.10 October 2020 GA release
21.01 January 2021 GA release
21.03 April 2021 GA release
21.07 August 2021 GA release

Compatibility 


 

Supported Clients

PCoIP Software Client for Mac

PCoIP Software Client for Mac is compatible with the following Apple operating systems:

  • macOS Catalina (10.15) Darwin v19
  • macOS Big Sur (11.0) Darwin V20 This OS does not support connecting USB devices to a remote desktop.
  • Apple M1 Hardware. This processor does not support USB or PCoIP Ultra.

 

Supported Hosts

Teradici Cloud Access Software Agents
PCoIP Remote Workstation Cards
Resolved Issues

Fixed an issue where the client may use the wrong resolution in windowed mode.

118341

The client now correctly determines the size of the window.

Known Issues

Enabling the AVLock from the menu has no effect if PCoIP ultra is not enabled

143588

While in High Performance Mode, enabling the "PCoIP Ultra AVLock" from the menu while PCoIP Ultra is not enabled on the agent will not have any effect.

Workaround:

PCoIP Ultra must be enabled on the agent to ensure "PCoIP Ultra AVLock" is functional once enabled on the client.

Client machine reboot interrupted while session is in progress

142823

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

142815

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.

Codec in Statistics Overlay might be wrong

141402

The Statistics Overlay on macOS Client in High Performance mode shows the incorrect video codec while the client is in “PCoIP Ultra GPU” mode, showing only “PCoIP Ultra” in the codec field.

Frozen session

140245

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

140205

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.

Workaround:

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

Client sometimes fails to connect to remote desktop

139423

Some models of MacBook Pro with dual GPU configuration may occasionally fail to connect to a remote desktop. The connection fails with the message "This desktop has no resources…"

Local spotlight search may not function

139264

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

Quitting the application from the macOS dock & reconnect

139152

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.

Workaround:

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

138394

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

Workaround:

Use the Shift key instead.

Increased memory usage when switching between windowed and full screen modes

134003

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

macOS client only detects audio output device at session start

132429

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

Workaround:

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

macOS client may only minimize one display on OS X 10.11

61740

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).

Workaround:

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

52465

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.

Workaround:

Retry by clicking connect again on the USB Devices dialog.

USB DVD drive unavailable on client USB Devices dialog in macOS

50179

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.

Workaround:

Unplug and re-plug the USB hub.

macOS French localization disables View > Show Fullscreen toolbar menu

45719

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

Workaround:

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

Datalogic barcode scanner cannot be redirected when bridged in macOS

44028

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

Workaround:

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

41045

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.

Workaround:

Avoid bridging Intuos Pro and Intuos 5 tablets.

USB keyboards do not work in bridged mode

40580

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

Workaround:

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

Client window size is not remembered when crossing multiple monitors

32597

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

30248

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

29862

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.

Workaround:

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

26355

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