# WorkSpaces Applications Client Application for macOS Client for macOS The following information helps you use the WorkSpaces Applications client for macOS to connect to WorkSpaces Applications and stream applications. **Topics** + [ # Requirements ](client-application-mac-requirements-user.md) + [ # Setup and installation for macOS ](client-application-mac-installation-user.md) + [ # Connect to WorkSpaces Applications on macOS client ](client-application-mac-start-streaming-session-user.md) + [ # Monitors ](client-application-windows-mac-display-resolution-user.md) + [ # Video and Audio Conferencing ](video-audio-mac.md) + [ # Relative Mouse Offset ](client-application-mac-relative-mouse-offset-user.md) + [ # Remap the Windows Logo Key or Command Key ](remap-windows-logo-key.md) + [ # Remember My Settings ](remember-settings-mac.md) + [ # Printer Redirection ](client-application-mac-local-printer-redirection.md) + [ # Disconnect and End Session ](disconnect-end-mac.md) + [ # Troubleshooting ](client-application-mac-troubleshooting-user.md) + [ # WorkSpaces Applications macOS Client Release Notes ](client-release-versions-mac.md) # Requirements The WorkSpaces Applications client for macOS must be installed on a computer that meets the following requirements: + Operating system — macOS 13 (Ventura), macOS 14 (Sonoma), or macOS 15 (Sequoia) + Hard drive space — 200 MB minimum # Setup and installation for macOS Follow these steps to download and install the client application. 1. On your macOS device, open [Amazon WorkSpaces Applications Downloads](https://clients.amazonappstream.com/), and choose the macOS link. 1. Download and install the application. 1. Verify that the WorkSpaces Applications client application icon appears on your Mac Launchpad, or check in `/Users/username/Applications/` or `~/Applications`. # Connect to WorkSpaces Applications on macOS client After the WorkSpaces Applications client for macOS is installed on your PC, you can use it to connect to WorkSpaces Applications. **Topics** + [ # WorkSpaces Applications macOS Client Connection Mode ](client-application-mac-connection-modes-user.md) + [ # Connect to WorkSpaces Applications ](client-application-mac-how-to-connect-user.md) # WorkSpaces Applications macOS Client Connection Mode The WorkSpaces Applications macOS client supports two connection modes: *Classic mode* and *Desktop view*. Your administrator will set up the connection mode for you. **Classic mode** When you use classic application mode, you work with remote streaming applications in the WorkSpaces Applications session window. If your administrator has made more than one application available to you, you can open multiple applications during your session. All applications that you open are displayed in the same WorkSpaces Applications session window. When you connect to WorkSpaces Applications in classic mode, the WorkSpaces Applications Application Launcher window opens and displays the list of applications that are available for you to stream. When you open a streaming application in this mode, the Application Launcher window closes, and the application opens in the WorkSpaces Applications session window. **Desktop view** When you connect to WorkSpaces Applications and choose **Desktop view**, WorkSpaces Applications provides a standard Windows desktop view for your streaming session. The icons of applications that are available for you to stream appear on the Windows desktop. In addition, the WorkSpaces Applications toolbar, which enables you to configure settings for your streaming session, appears in the top left area of your streaming session window. # Connect to WorkSpaces Applications Follow these steps to connect to WorkSpaces Applications and start an application streaming session. 1. If your administrator requires you to sign in first through your organization's sign-in page, complete the tasks in this step, then proceed to step 3. If your administrator doesn't require you to sign in through your organization's sign-in page, skip the tasks in this step and proceed to step 2. 1. Navigate to your organizational sign-in page and enter your domain credentials when prompted. 1. After you sign in, you are redirected to the WorkSpaces Applications Application Manager catalog page, which displays one or more applications that are available for your WorkSpaces Applications streaming session. **Desktop View** is also available, if enabled by your administrator. 1. Choose an application or, if available, **Desktop View**. 1. If your administrator doesn't require you to sign in first through your organization's sign-in page, complete the following steps to start the WorkSpaces Applications client: 1. On your local computer where the WorkSpaces Applications client is installed, choose **Amazon WorkSpaces Applications** to start the WorkSpaces Applications client. 1. Do either of the following: + If the client sign-in page is prepopulated with a web address (URL), choose **Connect**. You will be redirected to the system's default web browser for authentication before transitioning into the streaming session in the macOS client. + If the client sign-in page is not prepopulated with a URL, enter the URL that your WorkSpaces Applications administrator provided for WorkSpaces Applications, and then choose **Connect**. You might also be redirected to the system's default web browser for authentication before transitioning into the streaming session in the macOS client. If you don't know the URL, contact your administrator. 1. After a few moments, the WorkSpaces Applications Application Manager catalog page opens, displaying one or more applications that are available for your WorkSpaces Applications streaming session. **Desktop View** is also available, if enabled by your administrator. 1. Choose an application or, if available, **Desktop View**. 1. Depending on the authentication settings that your WorkSpaces Applications administrator enabled, after you choose an application or **Desktop View**, you might be prompted to enter your Active Directory domain credentials to sign in to your WorkSpaces Applications session. If this is the case, enter your Active Directory domain password, and then choose **Password sign in**. # Monitors ## Monitors and Display Resolution The WorkSpaces Applications client supports multiple monitors with the following display resolutions: + Multiple monitors (up to 4K resolution) — Up to 4 monitors with a maximum display resolution of 4096x2160 pixels per monitor **Important** Higher resolution monitors require significantly more compute capacity and encoding resources to stream content effectively, with actual performance depending on your display configuration (resolution and number of monitors) and the compute instance being used. If you experience suboptimal performance on 4K monitors, we recommend reducing your display resolution to improve responsiveness. Ultrawide monitors with resolutions exceeding 4096 pixels in either dimension (e.g., 5120x2160) will display black bars on the sides, as the maximum supported resolution is limited to 4096 pixels per dimension. If you prefer a fixed resolution, which does not change even when the client window is resized, choose **Settings**, **Display**, **Display Resolution**, and specify the desired resolution. To re-enable automatic resizing, choose **Adapt automatically**. ## Using Multiple Monitors When using multiple monitors, you can choose from the following options: + Extend full-screen across a *single* monitor + Extend full-screen across *all* monitors + Extend full-screen across *selected* monitors ### Extending full-screen across a single monitor You can extend full screen only on the current monitor if multiple monitors are connected to your local computer. To enable this feature, complete the following steps: 1. On the toolbar at the top of the window, choose the Full Screen (crossed arrows) icon. 1. From the drop-down menu, choose **Full screen current monitor**. ### Extending full-screen across all monitors You can extend the display for a session across all monitors at full screen resolution. The extended display matches your physical display layout and screen resolutions. For example, three monitors are connected to your local computer. The server extends the display for a session across all three monitors and matches the specific screen resolutions of your display. To enable this feature, complete the following steps: 1. On the toolbar at the top of the window, choose the Full Screen (crossed arrows) icon. 1. From the drop-down menu, choose **Full screen all monitors**. ### Extending full-screen across selected monitors If there are three or more monitors connected, WorkSpaces Applications can also extend full-screen across a selection of those available monitors. If your selected monitors cannot go full screen, an error message will appear and you will need to perform the procedure again. Selected monitors must be set adjacent, or sharing a side with each other, in your display setting. The following are examples of adjacent monitor placement. If your monitors are not set adjacent in your display configuration, you must exit WorkSpaces Applications and change your Display settings on your local machine. **Note** The blue boxes are WorkSpaces Applications-enabled monitors, and the gray boxes are other monitors. ![\[Adjacent and nonadjacent monitor placement\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/monitors.PNG) To enable this feature, complete the following steps: 1. On the toolbar at the top of the window, choose the Full Screen (crossed arrows) icon. 1. From the drop-down menu, choose **Full screen selected monitors**. 1. The **Full screen selected monitors** window appears, displaying your current monitor layout. Select which monitors you want DCV to be displayed full screen, and choose **Apply**. # Video and Audio Conferencing WorkSpaces Applications real-time audio-video (AV) redirects your local webcam video input to WorkSpaces Applications streaming sessions. That way, you can use your local devices for video and audio conferencing within your WorkSpaces Applications streaming session. To use a webcam or a microphone on WorkSpaces Applications, choose **Settings** on the system menu and **Audio & Video** to enable or disable the microphone and webcam. If you have more than one webcam (for example, if you have a USB webcam that is connected to your laptop and a built-in webcam), you can also select one webcam from **Active Webcam**. If you have selected **Show Toolbar**, you can also enable or disable the microphone and webcam by choosing the microphone or video icon. If you have more than one webcam, you can select the down arrow next to the video icon, and select one webcam to use. **Note** If the video icon doesn't display in the WorkSpaces Applications toolbar, contact your WorkSpaces Applications administrator. Your administrator might need to perform additional configuration tasks, as described in [Real-Time Audio-Video](feature-support-real-time-av.md). # Relative Mouse Offset By default, during a streaming session, WorkSpaces Applications transmits information about mouse movements by using absolute coordinates and rendering the mouse movements locally. For graphics-intensive applications, such as computer-aided design (CAD)/computer-aided manufacturing (CAM) software or video games, mouse performance improves when relative mouse mode is enabled. Relative mouse mode uses relative coordinates, which represent how far the mouse moved since the last frame, rather than the absolute x-y coordinate values within a window or screen. When you enable relative mouse mode, WorkSpaces Applications renders the mouse movements remotely. You can enable this feature during an WorkSpaces Applications streaming session in either of the following ways: + Pressing Ctrl\$1Shift\$1Fn\$1F8 + Choosing **Enable relative mouse** from the **Settings ** and enabling it. # Remap the Windows Logo Key or Command Key You can remap the Mac Option and Command keys on your keyboard. A *modifier* key modifies the action of another key when you use both keys together. You can use a modifier key with another key to perform a task such as printing. A *Meta* key is a special type of modifier key. You can use a Meta key to temporarily change the function of another key when you use both keys together. To remap the Mac Option and Command keys, choose **Settings** and **Keyboard & Mouse**. You can remap the Option key to the following keys during a streaming session: + Remote Alt key + Local modifier key You can remap the Command key to the following keys during a streaming session: + Remote Control key + Meta key # Remember My Settings The WorkSpaces Applications macOS client application can save the preferences you configured in **Settings** for future sessions, except for **Audio & Video** settings. If you want to remember your audio (microphone) and video (webcam) settings for future sessions, choose **Settings**, **Audio & Video**, and **Remember Audio & Video (enabled/disabled) for future sessions**. When you enable this function, your audio (microphone) and video (webcam) settings are saved and persist across sessions when you access the same stack from the macOS client on the same device. # Printer Redirection WorkSpaces Applications local printer redirection lets you access printers that are connected to your local computer from your WorkSpaces Applications streaming session. That way, you can redirect print jobs from your streaming application to a local printer, or to a network printer that you have mapped. **Important** To use WorkSpaces Applications printer redirection, you must have the WorkSpaces Applications client installed on your local computer, and you must use the client to connect to a streaming session. Printer redirection is not available when you connect to WorkSpaces Applications by using a web browser. **To redirect a print job to a local printer** 1. Open the WorkSpaces Applications client and connect to a streaming session. 1. In your streaming application, choose **File**, **Print Now**. 1. The **Print** dialog box for your streaming application opens. 1. In the **Print** dialog box, a list of available local printers is displayed. Choose the local printer that you want to use, and then proceed with printing. # Disconnect and End Session To disconnect the streaming session, choose one of the following options: + On the WorkSpaces Applications toolbar, choose **Disconnect**. + On your Mac, on the menu bar at the top of the screen, choose **Amazon WorkSpaces Applications** and **Disconnect**. You can reconnect to the previous streaming session after a disconnection within a timeout time interval. The amount of time that a streaming session remains active after you disconnect is configured by your administrator. To end the current session, choose one of the following options: + On the WorkSpaces Applications toolbar, choose **End Session**. + On your Mac, on the menu bar at the top of the screen, choose **Amazon WorkSpaces Applications** and **End Session**. When you end the session, you are prompted to save any open documents, and you are immediately disconnected from the streaming instance. # Troubleshooting Use the following steps to enable diagnostic log uploads and determine your client version and client ID. ## Enable Diagnostic Log Uploads To troubleshoot issues with the WorkSpaces Applications client, you can enable diagnostic logging. The log files that are sent to WorkSpaces Applications include detailed information about your device and connection to the AWS network. You can enable diagnostic log uploads before or during WorkSpaces Applications streaming sessions, so these files are sent to WorkSpaces Applications automatically. As a best practice, we recommend that you enable log upload to help the WorkSpaces Applications team troubleshoot issues. To enable file logging, follow these steps: 1. Choose **AppStream 2.0** from the system menu bar, or navigate to the top-right corner of the **Connect** page. 1. Choose **Client Options** and **Client automatic logging**. ## Collect Logs for WorkSpaces Applications Client for macOS WorkSpaces Applications logs can be used by your administrator to identify and troubleshoot configuration issues. They can also help enable AWS Support to diagnose and troubleshoot cases. To collect and share the logs, choose from the following options: + Option 1: Open a terminal and enter **open \$1/Library/Containers/com.amazon.appstreamclient/Data/logs** + Option 2: Open **Finder**, and choose **Users**, **User\$1Name**, **Library**, **Containers**, **Appstream**, **Data**, and **logs** + Option 3: Open **Finder**, and from the top-left system menu bar, choose **Go** and **Go to folder**. Enter **\$1/Library/Containers/com.amazon.appstreamclient/Data/logs** ## Determine Client Version and Client ID If issues occur when you use the WorkSpaces Applications client for macOS, your WorkSpaces Applications version number and client ID can help your administrator and AWS support team with troubleshooting. To find the version of the WorkSpaces Applications client that you have installed, open the WorkSpaces Applications client. On the system menu bar, choose **Amazon WorkSpaces Applications** and **About Amazon AppStream 2.0**. The client version is displayed below the Amazon WorkSpaces Applications logo. To find the client ID of the WorkSpaces Applications client that you have installed, choose **Amazon WorkSpaces Applications** on the system menu bar, or navigate to the top-right corner of the **Connect** page and choose **Client Option**. # WorkSpaces Applications macOS Client Release Notes Client Release Notes The following table describes the latest updates that are available in released versions of the macOS WorkSpaces Applications client. | Client version | Release date | Changes | | --- | --- | --- | | 1.3.0 | 02-10-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions-mac.html) | | 1.2.0 | 11-06-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions-mac.html) | | 1.1.0 | 06-02-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions-mac.html) | | 1.0.1 | 03-25-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions-mac.html) | | 1.0.0 | 12-19-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions-mac.html) |