Using customsettings.js

The customsettings.js file is distributed with the installation of Thinfinity® Remote Desktop Server. You will find this file in the 'webrdp' folder in the Thinfinity® Remote Desktop Server installation directory.

customsetings.js is a javascript file that contains javascript code which is read by the client's browser when they access Thinfinity® Remote Desktop Server and then communicates with Thinfinity® Remote Desktop Server to send information, like toolbar parameters. You can open it with any text editor, like notepad.

The initial values include the createToolbar and toolbarVisible parameters. Change their value to false/true following the format.

var customSettings = {
"createToolbar": true,
// Create Thinfinity® Remote Desktop Server toolbar
"toolbarVisible": false
// Thinfinity® Remote Desktop Server toolbar starts expanded (visible)
};

The double slash indicates a comment, and the text that follows is not considered code —as long as it is on the same line. You can use comments to write notes next to the parameters in customsettings.js

In these examples, the comments are being used to describe the functions and to reference the name options have in the Thinfinity® Remote Desktop Server toolbar for users.

If you want to add the toolbarRestrictions parameter, add a comma after the last parameter (in this case toolbarVisible) and include in the toolbarRestrictions list only the buttons you want to be excluded from the toolbar. Follow the following format:

var customSettings = {
 "createToolbar": true, // Create Thinfinity® Remote Desktop Server toolbar
 "toolbarVisible": false, // Thinfinity® Remote Desktop Server toolbar starts expanded (visible)
 "toolbarRestrictions": [
"actionsMenuBtn",
//"Actions"
"actionsMenuBtn.refresh",
//"Refresh"
"actionsMenuBtn.ssnShareBtn",
//"Share session"
"actionsMenuBtn.sendKeysBtn",
//"Send Keys..."
"actionsMenuBtn.sendKeysBtn.ctrlAltDelBtn",
//"Ctrl + Alt + Del"
"actionsMenuBtn.sendKeysBtn.ctrlEscBtn",
//"Ctrl + Esc"
"actionsMenuBtn.sendKeysBtn.shiftCtrlEscBtn",
//"Shift + Ctrl + Esc"
"actionsMenuBtn.sendKeysBtn.windowsExplorerBtn",
//"Shell Explorer"
"actionsMenuBtn.sendKeysBtn.runBtn",
//"Run"
"actionsMenuBtn.sendKeysBtn.altTabBtn",
//"Alt + Tab"
"actionsMenuBtn.sendKeysBtn.altShiftTabBtn",
//"Alt + Shift + Tab"
"actionsMenuBtn.sendKeysBtn.altEscBtn",
//"Alt + Esc"
"actionsMenuBtn.sendKeysBtn.leftWinBtn",
//"Left Win Key"
"actionsMenuBtn.sendKeysBtn.rightWinBtn",
//"Right Win Key"
"actionsMenuBtn.takeScreenshotBtn",
//"Take Screenshot"
"fileMenuBtn",
//"File transfer"
"fileMenuBtn.fileManBtn",
//"File Manager"
"fileMenuBtn.uploadBtn",
//"Upload"
"fileMenuBtn.downloadBtn",
//"Download"
"optionsMenuBtn",
//"Options"
"optionsMenuBtn.scaleBtn",
//"Scale"
"optionsMenuBtn.imgQualityBtn",
//"Image Quality"
"optionsMenuBtn.imgQualityBtn.imgQHighestBtn",
//"Highest"
"optionsMenuBtn.imgQualityBtn.imgQOptimumBtn",
//"Optimum"
"optionsMenuBtn.imgQualityBtn.imgQGoodBtn",
//"Good"
"optionsMenuBtn.imgQualityBtn.imgQFastestBtn",
//"Fastest"
"optionsMenuBtn.keyboardMode",
//"Disable Shortcuts"
"optionsMenuBtn.fullScreen",
//"Full Screen"
"disconnectBtn",
//"Disconnect"
 ]
};

When you are done, close the file and save the settings. Don't change the file's location. The changes will be taken by Thinfinity® Remote Desktop Server immediately. Remember that settings in customsettings.js file will override those in the connect method.

The toolbar customization is not the only thing you can do with customsettings.js. Read more about all the parameters you can include in Custom Settings.