Session Features

So far, you’ve learned about the minimum requirements for Frame in our Getting Started Guide and the basic functions of your Frame account/session in our Navigating your Frame Account Guide. Now it’s time to move on to the final guide all about session features. This guide will provide you with detailed information about different session features that may or may not be enabled for your account by your administrator. While most end users access their Frame account from a browser, we have also included additional information for those accessing Frame from Frame App.

Note

This guide is intended to explain optional features which may or may not be enabled for your Frame account.

Use the links below to jump to different sections of this guide, if needed.

Supported Peripheral Devices

Frame supports using many common peripheral devices, including the verified devices listed below. The Google Chrome browser is the preferred client browser for all integrations. Most of the same functionality is available on other modern browsers like Mozilla FireFox and Microsoft Edge. If a desired device is not listed, please reach out to Nutanix Support. Frame remoting technology provides unique integrations for distinct devices based on use case. Check out our End User System Requirements documentation to read more about supported browsers on Frame.

Supported Peripheral Devices

Device Type

Windows PC (HTML5)

Mac (HTML5)

iOS/Android (HTML5)

Linux (HTML5)

Storage Device (PenDrive, USB Hard Disk)

-

Audio Out (Speakers, headsets)

Audio In (Microphone)

-

Standard Generic Keyboard

N/A

Symbol HID Barcode Scanner

N/A

Mouse

N/A

Multi-touch Screen

N/A

-

Microsoft Surface Pen

N/A

N/A

N/A

Printer

N/A

Yubikey

N/A

CAC/Smart Card Readers (requires Frame App) *

-

-

-

WIA Printers (requires Frame App) *

-

-

-

Wacom Intuos Pen Touch Device (Chrome only) **

N/A

-

* = Files in USB storage devices on the local endpoint must be manually uploaded into the Frame session following the workflow described in Upload section of Open and Edit Files.

** = Early Access Feature

Input Options

This section covers the available input options for a Frame session which includes keyboard layout switching and changing the “mouse mode” for your environment.

Keyboard Layout

If your administrator has enabled multiple keyboard input languages for your environment, switching between languages is very simple. If your Frame environment includes the Windows taskbar, you can use the native Windows language bar.

../_images/eu_keyboard1.png

Click on the language icon in the bottom right corner of your window.

Your Frame environment may not include the Windows taskbar, in which case you will want to use the language icon located on the far right side of your Frame status bar.

../_images/eu_keyboard2.png

Select your desired language from the list that appears.

Mouse Modes

While our standard mouse configuration works for most use cases, there are some scenarios where changing the mouse mode could be helpful. We’ll outline different mouse modes and their corresponding use cases below.

To change the mouse mode in your session, simply click the cursor icon in the bottom right corner of your Frame status bar.

../_images/eu_mmodes1.png

A new dialog box will appear, select the mouse mode you wish you use.

../_images/eu_mmodes2.png

Standard

By default, a Frame session uses Standard mouse mode. In this mode, you can expect the same functionality and appearance you’d expect when using a regular PC. This mode is meant for normal use with most applications.

Standard mode with a touch-enabled device (such as an iPad) allows you to navigate the session using touch alone. For instance, you can move open windows in your session by holding your finger down on the title bar of the window and dragging it.

Touchpad

Touchpad mode was created to provide extra precision when accessing a Frame session on touch-enabled devices. With Touchpad mode, you’ll see a special gray cursor that you can move by pressing anywhere on the screen and dragging.

../_images/eu_mmodes3.png

To left-click, tap once anywhere on the screen with the cursor placed in the area you’d like to click. To right-click, tap with two fingers anywhere on the screen. The cursor will show which button-click you’re performing. For instance, a left-click in Touchpad mode looks like this:

../_images/touchpad2.png

Relative

Relative mouse mode is intended for gaming and 3D world navigation. You’ll want to first launch the application you’re going to use, and then switch to relative mouse mode when you need to navigate a 3D environment. Once enabled, your cursor will disappear and you will be able to navigate your app like you would with any first-person point-of-view game.

To exit relative mouse mode, simply hit ESC on your keyboard.

Audio Options

Audio Output

If you would like the audio from your Frame session to play through your local environment (speakers, headphones, etc.) you need simply to click on the speaker symbol in the bottom right corner of your Frame status bar.

../_images/eu_speaker1.png

You can toggle audio output any time from your session by clicking on this icon.

Audio Input

If you are using an application which requires audio input from your microphone, you can enable microphone input in your session by clicking on the microphone icon on the bottom right corner of your Frame status bar.

../_images/eu_mic1.png

The first time you enable this feature, your browser request you enable the microphone permission for console.nutanix.com:

../_images/eu_mic2.png

Display Options

Multiple Monitors

Multi-display configurations are useful for a variety of end user workflows. Frame’s multi-monitor feature allows users to connect up to 4 displays at a time. End users may configure the display order as desired while in the session. This feature is built into Frame App and easily enabled for the browser-based Frame Terminal.

