Terminal emulation (Tera Term setup file)

# Back wrap

If you enables the back wrap, the cursor at the beginning of a line moves back to the end of previous line when a BS character is received. To enable the back wrap, edit the BackWrap line in the [Tera Term] section of the setup file like the following:

    BackWrap=on

    Default:
    BackWrap=off

# The motion receiving BEL character

Tera Term will sound the beep when the BEL character(ASCII $07) receives.

You can disable the beep sound for the BEL character by editing the Beep line in the [Tera Term] section of the setup file like the following:

    Beep=off

Also, the terminal screen will flush instead of sounding the beep in the following configuration.

    Beep=visual

    Default:
    Beep=on

# Disabling the C1 (ASCII $80-$9F) control characters

If you choose the Terminal ID to be "VT2XX" or "VT3XX" in the [Setup] Terminal dialog box, characters in range of ASCII $80-$9F are interpreted as the C1 control characters.

You can disable this interpretation and make these characters visible on the screen (if you are using a font which supports these characters), by editing the Accept8BitCtrl line in the [Tera Term] section of the setup file like the following:

    Accept8BitCtrl=off

    Default:
    Accept8BitCtrl=on

# Send C1 (ASCII $80-$9F) control characters

When sending C1 control characters, Tera Term uses equivalent 7-bit sequences.

To send C1 control characters as single 8-bit characters, edit the Send8BitCtrl line in the [Tera Term] section of the setup file like the following:

    Send8BitCtrl=on

Note: This setting is used only as default setting. Host can change this setting by S7C1T / S8C1T / DECSCL control sequence.

    Default:
    Send8BitCtrl=off

# Displaying all received characters

To display all received characters (including control characters) on the screen, edit the Debug line in the [Tera Term] section of the setup file like the following:

    Debug=on

If you press Shift+Esc, Tera Term enters the debug mode, in which all received characters are displayed on the screen. The debug mode have four pattern, a user can switch from output as usual to disable output completely.

- output as usual -> usual teraterm debug mode -> hex output -> disable output completely

If you select the output as usual in the debug mode, Tera Term returns to the normal mode.

In the debug mode, received characters are displayed by the following way:

    ASCII code of the character    Displaying form
    $00 - $1F                      ^@ - ^_
                                   ($00=^@ $01=^A $02=^B $03=^C $04=^D $05=^E $06=^F $07=^G
                                    $08=^H $09=^I $0A=^J $0B=^K $0C=^L $0D=^M $0E=^N $0F=^O
                                    $10=^P $11=^Q $12=^R $13=^S $14=^T $15=^U $16=^V $17=^W
                                    $18=^X $19=^Y $1A=^Z $1B=^[ $1C=^\ $1D=^] $1E=^^ $1F=^_)
    $20 - $7E                      normal character
    $7F                            <DEL>
    $80 - $FF                      MSB of the ASCII code is turned to be 0 and displayed by
                                   the same way as one for $00-$7F characters,
                                   except that text is displayed in the reversed color.

In the hex output mode, received characters are displayed by the following way:

    ASCII code of the character    Displaying form
    $00 - $FF                      hex format(capital letters) separated by a space

    Default:
    Debug=off

# Disabling the status line

To disable the status line functions of VT terminal, edit the EnableStatusLine line in the [Tera Term] section of the setup file like the following:

    EnableStatusLine=off

Then, escape sequences for the status line functions are ignored.

    Default:
    EnableStatusLine=on

# Mouse code in TEK GIN report

In TEK GIN mode, the cross hair cursor appears in the TEK window. When you press a key or click the left mouse button, the key code (ASCII code) is sent with the coordinate of the cursor.

You can change the key code for the left mouse button by editing the TEKGINMouseCode line in the [Tera Term] section of the setup file like the following:

    TEKGINMouseCode=<key code>

    Default:
    TEKGINMouseCode=32
    (ASCII code 32 corresponds to the space character.)

# Displaying tab at end of line like VT terminal

If you set 'on', the behavior of tab at end-of-line is the same as VT/PuTTY/xterm. The tab doesn't cause automatic linefeed.
If you set 'off', the behavior of tab at end-of-line is the same as FreeBSD console(syscons). The tab causes automatic linefeed. (it is not compatible with VT)

    VTCompatTab=on

    Default:
    VTCompatTab=off

