Theme setup file

TODO

About theme file

There are several types of theme file.

BG(Backgroup) theme
File containing [BG Theme] section
This section is background image settings
Color theme
File containing [Color Theme] section
This section is text color settings
Old Color Theme (obsolete)
The [BG] section contains the text color settings.
Color themes supported in Tera Term 4
Loading this file is supported. But this will be deprecated

BG (background) themes and color themes may be saved in separate files, also save both in one file.

File format is Windows ini file.

BG(Background) theme

section

"BG theme"

The "BG" section can also be read (but will be deprecated). If both are present, "BG theme" has priority.

Simple color plane

simple one color plane.

BGSrc2Enable
Use Simple color plane (1) / Do not use (0)
BGSrc2Color
plane color
BGSrc2Alpha
Alphablend value
How much solid color (Src2) to blend with the composite image of Dest and Src1

Background Image

BGDestEnable
Use Background Image (1) / Do not use (0)
BGDestColor
If no background image is used, it will be filled with this color.
Areas where the background image is not drawn are also filled with this color.
BGDestFile
background image
If a wildcard is containd in the file name, one of the matching files will be selected at random.
If it is a relative path, specify a path relative to the theme file.
The type of files that can be read depends on plugin stored in the BGSPIPath.
Bitmaps(bmp) can be loaded without plugins.
BGDestPattern
Background pattern
stretch
Stretch image to fit the window.
tile
Tile image starting from the top-left corner of the window.
center
Display image in center of the window.
fit_width
Scale image to match the window width while maintaining aspect ratio.
fit_height
Scale image to match the window height while maintaining aspect ratio.
autofit
Maintain aspect ratio and display at maximum size without overflow.
autofill
Maintain aspect ratio and display at maximum size even if it overflows.
BGDestAlpha
Alphablend the wallpaper image in Windows.
This value to alpha blend value the desktop image (Src1) onto the background image (Dest).
When value is 0, the wallpaper will not be blended.

Desktop wallpaper image

BGSrc1Enable
Use desktop image (1) / Do not use (0)

Background image alpha

BGTextBackAlpha
0 - 255
AlphaBlend value for the normal text background color. 255 is full opacity.
BGReverseTextAlpha
0 - 255
AlphaBlend value for reverse text background color. 255 is full opacity.
BGTextAlpha
0 - 255
AlphaBlend value for other text background colors. 255 is full opacity.

color theme

section

"Color Theme"

name

Theme
Theme name, value is a string.

attribute color

VTColor
normal text background color, SGR 0
BoldColor
SGR 1
VTUnderlineColor
SGR 4
BlinkColor
SGR 5
ReverseColor
SGR 7
URLColor
URL text color
Text color added when Tera Term detects a URL string
values (0 or 1), (0 or 1), (fore red), (fore green), (fore blue), (back red), (back green), (back blue)
values (0 or 1), (0 or 1), (fore), (back)
(0 or 1)
1=Changing from the default color.
0=No change.
(Not referenced in VTColor)
(0 or 1)
1=Enable custom colors for text attributes (such as Bold attribute).
0=Disable.
(Not referenced in VTColor)
(fore red), (fore green), (fore blue)
Text color, each value from 0 to 255.
(back red), (back green), (back blue)
Background color, each from 0 to 255.
(fore), (back)
#RRBBGG format, each value from 0 to ff

ANSI color

First 16 colors when 256 ANSI colors or 16 ANSI colors.
Dark colors are not used when 8 colors.
ANSIColor=(0 or 1)
1=Changing from the default color.
0=No change.
Fore
256 ANSI color 15
Normal text color(VTColor is used)
Back
256 ANSI color 0
Normal background color(VTColor is used)
Red
Green
Yellow
Blue
Magenta
Cyan
DarkFore
DarkBack
DarkRed
DarkGreen
DarkYellow
DarkBlue
DarkMagenta
DarkCyan
Each color
Values are (red), (green), (blue)
from 0 to 255
value (color)
#RRBBGG format, from 00 to ff