Amazon AppStream
Developer Guide

This documentation is for an older version of Amazon AppStream. For information about the latest version, see the Amazon AppStream 2.0 Developer Guide.

Chrome App

The Amazon AppStream Example Client for Chrome is an app that you add to the Chrome browser that can connect to a streaming application.

This section contains the following procedures:

Installing the Chrome App – shows how to add the Chrome App to the Chrome browser.

Streaming an application through an entitlement service – use this method if you have the entitlement service URL, the application ID of the streaming application, and a user name that can connect to the streaming application.

Streaming an application from the Amazon AppStream console – use this method to test your streaming application by using a link in the application summary page.

Stream an application in standalone mode – use this method for a streaming application in standalone mode.

Changing the settings of the app – change the settings to show the mouse pointer in the Chrome app, the streaming application or both, show verbose debugging information to help you solve a problem, and change the inactivity time.

To install the Chrome App

  1. In a Chrome browser, go to

  2. Click FREE and then click LAUNCH APP.

To stream an application through an entitlement service

  1. Start the Chrome App and choose Connect via Entitlement Service. Type the entitlement service URL or IP address, application ID, and user ID in the appropriate text boxes.

  2. Click Connect.

To stream an application from the Amazon AppStream console

  1. Sign in to the AWS Management Console and open the Amazon AppStream console at

  2. In the Amazon AppStream console, click View your streaming applications. This button appears only if you have added applications to Amazon AppStream.

  3. In the list of applications, click the name of the streaming application to view.

    The application summary page displays information about the streaming application.

  4. In Show instructions for testing your application using, select Chrome.

  5. Click the link in step 2 to start the Chrome app and connect to your streaming application. The URL is valid for 72 hours and can only be used once. You can share this URL within the 72 hour period, but only one user can use this URL.

    If you have already used this link, you can generate a new test connect link. For more information, see Generating a New Test Connect Link to Stream Your Application.

To stream an application in standalone mode

  1. Start the Chrome App and choose Connect via Test Mode. In Test Mode URL or IP address, type the IP address of your EC2 instance.

  2. Click Connect.

To change the settings of the Chrome App

  1. Start the Chrome App and choose Settings.

  2. In Settings, do the following:

    • In Mouse cursor, choose Local to display the mouse pointer of the Chrome App. Choose Remote only to display the mouse pointer of the streaming application. Choose Local and Remote to display the mouse pointers in both the client and streaming applications.

    • Select Show debugging information to display the Chrome developer console with verbose log information to help you find the cause of a problem. To display the Chrome developer console with the verbose log information, select this check box and then click OK to close the dialog box. In the client application, right-click the text box and select Inspect Element. If you are using a Chromebook, point to the text box and then click the touchpad with two fingers or press the Alt key while clicking with one finger and then select Inspect Element.

    • Choose Inactivity timeout and select a time after inactivity when the client application will disconnect from the streaming application. You are still incurring charges if a client application is connected to a streaming application but the client application is not sending any user inputs. You can reduce your cost by choosing an appropriate inactivity time.

    • Choose Clear in Clear all stored settings to remove the stored preferences. Restart the Chrome App to see the effect.

  3. Click OK to save the settings.