Using Multi-monitor

Configuring multiple displays from your Frame session is straightforward and simple. Start by clicking on the Gear menu in the bottom left corner of your screen. Select “Manage displays.”

../_images/mm_3.png

A new window will appear showing the display you’re currently using. Click the “Add” button to add a display.

../_images/mm_4.png

A separate, untitled browser window will appear with the option to “Start Streaming.” First, drag the window to the display you would like to use and fully expand it. Click “Start Streaming.”

../_images/mm_5.png

Once you have added the total number of displays you would like to use, you can configure the position of the displays using the “Manage displays” option from the Gear menu you selected earlier. Click on the desired display and drag it to the correct position.

../_images/mm_6.png

Simply click on a display from the “Manage displays” window to verify your display order. The display you click on will be highlighted with a red outline in the browser window.

../_images/mm_7.png

To disconnect any additional displays, simply close their browser windows. Any applications will automatically be moved back to the main display.

Note

If you are accessing your Frame account from Frame App, you will automatically be prompted to connect and configure your displays if multiple displays are detected.

Multi-monitor Limitations

Since the Frame platform is accessed via web browser, the following browser-based limitations should be considered. These limitations do not apply to Frame App users.

  • While multiple monitors can be configured as desired horizontally, browser limitations prevent vertical implementations (monitors stacked on top of each other).

  • To move objects such as application windows between displays, the user will need to drag and drop the object to make it partially visible on the next display and then drag from the partially visible portion to the desired display.

  • The end user must resize the new browser window once it appears in order for the display to fill the entirety of the browser window.

  • The end user must click “Start Streaming” when they are ready to use their additional display.

Storage Options

There are many ways you can save and access files while in a Frame session. Depending on the options chosen by your account administrator, you may have more than one. Below we’ll discuss your storage resources and how you can use them.

Cloud Provider Storage

Connecting to Cloud Storage

Perhaps the most popular option, cloud storage provider accounts such as Dropbox, Google Drive, Microsoft OneDrive, and Box integrations are built right in to your Frame session. Once you start a session, each cloud service that you have connected will be mounted and become visible from inside your apps as a new network drive. There are two methods to connect to cloud storage from your Xi Frame account. We will outline the steps below.

Once you have connected your Frame account to Dropbox or Google Drive, it will automatically reconnect anytime you sign in, unless you deliberately disconnect before logging out. With Box, you must sign in on each session due to Box’s security access model.

There are a few ways you can connect your cloud storage provider to your Frame account. The simplest way would be to connect through your user profile page.

You can also connect your cloud storage provider (if enabled by your administrator) from within your Frame session:

  1. First, click on the grayed-out cloud storage provider icon in the Frame status bar. A dialog will appear – click “Connect.”

../_images/clouddrive6.png
  1. A new window will appear prompting you for your cloud storage credentials. Enter your credentials and follow the prompts.

../_images/clouddrive7.png
  1. The icon in the Frame status bar will blink while connecting. It will remain solid once connected.

You can disconnect from within the session at any time by clicking on the cloud storage icon and then clicking the blue “Disconnect [Cloud Storage Provider]” link in the dialog that appears.

../_images/clouddrive7a.png

When disconnecting, you will be asked to confirm your choice.

../_images/clouddrive8.png

Accessing Cloud Storage

Once you have successfully connect to cloud storage using one of the methods listed above, you can access it as you would any other drive.

Simply navigate with your file explorer or use a file browser within an application. Your cloud storage drive will look like a regular drive and have its own assigned drive letter. For example, Google Drive has been assigned the G: drive letter.

../_images/clouddrive4.png

Personal Drives

A Personal Drive is a storage drive that persists your data between sessions and can be managed from your user profile page. If enabled by your administrator, your drive will have a fixed storage capacity which can be increased by your administrator at any time.

Access your Personal Drive

Your Personal Drive is tied to your Frame account and can be used from the session just like a regular storage drive on your local computer. Simply navigate to your file explorer in your Frame session and look for the “PersonalDisk (P:)” drive.

../_images/eu_pdrive1.png

The storage capacity of your Personal Drive is set by your administrator. To check the storage capacity, right click on the drive and select “Properties.” The value will be listed next to “Free space.” The data on your Personal Drive is only accessible to you, and can only be accessed through your Frame account.

Managing Personal Drive Backups

As an end user, you are automatically granted the permissions to manage your own Personal Drive backups. You can do this from your profile page.

Network Share Drives

Access Network Share Drives

As the title of this section suggests, a network share drive is a shared volume which can be accessed by multiple Frame account end users. This drive is configured and managed by the administrator of the account. It appears simply as an additional volume in your file explorer and can be accessed just like any other drive (from your file explorer or while browsing files in an application).

Accessing Files

There are a few ways you can access your files from your Frame session. Some end users may simply use the upload/download feature which allows them to upload files into the session and download files from the session to their local environment. Files can also be accessed from storage resources such as cloud storage, Personal Drives, or network share drives. We’ll outline how to access your files from your Frame session in this section.

