Customize the Thinfinity Remote Desktop Toolbar

Thinfinity Remote Desktop Toolbar customizationIn a previous post we discussed how to apply general custom settings to Thinfinity Remote Desktop Server. Today, we will learn how to customize the remote desktop toolbar in depth.
By default, the toolbar displays the wider range of options within reach for the end users. But, as an administrator or integrator, you might want to restrict the end user from accessing some of these options, or all of them. Thinfinity Remote Desktop has a method for applying settings to the toolbar so you can tweak it according to your preferences. These settings will be applied before the connection occurs and will affect all users and all connections in the Thinfinity Remote Desktop server installation.

General remote desktop toolbar customization parameters

The customSettings global variable has two parameters that affect the complete toolbar:
The createToolbar parameter enables the Thinfinity Remote Desktop Toolbar creation. Setting it to false will result in a Thinfinity® Remote Desktop Server connection with no toolbar at all. This might be useful if you want to restrict the user from all the options in the toolbar.
The toolbarVisible parameter defines the initial toolbar visibility. When toolbarVisible is true, the toolbar will appear expanded upon establishing the connection; and when toolbarVisible is false, the toolbar will start collapsed.

Hiding toolbar components

But this is not a black and white world. Maybe you want to hide only some of the toolbar options. For example, when connecting to an application you might want to restrict the user to access the task manager by sending the [CTRL]+[SHIFT]+[ESC] keys. Or, perhaps, you might want to enable file transfer for downloading files without providing access to the file manager.
For all of these cases, you have a way to programmatically define the exact toolbar options that will be excluded.
The toolbarRestrictions customSettings property is an array that contains the full name of all the toolbar options you might want to restrict.
The table below shows the complete option name list:

Option Full Name Related button/action
actionsMenuBtn “Actions” menu button
actionsMenuBtn.refresh “Refresh” option of “Action” menu
actionsMenuBtn.ssnShareBtn “Share Session” option of “Action” menu
actionsMenuBtn.sendKeysBtn “Send Keys…” submenu option of “Action” menu
actionsMenuBtn.sendKeysBtn.ctrlAltDelBtn “Ctrl + Alt + Del” option of “Send Keys…” submenu
actionsMenuBtn.sendKeysBtn.ctrlEscBtn “Ctrl + Esc” option of “Send Keys…” submenu
actionsMenuBtn.sendKeysBtn.shiftCtrlEscBtn “Shift + Ctrl + Esc” option of “Send Keys…” submenu
actionsMenuBtn.sendKeysBtn.windowsExplorerBtn “Shell Explore” option of “Send Keys…” submenu
ctionsMenuBtn.sendKeysBtn.runBtn “Run” option of “Send Keys…” submenu
actionsMenuBtn.sendKeysBtn.altTabBtn “Alt + Tab” option of “Send Keys…” submenu
actionsMenuBtn.sendKeysBtn.altShiftTabBtn “Alt + Shift + Tab” option of “Send Keys…” submenu
actionsMenuBtn.sendKeysBtn.altEscBtn “Alt + Esc” option of “Send Keys…” submenu
actionsMenuBtn.sendKeysBtn.leftWinBtn “Left Win Key” option of “Send Keys…” submenu
actionsMenuBtn.sendKeysBtn.rightWinBtn “Left Win Key” option of “Send Keys…” submenu
actionsMenuBtn.takeScreenshotBtn “Take Screenshot.” option of “Action” menu
fileMenuBtn “File transfer” menu button
fileMenuBtn.fileManBtn “File Manager” option of “File Transfer” menu
fileMenuBtn.uploadBtn “Upload” option of “File Transfer” menu
fileMenuBtn.downloadBtn “Download” option of “File Transfer” menu
optionsMenuBtn “Options” menu button
optionsMenuBtn.scaleBtn “Scale” option of “Options” menu
optionsMenuBtn.imgQualityBtn “Image Quality” submenu option of “Options” menu
optionsMenuBtn.imgQualityBtn.imgQHighestBtn “Highest” option of “Image Quality” submenu
optionsMenuBtn.imgQualityBtn.imgQOptimumBtn “Optimum” option of “Image Quality” submenu
optionsMenuBtn.imgQualityBtn.imgQGoodBtn “Good” option of “Image Quality” submenu
optionsMenuBtn.imgQualityBtn.imgQFastestBtn “Fastest” option of “Image Quality” submenu
optionsMenuBtn.keyboardMode “Disable Shortcuts” option of “Options” menu
optionsMenuBtn.fullScreen “Full Screen” option of “Options” menu
disconnectBtn “Disconnect” menu button

The following example shows how to create the toolbar so that it starts collapsed and without the “File Manager” menu button, the “Image Quality” submenu, the “Share Session” option or the “[Ctrl]+[ALT]+[DEL]” keystroke option:

var customSettings = {
      "createToolbar": true,
      "toolbarVisible": false,
      "toolbarRestrictions": [

So far we’ve shown you a centralized way to restrict the remote desktop toolbar options for all connections and profiles. But what about a dynamic way to apply the toolbar settings?
A dynamic tweaking of the toolbar is also possible. By using the Thinfinity Remote Desktop Javascript API, you can restrict the toolbar options depending on the user that is accessing.
We will learn how to do this in an upcoming post.

Leave a comment

Privacy Preferences
This website uses cookies to improve your experience while you navigate through the website. Out of these, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may affect your browsing experience.