1. Home
  2. StayLinked Clients
  3. Client Guide – Color Re-Mapping Support

Client Guide – Color Re-Mapping Support

In cases where color support is required, but the end application can not be modified to replace one color with another, StayLinked can provide a solution. When a file is place on the device with a name of colors.ini, the client software will read the file and display adjusted color codes with your desired colors.

The text color re-mapping should begin with a header line of [foreground], followed by each color you wish to adjust.. In addition to the text color, reverse video can be adjusted to your needs. The reverse video section should begin with a [background] tag. Each entry of the file should be on its own line. The following colors can be programmed to display alternate values:

[foreground]

  • Red
  • Yellow
  • Gray
  • Lt_red
  • Green
  • Magenta
  • Lt_blue
  • Lt_magenta
  • Blue
  • Cyan
  • Lt_green
  • Lt_yellow
  • Black
  • White
  • Lt_Cyan
  • Lt_white

[background]

  • Red
  • Yellow
  • Gray
  • Green
  • Magenta
  • Black
  • Blue
  • Cyan
  • White

All entries in this file must be made in lower case to take effect. The color re-mapping is completed by selecting the base color you would like to change, and providing the value of the color to show in it’s place. The replacement colors are entered in BGR (Blue, Green, Red) and hexadecimal. The resulting 6 digit values range from 000000 to FFFFFF. For example:

  • Red: 0000FF
  • Yellow: 00FFFF
  • Green: 00FF00
  • Magenta: FF00FF
  • Blue: FF0000
  • Cyan: FFFF00
  • Black: 000000
  • White: FFFFFF

By example, if you wanted to set the text to be white text on a black background, and change the green text of a telnet session to display white in its place, you could use the following file contents:

[foreground]
white=000000
black=FFFFFF
green=00FF00

[background]
green=00FF00
white=FFFFFF
black=000000

In order for the changes present in the colors.ini file to take effect, the StayLinked client software will need to be restarted. Client versions that support colors.ini will automatically make the file persistent if transferred to the device via the StayLinked Administrator. In cases where you wish to discontinue use of the color changes, simply send a blank colors.ini file to the device and restart the client software.

Updated on February 1, 2023

Related Articles