Upload/Download

With most browsers you can simply drag and drop a file from your local desktop onto your Frame session’s browser window to initiate an upload. Alternatively, you can click on the file upload icon and the following pop-up will explain what to do next:

../_images/uploadfile.png
  • Click on the icon to bring up your local computer’s file browser (such as Finder on Mac). After you select a file, it will be uploaded to the “Uploads” folder within your Frame session. The indicator on the right side of the status bar will display the progress of the upload:

../_images/statusbarindicator.png
  • Once the file has been uploaded, you can access it directly in your application by using the app’s file manager or navigating to the “Uploads” folder in the Favorites section.

  • If needed, you can cancel the file upload by clicking on the progress indicator. A small dialog will appear with the option to “cancel” or “cancel all.”

../_images/cancelindicator.png
  • If you would like to download a file to your local machine, move the file to the “Download Now” folder under your “Links” directory. The file will automatically start downloading to your local browser’s download location.

../_images/download.png
  • You can drag any files from your local Frame session to the “Download Now” folder to download it to your local machine. Your browser window will show the file being downloaded to your local computer automatically.

Limitations

As it is, drag and drop works across all Frame-supported browsers; however, there can be limitations if you want to move folders as well as files. Chrome and Opera Browsers have full drag-and-drop support for both files and folders; however, Frame recommends zipping folders before uploading to preserve file structure. Firefox, Safari, Edge, and IE 11 Browsers support file uploads, but certain limitations in the browsers mean we can’t provide support for folder uploads. If you attempt to upload files and folders together in Firefox, Safari, or Edge, the files will be uploaded successfully, but not the folder content. If you attempt this with IE 11, the entire upload will fail.

Cloud Storage/Network Share Drives

As mentioned in the section above, cloud storage drives, network share drives, and Personal Drives all appears as mounted drives in your Frame session. Accessing your files from a mounted drive is simple. Start by opening your file explorer, then navigate to the desired drive. You may also access this drive from within an application.

../_images/clouddrive4.png

Limitations

Since there are a few variations of the Google Drive integration, you may or may not have to enter your account credentials every time you log on to your session (depending on your account configuration).

Clipboard Integrations

Frame makes it easy to move text data between your local environment and your Frame session. Clipboard functionality can vary depending on the type of browser you are using to access your Frame account. We’ll outline the different types of clipboard integrations below.

Using the Clipboard Interface

First, click on the clipboard icon located on the right side of your Frame status bar.

../_images/textclipboard1.png

The clipboard dialog box will appear. Any text data you have copied (either using a keyboard shortcut or using the context menu) from the session will appear in the text box on the right when you open up this dialog. Copy the text from the box on the right to be able to paste it into your local machine.

../_images/textclipboard2.png

As you may already know, you can also copy text from your local computer to your Frame session using the opposite method. Once you have copied your desired text from your local machine, go back to your session and click on the clipboard icon. Paste the text into the box on the left. The dialog will display a “Pasted!” message if the text was pasted successfully.

Clipboard Sync

Clipboard sync ties your local copy/paste shortcuts to your Frame session. For instance, if you highlight text from your local PC (outside of the Frame session) you can simply use keyboard shortcuts to copy it locally and paste the information directly into the Frame session. No need to open a special dialog box.

Note

The “Clipboard Integration” feature, when enabled, defaults to the clipboard sync function in Chrome. This feature is not yet supported on other browsers. The first time you use clipboard sync, your local Chrome browser will request permission to “see text and images copied to the clipboard.” Once permission is given, Chrome will not prompt you again.

../_images/allowclipboard.png

You can enable/disable clipboard sync in your session by clicking on the icon in the lower right corner.

../_images/clipboardsync1.png

Limitations

  • Depending on your account configuration, some administrators may only allow you to copy/paste in one direction. For example, an administrator may only allow their end users to paste from local to remote, but not from remote to their local environment.

  • In order to use Ctrl + C and Ctrl + V to copy files within your Frame session you must have clipboard sync disabled. You can still copy/paste files by right-clicking and selecting the desired action from the context menu.

  • Due to browser limitations, clipboard sync only transfers plain text between your local environment and your Frame session. Any text formatting will be stripped between environments.

Printing from your Session

Frame addresses printing through an innovative virtual printer approach. If enabled by your administrator, your Frame instances will have a special virtual printer driver pre-installed. To print your document, simply go to your application’s print option (typically File>Print) and select the “Frame” printer option as shown below:

../_images/eu_print1.png

When you click “Print,” the virtual printer will automatically create a .PDF file and prepare to push it to your local browser. A printer icon and notification will appear at the bottom of your screen:

../_images/eu_print2.png

Once the file has been prepared within your session, your local browser will either display a local print console or ask if you would like to save the file as a PDF. Send the file to the desired local/network printer or print from your local PDF viewer/browser.