Customizing the HP Smart Client

There is a great blog post from Ingmar Verheij explaining the new HP Smart Client software which is part of the new HP flexible Thin Client series (T410,T510,T610). Please read his blog to get a better understanding about the HP Smart Client software.

In this blog I will show you how you can customize the appearance of the Smart Client, I will give an example how to change the login page when connecting to a Citrix back-end, but you can also use this information when customizing the Smart Client for other protocol connections.

Ok lets start from scratch :
When you configure the Smart Client for use with XenApp\XenDesktop you will get the following logon screen :

(Screenshot is taken with a camera)

As you can see HP made a default page that looks very similar to the Citrix Web Interface 5.4 layout. In the Smart Client admin guide, there is a chapter about customizing the layout but I found it very unclear. So my goal was to get the existing files from the Smart Client to get an example of how this login page is constructed. Because every door on the Smart Client is locked, in terms of remote file management, there is no easy way to get to the files on the Smart Client.

To fetch the files I used the drive mapping feature of the Citrix Receiver for Linux, the default location of the drive redirection is \media, this is the mount point in Linux for USB sticks and other storage devices. By default this folder is mapped as drive leter Z: in the session. In the profile editor enable drive mapping and change the drivePathMappedOnZ value to /etc, see the below screenshot  :

After rebooting the Smart Client, logon to a XenApp\XenDesktop session and open the drive letter Z: You will now see the content of the ETC folder from the Smart Client, browse to the following folder hptc-zero-login\styles there you will find all the default styles from the different connection protocols, see screenshot :

In this case we will open the xen folder, because we want to edit the Citrix login page styles. Copy the folder from the Smart Client to a different location so we can start editing them, in the folder you will find this 2 files :


This file consists of the layout setting of the login screen, it’s very easy to edit this file and make customization to it, so I will not cover all the options but instead give an example :

Change the background color to white :

global {
color: FFFFFF; # White
padding: 20; # 20 pixels

Change the default footer text :

text {
name: ad line;
text: Welcome to, type in your cup size and password to continue;
position: %50%,85%;
alignment: hcenter vcenter;
color: 000000;
font-size: 16pt;
max-width: 98%;
context: login;

Change the logo :

image {
name: computers image;
source: /usr/share/icons/hptc-zero-login/mypicture.png;
position: 50%,50%;
alignment: hcenter vcenter;
context: login;

As you can see the image source directory is on the USR directory, if you want to retrieve them simply change the ETC drive redirect folder from the previous step to USR and browse to the /usr/share/icons/hptc-zero-login folder.


In this file you can edit the dialog text, in this example I will change it to Dutch :

LoginArea QLabel#loginHeader {
qproperty-text: Welkom;
color: white;
font-size: 20pt;
text-align: left;
LoginArea QLabel#userLabel {
qproperty-text: Gebruikersnaam;
color: white;
font-size: 12pt;
LoginArea QLabel#passwdLabel {
qproperty-text: Wachtwoord;
color: white;
font-size: 12pt;
LoginArea QLabel#domainLabel {
qproperty-text: Domein;
color: white;
font-size: 12pt;

Ok now we want to deploy this custom files to all the Smart Clients out there, to do this open the Profile editor and go to the additional Configuration Files section, add the files like this :

Now reboot the Smart Client and voila  :

Conclusion :
In this blog post I explained how you can customize the appearance of the HP Smart Client. You can also use this Drive Redirect option to view other files on the Smart Client such as the ICA client files. In this way you can deploy custom settings to the Smart Client by editing the files and deploy them through the Smart client Profile editor. This is useful when you cannot find the setting in the registry options in the Profile editor.

* Note you can also redirect the style directory so you can place them in a different folder, in this case I used the default locations, but the style directory can be set to a custom location with this option :

Follow me on twitter (@bramwolfs) if you want to be notified when a new blog post is available!

Please note that the information in this blog is provided as is without warranty of any kind.

29 thoughts on “Customizing the HP Smart Client

  1. Great post I wish HP would have better documentation for the smart clients. I tested it on a T610 Plus and when i make a simple change like changing the wording at the bottom it sets the back ground to a grey color with the logon box.

  2. This was very helpful however, we have now run into a problem with the 510 TC where it is copying the new bgconfig file over but it is not reading it. It wirked great the first few times but then we needed to reinstall profile editor and it has not worked since. We have also tried redirecting the file to a new folder. It created the new folder iwth the .rtf file in there and the redirect per your instructions looks accurate but it is still loading the default bgconfig.rtf.

  3. Is there any instructions for RDP? I can’t seem to find access to /etc since there is no drivePathMappedOnZ setting for freerdp.

  4. Very nice write up! We have T410 AIO and I am trying to configure the Citrix Receiver look and have been running into some trouble. Do you have some example .qss files and .rtf files that i could reference and compare what I have been working with.

  5. Bram, I’m sorry for my bad english 🙂 I ask you to help me with rdp for HP t 410, if you have the templates, then I beg you to send them to me! very grateful!

  6. Hi Bram,

    I wanted to add an Mozilla Firefox extension to the default browser within a T610, we can do it manually but then it dissapears after restart (the add on file remains, it’s just the browser profile that gets wiped ) we have tried in root user admin mode! I need the add on to be installed read only permanatly into the deafault image that runs in kiosk mode for all users 🙂

    • Hi Andy,

      That’s a good one, maybe it’s possible to load the browser profile and extensions during boot time through the smart client service, then you need to export the browser profile and inject the files in the smart client profile.


    • I think you installed Thinpro, you should download the Smartclient image from the HP site and install it to the Thinclient then you will have the locked down version with the buttons on the homescreen.


  7. Hi,
    Thank you, it’s very informative. I have a question: where (path) can I find the elements to modify the login dialog box? I want to remove the “Remember me” option.

    Once again thank you for the information.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s