# WorkSpaces Applications Client Application for Windows The following information helps you use the WorkSpaces Applications client for Windows to connect to WorkSpaces Applications and stream applications. **Topics** + [ # Features ](client-application-windows-features-user.md) + [ # Requirements ](client-application-windows-requirements-user.md) + [ # Setup for Windows ](client-application-windows-installation-user.md) + [ # Connect to WorkSpaces Applications on Windows Client ](client-application-windows-start-streaming-session-user.md) + [ # Monitors ](client-application-windows-monitors-display-resolution-user.md) + [ # USB Devices ](client-application-windows-how-to-share-usb-devices-user.md) + [ # Local File Access ](client-application-windows-file-system-redirection.md) + [ # Printer Redirection ](client-application-windows-local-printer-redirection.md) + [ # Video and Audio Conferencing ](client-application-windows-how-to-use-local-webcam-user.md) + [ # Drawing Tablets ](client-application-windows-drawing-tablets-user.md) + [ # Relative Mouse Offset ](client-application-windows-relative-mouse-offset-user.md) + [ # Logging ](client-application-windows-how-to-enable-diagnostic-logging-user.md) + [ # Troubleshooting ](client-application-windows-troubleshooting-user.md) + [ # WorkSpaces Applications Windows Client Release Notes ](client-release-versions.md) # Features The WorkSpaces Applications client for Windows is an application that you install on your Windows PC. This application provides additional capabilities that are not available when you access WorkSpaces Applications by using a web browser. For example, the WorkSpaces Applications client lets you do the following: + Use more than two monitors or 4K resolution. + Use your USB devices with applications streamed through WorkSpaces Applications. + Access your local drives and folders during your streaming sessions. + Redirect print jobs from your streaming application to a printer that is connected to your local computer. + Use your local webcam for video and audio conferencing within your streaming sessions. + Use keyboard shortcuts during your streaming sessions. + Interact with your remote streaming applications in much the same way as you interact with locally installed applications. # Requirements The WorkSpaces Applications client for Windows must be installed on a computer that meets the following requirements: + Operating system — Windows 10 (32-bit or 64-bit), Windows 11 (64-bit) + Microsoft Visual C\$1\$1 2019 Redistributable or later for WorkSpaces Applications client version 1.1.1066 and above. For information about the latest Visual C\$1\$1 redistributable packages for Visual Studio 2015, 2017, and 2019, see [The latest supported Visual C\$1\$1 downloads](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads) in the Microsoft Support documentation. + RAM — 2 GB minimum + Hard drive space — 200 MB minimum In addition, to install the WorkSpaces Applications USB driver for USB driver support, you must have local administrator rights on your PC. # Setup for Windows Follow these steps to install the client. 1. On the PC where you want to install the WorkSpaces Applications client, download the WorkSpaces Applications client for Windows application from [WorkSpaces Applications supported clients](https://clients.amazonappstream.com). 1. Navigate to the location where you downloaded the application .exe file, and then double-click the file to begin the installation. **Important** Contact your network administrator if nothing happens when you double-click the file or if an error message is displayed. Your organization might be using antivirus software that prevents the WorkSpaces Applications client installation program from running. 1. The installation wizard displays links to the AWS Customer Agreement, AWS Service Terms, and the AWS Privacy Notice, and third-party notices. Review this information, and then choose **Next**. 1. On the **Client Diagnostics** page, to enable the WorkSpaces Applications client to automatically upload device logs to help with troubleshooting issues, keep **Client logging** selected, and then choose **Next**. 1. On the **Optional Components** page, to enable your USB devices to be used with streaming applications, select the **WorkSpaces Applications Client USB Driver** check box, and then choose **Finish**. 1. If the **WorkSpaces Applications USB driver** wizard setup wizard opens, choose **Install**. 1. If prompted by **User Account Control** to choose whether to allow the app to make changes to your device, choose **Yes**. 1. When a message notifies you that the USB driver installation is complete, choose **Close**. The WorkSpaces Applications sign-in page opens. For information about how to connect to WorkSpaces Applications and start an application streaming session, see [Connect to WorkSpaces Applications](client-application-windows-how-to-connect-user.md). # Connect to WorkSpaces Applications on Windows Client After the WorkSpaces Applications client for Windows is installed on your PC, you can use it to connect to WorkSpaces Applications. **Topics** + [ # WorkSpaces Applications Client Connection Modes ](client-application-windows-connection-modes-user.md) + [ # Connect to WorkSpaces Applications ](client-application-windows-how-to-connect-user.md) + [ # How to Switch WorkSpaces Applications Connection Modes ](client-application-windows-how-to-switch-connection-modes-user.md) # WorkSpaces Applications Client Connection Modes The WorkSpaces Applications client provides two connection modes: *Native application mode* and *classic mode*. The connection mode that you choose determines the options that are available to you during application streaming, and how your streaming applications function and display. In addition, **Desktop view** is also available, if your administrator has enabled it. **Native application mode** Native application mode lets you work with remote streaming applications in much the same way that you work with applications that are installed on your local PC. When you connect to WorkSpaces Applications in native application 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 WorkSpaces Applications Application Launcher window remains open, and the application opens in its own window. During your streaming session, the remote streaming application functions in much the same way as a locally installed application. The application icon is displayed in the taskbar of your local PC, just as the icons do for your local applications. Unlike the icons for your local applications, the icons for your streaming applications in native application mode include the WorkSpaces Applications logo. During your WorkSpaces Applications streaming session, you can switch quickly between your locally installed applications and your remote streaming applications by clicking the taskbar icon of the remote or local application you want to work with. You can also switch WorkSpaces Applications connection modes. If you want to work in classic mode instead, you can switch from native application mode to classic mode. **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. If your administrator has not disabled native application mode, you can switch from classic mode to native application mode. For more information, see [How to Switch WorkSpaces Applications Connection Modes](client-application-windows-how-to-switch-connection-modes-user.md). **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 portal, 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, in the lower left of your screen, choose the Windows search icon on the taskbar and enter **AppStream** in the Search box. 1. In the search results, select ** Amazon AppStream** to start the WorkSpaces Applications client. 1. On the WorkSpaces Applications client sign-in page, you can choose whether to use the client in native application mode or classic mode. + To use native application mode, keep the **Start in native application mode** check box selected. + To use classic mode, clear the **Start in native application mode** check box. 1. Do either of the following: + If the client sign-in page is prepopulated with a web address (URL), choose **Connect**. + 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**. If you don't know the URL, contact your administrator. 1. After a few moments, the WorkSpaces Applications portal 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, do one of the following: + If your organization has enabled password authentication, enter your Active Directory domain password, and then choose **Password sign in**. + If your organization has enabled smart card authentication, select **Choose a smart card**, follow the instructions to choose your smart card certificate and enter your smart card PIN, and then choose **Smart card sign in**. + If your organization has enabled both authentication methods, either enter your Active Directory domain password and choose **Password sign in**, or select **Choose a smart card**, and follow the instructions to complete the smart card sign-in. # How to Switch WorkSpaces Applications Connection Modes If your administrator has not disabled native application mode for your streaming sessions, you can switch between native application mode and classic mode. **To switch from native application mode to classic mode** 1. In the upper left of the WorkSpaces Applications Application Launcher window, choose the **Settings** icon, and then choose **Switch to classic mode**. 1. When you switch to classic mode, the Application Launcher window closes and the WorkSpaces Applications session window opens. Any application that you are streaming in native application mode opens in the WorkSpaces Applications session window. Follow these steps to switch from classic mode to native application mode. **To switch from classic mode to native application mode** 1. In the upper left of the WorkSpaces Applications session window, choose the **Settings** icon, and then choose **Switch to native application mode**. 1. When you switch from classic mode back to native application mode, the WorkSpaces Applications session window closes and the WorkSpaces Applications Application Launcher window opens. Any application that you are streaming in classic mode opens in a separate window. # Monitors ## Monitors and Display Resolution WorkSpaces Applications supports the use of multiple monitors during streaming sessions, including monitors that have different resolutions. To help ensure an optimal streaming experience, we recommend that you set the display scale for your monitors to 100 percent if you use multiple monitors. 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 **Note** If you are connected to an WorkSpaces Applications streaming session using native application mode, you can use monitors with up to 4K resolution. If you use higher-resolution monitors, the WorkSpaces Applications client falls back to classic mode. In this case, the WorkSpaces Applications classic mode streaming view occupies 4K of the screen, and the remaining portion of the screen is black. **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. ## 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 **Across a single 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 **Across 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 Windows 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 **Across selected monitors**. 1. The **Across selected monitors** window appears, displaying your current monitor layout. Select which monitors you want DCV to be displayed full screen, and choose **Apply**. # USB Devices With certain exceptions, USB redirection is required for the WorkSpaces Applications client to support USB devices. When USB redirection is required for a device, you must share the device with WorkSpaces Applications every time you start a new streaming session. **Topics** + [ # How to Use a Smart Card During a Streaming Session ](client-application-windows-how-to-use-smart-card-during-streaming-session-user.md) + [ # How to Share a USB Device with WorkSpaces Applications ](client-application-windows-how-to-share-usb-device-user.md) # How to Use a Smart Card During a Streaming Session Depending on the authentication settings that your administrator has enabled, you might need to use a smart card for authentication during an WorkSpaces Applications streaming session. For example, if you open a browser during your streaming session and navigate to an internal organizational site that requires smart card authentication, you must enter your smart card credentials. By default, smart card redirection is enabled for WorkSpaces Applications streaming sessions, which means that you can use the smart card reader that is attached to your local computer without sharing it with WorkSpaces Applications. During your streaming session, your smart card reader and smart card are available for you to use with local applications, as well as with streaming applications. If your administrator has disabled smart card redirection, you must share your smart card reader with WorkSpaces Applications. For more information, see the next section. # How to Share a USB Device with WorkSpaces Applications If you are using a drawing tablet, USB redirection might not be required to use it with WorkSpaces Applications. However, if you are streaming an application such as the Gnu Image Manipulation Program (GIMP), which requires USB redirection to support pressure sensitivity, you must share your drawing tablet with WorkSpaces Applications. For information about drawing tablets, see [Drawing Tablets](client-application-windows-drawing-tablets-user.md). **To share a USB device with WorkSpaces Applications** 1. Use the WorkSpaces Applications client to start a streaming session. 1. In the top left area, choose the **Settings** icon, and then choose **USB Devices**. 1. If your USB device is connected to your computer, the USB device name appears in the dialog box. If your USB device is not detected, contact your WorkSpaces Applications administrator for assistance. 1. Switch the **Share** toggle key next to the name of the USB device that you want to share with the streaming session. Your USB device is now available for use with your streaming applications. **Important** USB devices can't be simultaneously used between local and remote applications. So after you share a USB device with a streaming session, you can't use it with applications on your local computer. To use your USB device on your local computer, switch the **Share** toggle key next to the name of the USB device that you want to use locally. This disables sharing with the streaming session. 1. You can also enable your USB device to automatically connect when a new streaming session starts. To do so, select the option next to the toggle key for the USB device that you want to connect. After you enable this option, when your next streaming session starts, the USB device is connected automatically. # Local File Access WorkSpaces Applications file redirection lets you access files on your local computer from your WorkSpaces Applications streaming session. To use file redirection, open the WorkSpaces Applications client, connect to a streaming session, and choose the drives and folders that you want to share. After you share a local drive or folder, you can access all files in the shared drive or folder from your streaming session. You can stop sharing local drives and folders at any time. **Important** To use WorkSpaces Applications file redirection, you must have the WorkSpaces Applications client installed on your local computer. File redirection is not available when you connect to WorkSpaces Applications by using a web browser. **To share local drives and folders** 1. Open the WorkSpaces Applications client and connect to a streaming session. 1. In your WorkSpaces Applications session, in the top left area, choose the **Settings** icon, and then choose **Local Resources**, **Local Drives and Folders**. ![\[Settings menu with Local Resources option and submenu showing Local Drives and Folders.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/AppStream2-Client-Local-Drives-Folders-MenuOptions.png) The **Share your local drives and folders** dialog box displays the drives and folders that your administrator has made available for you to share. You can share all or specific drives and folders, or just one. You can also add your own drives and folders. To share drives and folders, do one of the following: + To share all local drives and folders displayed in the **Share your local drives and folders** dialog box, choose **Share All**. To apply your changes to future streaming sessions, choose **Save my configuration**. ![\[Dialog box for sharing local drives and folders with options to share all or save configuration.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/AppStream2-Client-Local-Drives-Folders-ShareAll.png) + To share a specific local drive or folder, select the drive or folder that you want to access, and choose **Share**, **Save my configuration**. To share another local drive or folder, repeat these steps as needed. ![\[Dialog for sharing local drives and folders, with options to share specific items.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/AppStream2-Client-Local-Drives-Folders-Share-Specific.png) + If the local drive or folder that you want to share is not displayed, you can add it. For example, your administrator might make your entire local C Drive available for you to share. However, you might only need to access a specific folder on that drive. In this case, you can add the folder that you need and share only that folder. To choose a folder, do the following: + In the **Share your local drives and folders** dialog box, choose **Add Folder**. ![\[Dialog box for sharing local drives and folders, with an "Add Folder" button highlighted.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/AppStream2-Client-Local-Drives-Folders-Add-Specific-Folder.png) + Browse to the folder that you want to share, and choose **OK**. + The folder that you selected is now available to share. Select the folder, and choose **Share**, **Save my configuration**. To add another local drive or folder, repeat these steps as needed. ![\[Dialog for sharing local drives and folders, with options to share specific drives and folders.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/AppStream2-Client-Local-Drive-Folders-SpecificFolderAdded.PNG) After you share a local drive or folder, perform the following steps to access files in the shared drive or folder from your streaming session. **To access files in a shared local drive or folder** 1. Open the WorkSpaces Applications client and connect to a streaming session. 1. In your WorkSpaces Applications session, open the application that you want to use. 1. From your application interface, choose **File Open**, and browse to the file that you want to access. The following screenshot shows how shared local drives and folders appear in the Notepad\$1\$1 browse dialog box for Jane Doe when she browses for a file. ![\[File browser showing shared local drives and folders for a user, including mapped network drives.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/AppStream2-Client-Local-Drives-Folders-Access-Shared-Drives-Folders.png) In the browse dialog box, the corresponding paths for her shared drives and folders are shown in the red box. The paths appear with backslashes replaced by underscores. At the end of each path is the name of Jane's computer, ExampleCorp-123456, and a drive letter. 1. When you're done working with the file, use the **File Save** or **File Save As** command to save it to the location that you want. If you want to stop sharing a local drive or folder, perform the following steps. **To stop sharing local drives and folders** 1. Open the WorkSpaces Applications client and connect to a streaming session. 1. In your WorkSpaces Applications session, in the top left area, choose the **Settings** icon, and then choose **Local Resources**, **Local Drives and Folders**. The **Share your local drives and folders** dialog box displays the drives and folders that your administrator has made available for you to share, and any that you added, if applicable. To stop sharing one or more local drives and folders, do either of the following: + To stop sharing all shared local drives and folders, choose **Unshare All**, **Save my configuration**. ![\[Interface for sharing local drives and folders with options to unshare and save configuration.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/AppStream2-Client-Local-Drives-Folders-UnshareAll.png) + To stop sharing a specific shared local drive or folder, select the drive or folder, and choose **Unshare**, **Save my configuration**. To stop sharing another local drive or folder, repeat these steps as needed. ![\[Interface for sharing local drives and folders with options to unshare and save configuration.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/AppStream2-Client-Local-Drives-Folders-UnshareAll.png) You can delete local drives and folders that you add to the **Share your local drives and folders** dialog box. However, you can't delete local drives or folders that your administrator has made available for you to share. Also, if you have already shared a local drive or folder, you must stop sharing it before you can delete it. **To delete local drives and folders** 1. Open the WorkSpaces Applications client and connect to a streaming session. 1. In your WorkSpaces Applications session, in the top left area, choose the **Settings** icon, and then choose **Local Resources**, **Local Drives and Folders**. The **Share your local drives and folders** dialog box displays the drives and folders that your administrator has made available for you to share. If you added any drives or folders, they are also displayed. 1. Select the local drive or folder that you want to delete, and then choose **Delete**, **Save my configuration**. ![\[Dialog for sharing local drives and folders, with options to delete and save configuration.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/AppStream2-Client-Local-Drive-Folders-SpecificFolderAdded-Delete.png) # 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. In the top-right area of the WorkSpaces Applications session window, select the new notification that appears next to the notification icon. 1. In the **Notifications** dialog box, choose the **Print Jobs** tab. 1. On the **Print Jobs** tab, choose **Print**. 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. # 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 local webcam and microphone within an WorkSpaces Applications streaming session** 1. Open the WorkSpaces Applications client and connect to a streaming session. 1. In the WorkSpaces Applications toolbar in the top left of your session window, do either of the following: + If the video icon has a diagonal line through it (as shown in the following screenshot), this indicates that the WorkSpaces Applications real-time AV feature is available for use but no webcams are attached to your streaming session. Choose the video icon to attach one or more webcams. ![\[Icon of a video camera with a diagonal line through it, indicating disabled or detached webcams.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Webcam-available-1.png) + If the video icon does not have a diagonal line through it (as shown in the following screenshot), one or more webcams are already attached to your streaming session. Skip this step and proceed to the next step. ![\[Video icon without a diagonal line, indicating available WorkSpaces Applications real-time AV feature.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Webcam-attached-2.png) **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). 1. To display the names of the webcams that are attached to your streaming session, choose the downward arrow next to the video icon. 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), a check mark appears next to the name of the webcam that is selected for use for video conferencing within your streaming session. ![\[Dropdown menu showing two webcam options, with one selected as indicated by a checkmark.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Webcam1-selected-3.png) 1. To use the selected webcam for video conferencing within your WorkSpaces Applications streaming session, start the video conferencing application that you want to use. When the webcam is active (being used for video conferencing within your streaming session), the video icon is red. ![\[Toolbar with video icon highlighted in red, indicating active webcam use.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Webcam1-selected-cameras-streaming-4.png) 1. To enable the microphone, choose the microphone icon. **Note** If you have more than one webcam and want to change the one that you use for streaming within an WorkSpaces Applications session, you must first detach your webcams from the session. For more information, see the next procedure. **To change the local webcam to use within an WorkSpaces Applications streaming session** 1. Within your WorkSpaces Applications streaming session, in the WorkSpaces Applications toolbar in the top left of your session window, do either of the following: + If the video icon does not have a diagonal line through it (as shown in the following screenshot), this indicates that the WorkSpaces Applications real-time AV feature is available for use and that webcams are still attached to your streaming session. Choose the video icon to detach the webcams. ![\[Video icon without a diagonal line, indicating available WorkSpaces Applications real-time AV feature.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Webcam-attached-2.png) + If the video icon has a diagonal line through it (as shown in the following screenshot), your webcams are already detached from your streaming session. Skip this step and proceed to the next step. ![\[Icon of a video camera with a diagonal line through it, indicating disabled or detached webcams.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Webcam-available-1.png) 1. Display the names of your webcams by choosing the downward arrow next to the video icon, then select the name of the webcam that you want to use. **Note** You must select the name of the webcam you want to use. If you select the check mark next to the name of the webcam you want to use, the webcam won't change. ![\[WorkSpaces Applications toolbar with webcam options showing Webcam 1 and Webcam 2 selections.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Webcam2-selected-5.png) 1. Choose the video icon to reattach the webcams to your WorkSpaces Applications streaming session. ![\[Video icon highlighted in toolbar, with Webcam 1 and Webcam 2 options below.\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Webcam-2-selected-cameras-reattached-6.png) # Drawing Tablets Drawing tablets, also known as pen tablets, are computer input devices that let you draw with a stylus (pen). With WorkSpaces Applications, you can connect a drawing tablet, such as a Wacom drawing tablet, to your local computer and use the tablet with your streaming applications. Following are requirements and considerations for using drawing tablets with your streaming applications. + To use this feature, you must connect to WorkSpaces Applications by using the WorkSpaces Applications client, or through the Google Chrome or Mozilla Firefox browsers only. + The applications that you stream must support Windows Ink technology. For more information, see [Pen interactions and Windows Ink in Windows apps](https://docs.microsoft.com/en-us/windows/uwp/design/input/pen-and-stylus-interactions). + Depending on the streaming applications that you use, your drawing tablet might require USB redirection to function as expected. This is because some applications, such as GIMP, require USB redirection to support pressure sensitivity. If this is the case for your streaming applications, you must connect to WorkSpaces Applications by using the WorkSpaces Applications client and share the drawing tablet with your streaming session. + This feature is not supported on Chromebooks. To get started with using a drawing tablet during your application streaming sessions, connect your drawing tablet to your local computer with USB, share the device with WorkSpaces Applications if required for pressure sensitivity detection, and then start an WorkSpaces Applications streaming session. You can use the WorkSpaces Applications client or a [supported web browser](web-browser-user.md) to start a streaming session. # 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\$1F8 + Choosing **Relative Mouse Position [Ctrl\$1Shift\$1F8]** from the **Settings **menu on the WorkSpaces Applications toolbar in the top left area of your streaming session window. This method works when you use classic mode or **Desktop View**. # Logging To help with troubleshooting if an issue with the WorkSpaces Applications client occurs, you can enable diagnostic logging. The log files that are sent to WorkSpaces Applications (AWS) include detailed information about your device and connection to the AWS network. You can enable automatic log uploads so that these files are sent to WorkSpaces Applications (AWS) automatically. You can also upload log files on an as-needed basis, before or during an WorkSpaces Applications streaming session. **Automatic logging** You can enable automatic logging when you install the WorkSpaces Applications client. For information about how to enable automatic logging when you install the WorkSpaces Applications client, see step 5 in [Setup for Windows](client-application-windows-installation-user.md). **On-demand logging** If an issue occurs during an WorkSpaces Applications streaming session, you can also send log files on an as-needed basis. If an issue occurs that causes the WorkSpaces Applications client to stop responding, a notification prompts you to choose whether to send an error report and the associated log files to WorkSpaces Applications (AWS). The following procedures describe how to send log files before you sign in to an WorkSpaces Applications streaming session and during an WorkSpaces Applications streaming session. **To send log files before an WorkSpaces Applications streaming session** 1. On your local PC where the WorkSpaces Applications client is installed, in the lower left of your screen, choose the Windows search icon on the taskbar, and enter **AppStream** in the Search box. 1. In the search results, select ** Amazon AppStream** to start the WorkSpaces Applications client. 1. At the bottom of the WorkSpaces Applications sign-in page, choose the **Send Diagnostic Logs** link. 1. To continue connecting to WorkSpaces Applications, if your WorkSpaces Applications administrator has provided you with a web address (URL) to use to connect to WorkSpaces Applications for application streaming, enter the URL, and then choose **Connect**. **To send log files during an WorkSpaces Applications streaming session** 1. If you are not already connected to WorkSpaces Applications and streaming an application, use the WorkSpaces Applications client to start a streaming session. 1. In the upper right of the WorkSpaces Applications session window, choose the **Profiles** icon, and then choose **Send Diagnostic Logs**. # Troubleshooting If issues occur when you use the WorkSpaces Applications client for Windows, your WorkSpaces Applications client ID and version number can help your administrator with troubleshooting. The following sections describe how to find the client ID and client version number. ## How to find the WorkSpaces Applications client ID The WorkSpaces Applications client ID uniquely identifies your device. This ID is created when you install the WorkSpaces Applications client for Windows. To find your client ID, open the WorkSpaces Applications client. On the bottom left of the client sign-in page, choose the **Client Options** link. The client ID is displayed at the top of the **WorkSpaces Applications Client Options** dialog box. You can use your mouse to select the client ID, and then copy it to your clipboard by using your keyboard or mouse. ## How to find the WorkSpaces Applications client version number WorkSpaces Applications periodically releases new client versions to add features and functionality or resolve issues. To find the version of the WorkSpaces Applications client that you have installed, open the WorkSpaces Applications client. On the bottom of the client sign-in page, choose the **About Amazon WorkSpaces Applications** link. The client version is displayed below the Amazon WorkSpaces Applications logo. # WorkSpaces Applications Windows Client Release Notes The WorkSpaces Applications client is a native application that is designed for users who require additional functionality during their WorkSpaces Applications streaming sessions. The following table describes the latest updates that are available in released versions of the WorkSpaces Applications client. For more information about the client, see [Provide Access Through the WorkSpaces Applications Client](client-application.md). | Client version | Release date | Changes | | --- | --- | --- | | 1.2.1792 | 04-13-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.2.1778 | 03-31-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.2.1733 | 02-12-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.2.1610 | 11-14-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.2.1581 | 11-06-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1532 | 09-18-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1490 | 08-11-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1458 | 06-10-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1440 | 06-06-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1437 | 05-21-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1423 | 03-31-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1414 | 01-16-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1408 | 12-19-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1403 | 12-12-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1395 | 11-18-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1360 | 08-01-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1332 | 07-03-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1326 | 06-17-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1303 | 04-03-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1300 | 03-28-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1259 | 02-08-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1246 | 01-18-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1228 | 11-01-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1183 | 06-22-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1159 | 05-09-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1130 | 02-09-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1118 | 11-07-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1099 | 10-13-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1066 | 08-17-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.1025 | 06-29-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.421 | 05-19-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.414 | 04-26-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.398 | 02-23-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.394 | 02-08-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.386 | 12-20-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.360 | 11-15-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.333 | 09-08-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.319 | 08-16-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.304 | 08-02-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.294 | 04-26-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.285 | 03-08-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.257 | 12-28-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.195 | 08-18-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.179 | 07-08-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.160 | 04-28-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.156 | 04-22-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) Users who have this version of the WorkSpaces Applications client installed must have .NET Framework version 4.7.2 or later installed on the same PC. For a list of the .NET Framework versions available for download, see [Download .NET Framework](https://dotnet.microsoft.com/download/dotnet-framework). | | 1.1.137 | 03-08-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.136 | 03-05-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.1.129 | 02-28-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.0.525 | 12-12-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.0.511 | 10-16-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.0.499 | 09-26-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.0.480 | 08-20-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.0.467 | 07-29-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.0.407 | 05-16-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.0.375 | 03-07-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.0.320 | 01-19-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/client-release-versions.html) | | 1.0.247 | 11-20-2018 | Initial release |