# Scroll down the current buffer when the screen is clear

<ESC>[J (Erase Below) escape sequence equals <ESC>[2J (Erase All) when the current cursor is top left (0, 0).
A user can configure whether the current buffer scrolls down when the screen is clear.

If this configuration value is on, the current buffer will scroll down as well as <ESC>[2J escape sequence.
If this configuration value is off, the current buffer will not scroll down. Instead, some buffers from the cursor position to the end of the screen.

    Default:
    ScrollWindowClearScreen=on

# Mapping of Unicode to DEC special character

Tera Term in Japanese mode will display a ruled line and some symbols as 2-columns wide. However, some host applications may assume these characters will be displayed as 1-column wide character which results in incorrect display image.
In addition, a ruler may be displayed by using +-| and some unsupported characters may be displayed as ?? in English mode.
Tera Term can be configured to display these characters by similar code of DEC special characters (if any exists) to minimize the incorrect display image.
However this feature causes a side effect that characters selected by mouse will be copied as different characters in a clipboard.
This configuration takes effect only when received Kanji code are either UTF-8 or UTF-8.

Some mapping characters are categorized into several groups and you can specify each group to be converted or not.
If a user configures this option, please specify the sum value of the converting character at UnicodeToDecSpMapping entry.

    Type A: Rule marks
    Value: 1
      Box drawings (U+2500-U+257F)

    Type B: The character that is displayed "??" up to version 4.58
    (it includes undisplayed characters in English environment).

    Value: 2
      Bullet (U+2022)
      Hyphenation point (U+2027)
      Light shade (25%) (U+2591)
      Medium shade (50%) (U+2592)
      Dark shade (75%) (U+2593)
      Black small square (U+25AA)
      Black vertical rectangle (U+25AE)
      Black very small square (U+2B1D)

    Type C: The character that is displayed as bullet(wide character)
    in Japanese environment, and is displayed as Middle dot in English environment.

    NOTICE: A user is recommended to not specifying this option unless in Japanese environment.

    Value: 4
      Middle dot (U+00B7)
      One dot leader (U+2024)
      Bullet operator (U+2219)

    Default:
    # Type A and B
    UnicodeToDecSpMapping=3

# Mapping of the function key

A use can change the default action of the function key and the editor keypad from Tera Term 4.62. When a user can use this feature, the key sequence like as the VT terminal sends to the server without the keyboard configuration file.

If a user disables the function key action in the keyboard configuration file and sends nothing to the server, please change the StrictKeyMapping entry in teraterm.ini file in the following:

    StrictKeyMapping=on

    The default value:
    StrictKeyMapping=off

# MSB set character sending with Alt key

To send MSB(Most Significant Bit) set character by using the Alt key, a user should modify Meta8Bit line of [Tera Term] section in a configuration file as follows

    Meta8Bit=raw

To send MSB(Most Significant Bit) set character by using the Alt key with a conversion to transmission character code (e.g. UTF-8), a user should modify Meta8Bit line of [Tera Term] section in a configuration file as follows

    Meta8Bit=text

Also, the user should enable the Meta Key setting.

    default:
    Meta8Bit=off

# Disabling the alternate screen buffer

Tera Term 4.65 later version supports for the alternate screen buffer. An old screen is restored when the application such as Vim and less exits.

To disable the alternate screen buffer functions, edit the AlternateScreenBuffer line in the [Tera Term] section of the setup file like the following:

    AlternateScreenBuffer=off

    default:
    AlternateScreenBuffer=on

# Configure Terminal Unique ID

When the Tera Term receives the DA3 control sequence, the Tera Term replies the terminal unique ID. The ID is 8-digit hex value, the first 2-digit is the manufacture place and the remaining 6-digit is the unique number in the place.

If a user changes the ID to the 01234567, configure the TerminalUID entry in the teraterm.ini file as follows:

    TerminalUID=01234567

    Default:
    TerminalUID=FFFFFFFF

# Changing Terminal Unique ID

Basically, the terminal unique ID can be changed by receiving the DECSTUI control sequence. However, this feature is disabled.

When the feature is enabled, describe the LockTUID entry in the [Tera Term] section as follows:

    LockTUID=off

    Default:
    LockTUID=on

# Disabling tabstop modification

When the tabstop position can not be able to modify by the control sequence, configure below TabStopModifySequence entry in the [Tera Term] section of the teraterm.ini file.

    TabStopModifySequence=off

Also, some control sequences can not be able to do. Enabling sequences of the tabstop control sequence are as follows:

Mnemonic | Sequence | Description
--- | --- | ---
HTS7 | ESC H | Enables the tabstop at the cursor position(7bit form).
HTS8 | 0x88 | Enables the tabstop at the cursor position(8bit form).
HTS | - | Both HTS7 and HTS8.
TBC0 | ESC [ 0 g | Disabling the tabstop at the cursor position.
TBC3 | ESC [ 3 g | Disabling all tabstop.
TBC | - | Both TBC0 and TBC3.

For example, when 8bit-form tabstop sequence(HTS8) is disabled, configure below TabStopModifySequence entry in the [Tera Term] section of the teraterm.ini file.

    TabStopModifySequence=HTS7,TBC

    Default:
    TabStopModifySequence=on

# Limited BELL Over

When the BEL character(ASCII $07) is sent from the host server, Tera Term will generate a beep sound and blink a screen.

When a user shows the binary file by mistake and many BEL characters are sent, much beep sound can suppress automatically.
For example, when the BeepOverUsedTime, BeepOverUsedCount and BeepSuppressTime are below configured, the beep sound will be suppressed for ten seconds after five BEL characters are sent for two seconds.

    BeepOverUsedTime=2
    BeepOverUsedCount=5
    BeepSuppressTime=10

    Default:
    BeepOverUsedTime=2
    BeepOverUsedCount=5
    BeepSuppressTime=5

# OSC string buffer size

Tera Term will expand the buffer size of the OSC string when the buffer size is lack. However, when the remote host sends invalid OSC string by using the host bug, Tera Term will restrict the buffer size to prevent enlarged memory allocation.

When the OSC 52 (PASTE64) is used for burst data, the remote host data may be abandoned by above restriction.
So, a user can configure the OSC buffer size in the MaxOSCBufferSize entry of the teraterm.ini file.

    MaxOSCBufferSize=16000

    Default:
    MaxOSCBufferSize=4096

# Disabling ISO/IEC 2022 shift function

When character set switching by ISO/IEC 2022 shift is forbidden, please configure below setting on ISO2022ShiftFunction entry of [Tera Term] section in the teraterm.ini file.

    ISO2022ShiftFunction=off

Also, specific entry can be disabled into ISO/IEC 2022 shift function. Please specify accepted function name's combination into below shift function.

Mnemonic | Code | Description
--- | --- | ---
SI | 0x0F | Maps G0 character set into GL.
SO | 0x0E | Maps G1 character set into GL.
LS2 | ESC n | Maps G2 character set into GL.
LS3 | ESC o | Maps G3 character set into GL.
LS1R | ESC ~ | Maps G1 character set into GR.
LS2R | ESC } | Maps G2 character set into GR.
LS3R | ESC | | Maps G3 character set into GR.
SS2 | 0x8E / ESC N | Temporarily maps the G2 character set into GL or GR, for the next graphic character.
SS3 | 0x8F / ESC O | Temporarily maps the G3 character set into GL or GR, for the next graphic character.
ALL | - | All of the above
NONE | - | Nothing

For example, when Shift-In(SI) and Shift-Out(SO) is disabled, please configure below setting on the ISO2022ShiftFunction entry of [Tera Term] section in the teraterm.ini file.

    ISO2022ShiftFunction=LS2,LS3,LS1R,LS2R,LS3R,SS2,SS3

Also, when '-' is added in the front of name, specified shift function can be disabled. The above Shift-In(SI) and Shift-Out(SO) is disabled to configure below setting.

    ISO2022ShiftFunction=ALL,-SI,-SO

NOTE: When this format is specified, using function is replaced after configure saving.

    Default:
    ISO2022ShiftFunction=on