Customisation
In this article, you will learn how to customise the ISL Online remote desktop software to match your corporate identity by using your logo, using your company colours and personalising the workflow of a default remote desktop session. Here, we'll provide helpful resources to guide you to create the perfect customisation.
We'll divide the customisation options into two parts:
Logo and Colours
You can fully customise the graphical user interface by using your company's logo, key images and colours. You can also customise some text within the application, including the window title and executable name.
Software Behaviour
It is possible to automate certain tasks and minimise the number of mouse clicks for repetitive actions. Do you want to automatically start viewing your client's desktop when a session is established? Does your security policy require you to record every session? You can change the default behaviour of ISL Light with command line arguments.
Let's personalise your ISL Online Remote Desktop software!
Logo and Colours
ISL Light
Server License Users:The process for server licenses is different from the process for hosted service users. Please refer to the Customisation Manual.
First add your logo, icon and key visual and use your base colour. To do so, send an email to support@islonline.com with the following images:
Logo (recommended max height 32px)
Icon (96x96px)
Keyvisual (320x320px)
Colours (branding.ini)
[Colors]
success=#BAD632 // Primary button Colour and Online Computers Icon
action_button_text=#333333 // Button text
notify_notification_background=#FFEC7F // Notification backgound
notification_text=#6C6C6C // Notification text colour
url_link=#0066CB // Link colour & active placeholder border colour
focus=#0066CB // Focus border colour
ISL Light Client
Server License Users: The process for server licenses is different from the process for hosted service users. Please refer to the Customisation Manual.
In order to add a company logo, please perform the following procedure:
Prepare a file with your company logo - it should be in BMP format, 24-bit color depth, with image width up to 350 pixels and image height up to 80 pixels (350 x 80 is optimal and will not be scaled).
Send an e-mail to support@islonline.com with the following format:
subject: Hosted service - add logo <your company name>
body: Please add our company logo (attached) to our account <your ISL Online account e-mail>.
attachment: <your company logo in the above mentioned format>
Once we've received the request, we will create a new customisation for you and reply to your e-mail as soon as possible with instructions on how to use it.
Read manualLocal Customisation Test
You can test the customisation and change logo, visuals and colours for ISL Light locally. To make a local customisation, follow the steps below.
1. Once you have installed ISL Light, open the branding folder in the installation directory.
WINDOWS
C:\Program Files (x86)\ISL Online\ISL Light\qml\branding
MAC
Applications/Contents/Resources/qml/branding
LINUX
Applications/Contents/Resources/qml/branding
2. Open the images in the branding folder and change them. Keep the file names as in the original.
Logo (recommended max height 32px)
Icon (96x96px)
Keyvisual (320x320px)
3. Open branding.ini in a text editor and change the colours to your liking.
Colours (branding.ini)
[Colors]
success=#BAD632 // Primary button Colour and Online Computers Icon
action_button_text=#333333 // Button text
notify_notification_background=#FFEC7F // Notification backgound
notification_text=#6C6C6C // Notification text colour
url_link=#0066CB // Link colour & active placeholder border colour
focus=#0066CB // Focus border colour
4. Restart ISL Light and preview your customisation.
5. To add a customisation to your account, email support@islonline.com and attach the files. We will create a new customisation for you and respond to your email as soon as possible.
Simple Command Line Arguments
You can change the behaviour of the ISL Light application using command line arguments. For example, you can force colour quality, hide the client streaming bar, specify what happens if ISL Light loses connection to a remote computer, and more.
Let us begin with a simple example:
ISLLight.exe --on-connect "desktop?color=64k"
Save the ISL Light executable to a certain directory on your disk, open the Command Prompt (cmd) and type in the above line. This option will switch streaming to quality optimized mode and not speed optimized by default.
Please refer to the Command Line Arguments manual for a detailed description of simple command line arguments.
Command Line Methods
Server license:
There is another way of using command line arguments - as a part of a customization. Please refer to Command Line Arguments manual.
There are three ways to use command line arguments.
Command Prompt method
Run Command Prompt (Windows) or Terminal (Mac, Linux) and navigate to the directory where you installed ISL Light.
1. Download ISL Light to a directory on your hard drive (we will use c:\isltmp for this example).
2. Click Start - Run.
3. Enter either cmd (Windows 2000 or newer) or command (Windows Me or older) and press enter.
4. Navigate to the directory where you saved ISL Light Desk or ISL Light Client executable:
cd C:\isltmp
5. Start ISL Light with the desired command line arguments, e.g.:
ISLLight.exe --on-load "customization?disable_sessions=true"
Windows Shortcut method
1. Download ISL Light to a directory on your hard drive (we will use c:\isltmp for this example).
2. Right-click on your desktop, select New and then Shortcut.
3. Select the location of the executable file ISL Light - for the example above it is c:\isltmp\ISLLight.exe
4. Click Next.
5. You can change the name of the shortcut if you wish and then press Finish.
6. Edit shortcut properties - right-click on the shortcut you created and select Properties.
7. Append the desired command line arguments in the Target field and click OK.
8. You can run the program by double-clicking the shortcut.
Example of how the Target field in Properties for ISL Light shortcut should look like:
"C:\isltmp\ISLLight.exe" --username \\isl\tim --password demo
URL method
The usual way to start ISL Light is to use the following link:
To add command line arguments, append ?cmdline= to the link and then specify the desired arguments. These arguments must be URL encoded. Please refer to the our URL encoding page.
Step-by-step example:
1. Let us say we want to use the following command line arguments for ISL Light:
--get-code --username demo --password demo --on-load "customization?disable_computers=true"
2. Copy and paste the command line arguments into our URL encoding page and click URL Encode. Copy and paste the result (URL-encoded text):
--get-code+--username+demo+--password+demo+--on-load+%22customization%3Fdisable_computers%3Dtrue%22
3. Append the URL-encoded text to the original link along with the ?cmdline= parameter and you have created a working link:
Cloud license:
Server license:
If you are using a special link to launch ISL Light, such as https://www.islonline.net/start/ISLLight?platform=win32, the procedure is slightly different. This link already contains parameters that start after the ? character. In this case, you must write &cmdline= instead of ?cmdline= and then continue with the URL-encoded command line arguments, as in this example:
Cloud license:
Server license:
Advanced Command Line Arguments
Each command line option refers to a specific event in the ISL Light program. ISL Light supports the following events:
load (triggered when ISL Light is loaded into memory and started)
join (triggered when ISL Light requests and obtains a session code, i.e. joined a session)
connect (triggered when a connection is established between ISL Light and ISL Light Client)
disconnect (triggered when a session is finished)
You can associate certain actions with certain events - the syntax of the complex command line arguments is:
--on-<event> <action>
Please refer to the Advanced Command Line Arguments manual for a detailed description.
ConnectBox
You can add a ConnectBox to your site and ask the client to join a session through your website. ConnectBox is a simple form where the client can enter the session code and click Connect. The client then downloads the latest version of the ISL Light software. After the client runs the programme, the connection is automatically established.
Read manual
Branded Access Point
If you want to give your customers a very simple and unique way to start an ISL Light session, create a simple web page customised to your look and feel. Add your logo, choose a colour, and include the links your customers might find useful.
Here is an example of a simple branded access point with your logo.
API and Integrations
WebAPI2 allows you to integrate ISL Online into your third-party services, or create your own scripts and work with data related to your ISL Online usage.
Read manual