Miscellaneous (Tera Term setup file)

# Beep sound on connection

To enable a beep sound which is made when a TCP/IP connection is established and when the connection is terminated, edit the BeepOnConnect line in the [Tera Term] section of the setup file like the following:

    BeepOnConnect=on

    Default:
    BeepOnConnect=off

# Executing a macro on startup

A macro can be executed automatically when Tera Term is started. You can specify the macro filename by using the command line option " /M=<macro file>" or by editing the StartupMacro line in the [Tera Term] section of the setup file like the following:

    StartupMacro=<macro file>

    Default:
    StartupMacro=

# User interface language file

To switch the display language, specify user interface language file that includes the message.

    UILanguageFile=lang\Japanese.lng

    Default:
    UILanguageFile=

# Number for the history of broadcast command

If you configure the number for the history of broadcast command, you need to set up MaxBroadcatHistory entry in the 'teraterm.ini' file. See example of this value below.

    MaxBroadcatHistory=200

    Default:
    MaxBroadcatHistory=99

# Mouse wheel action in application cursor mode

Basically, Tera Term window scrolls up and scrolls down when a user rotates the mouse wheel. However, Tera Term would send key sequences of up and down cursor when the application cursor mode is enabled by starting vi or less command.

To disable this feature, edit the TranslateWheelToCursor line in the [Tera Term] section of the setup file like the following:

    TranslateWheelToCursor=off

If a user wants to disable this feature while pushing the control key, edit the DisableWheelToCursorByCtrl line in the [Tera Term] section of the setup file like the following:

    DisableWheelToCursorByCtrl=on

    Default:
    TranslateWheelToCursor=on
    DisableWheelToCursorByCtrl=on

# Showing "New Connection" dialog on startup

Tera Term shows "New Connection" dialog on startup when the port type is TCP/IP. (The dialog is not shown when the port type is Serial).
If you do not want to show this dialog, please change HostDialogOnStartup entry of [Tera Term] section as follows.

    HostDialogOnStartup=off

    Default:
    HostDialogOnStartup=on

# Enable paste by clicking the middle button of mouse

In order to enable paste by clicking the middle button of mouse, change the DisablePasteMouseMButton line at [Tera Term] section of the setup file like the following:

    DisablePasteMouseMButton=off

    Default:
    DisablePasteMouseMButton=on

# Disable "New connection" menu

In order to disable "New connection" menu, change the DisableMenuNewConnection line at [Tera Term] section of the setup file like the following:

    DisableMenuNewConnection=on

    Default:
    DisableMenuNewConnection=off

# Disable "Duplicate session" menu

In order to disable "Duplicate session" menu, change the DisableMenuDuplicateSession line at [Tera Term] section of the setup file like the following:

    DisableMenuDuplicateSession=on

    Default:
    DisableMenuDuplicateSession=off

# Disable "Send break" menu

In order to disable "Send break" menu, change the DisableMenuSendBreak line at [Tera Term] section of the setup file like the following:

    DisableMenuSendBreak=on

    Default:
    DisableMenuSendBreak=off

# Clear the screen when disconnected

In order to clear the screen, change the ClearScreenOnCloseConnection line at [Tera Term] section of the setup file like the following:

    ClearScreenOnCloseConnection=on

    Default:
    ClearScreenOnCloseConnection=off

# Disable accelerator key of New Connection

In order to disable accelerator key of "New Connection", change the AcceleratorNewConnection line at [Tera Term] section of the setup file like the following:

    AcceleratorNewConnection=off

    Default:
    AcceleratorNewConnection=on

# Disable accelerator key of Duplicate session

In order to disable accelerator key of "Duplicate session", change the DisableAcceleratorDuplicateSession line at [Tera Term] section of the setup file like the following:

    DisableAcceleratorDuplicateSession=on

    Default:
    DisableAcceleratorDuplicateSession=off

# Disable accelerator key of Cygwin connection

In order to disable accelerator key of "Cygwin connection", change the AcceleratorCygwinConnection line at [Tera Term] section of the setup file like the following:

    AcceleratorCygwinConnection=off

    Default:
    AcceleratorCygwinConnection=on

# A browser by using Clickable URL

When the clickable URL is enabled, the default browser will be launched.
If a user can specify the browser and the argument, change the ClickableUrlBrowser and the ClickableUrlBrowserArg entries at [Tera Term] section in the following:

    ClickableUrlBrowser=firefox
    ClickableUrlBrowserArg=-new-tab

    ClickableUrlBrowser=opera
    ClickableUrlBrowserArg=-newpage

    ClickableUrlBrowser=iexplore
    ClickableUrlBrowserArg=

    ClickableUrlBrowser=chrome
    ClickableUrlBrowserArg=

    Default:
    ClickableUrlBrowser=
    ClickableUrlBrowserArg=

# URL string concatenated of split line

When the end of URL string continues to the next line, basically the whole string is recognized as a URL string. However, when the carriage return is inserted into the URL string by the end of a line, the whole string can not work well.
The URL string split by a carriage return can work well to configure the JoinSplitURL entry of the [Tera Term] section in the teraterm.ini file.

    JoinSplitURL=on

By using the emacs editor, a special character will be displayed at the end of the line when the line continues to next line. If this character is recognized with a part of URL string, the whole string can not work well with the URL format.
So, Tera Term can ignore the special character to configure the JoinSplitURLIgnoreEOLChar entry of the [Tera Term] section in the teraterm.ini file.

    JoinSplitURLIgnoreEOLChar=

Also, the emacs editor can change the special character to other character.
When the character is changed, a user configures the JoinSplitURLIgnoreEOLChar entry of the [Tera Term] section in the following:

    JoinSplitURLIgnoreEOLChar=|

    Default:
    JoinSplitURL=off
    JoinSplitURLIgnoreEOLChar=\

# Exclusive-lock log file

When a log file is opened in written mode, the file will be locked exclusively. So, the log file can not be opened by multiple processes.
When this option is disabled, a user can open a log file while Tera Term is opening the file.

    LogLockExclusive=off

    Default:
    LogLockExclusive=on

# Deferred log write mode

The log file is written on the thread procedure to avoid Tera Term slows down when the log file is recorded on the network drive.

    DeferredLogWriteMode=off

    Default:
    DeferredLogWriteMode=on

# Specify timestamp format at the start of log file's line

When the log file is written, the timestamp can be added at the start of line and the timestamp format can be specified.

    SYNOPSIS:
    %a      Abbreviated weekday name
    %b      Abbreviated month name
    %d      Day of month as decimal number (01 - 31)
    %e      Day of month as decimal number ( 1 - 31)
    %H      Hour in 24-hour format (00 - 23)
    %N      Milisecond as decimal number (000 - 999)
    %m      Month as decimal number (01 - 12)
    %M      Minute as decimal number (00 -  59)
    %S      Second as decimal number (00 - 59)
    %w      Weekday as decimal number (0 - 6; Sunday is 0)
    %Y      Year with century, as decimal number
    %%      Percent sign

    Example:
    ; Sun Jun  4 21:12:40.123 2017
    LogTimestampFormat=%a %b %e %H:%M:%S.%N %Y

    Default:
    ; 2017-06-04 21:12:40.123
    LogTimestampFormat=%Y-%m-%d %H:%M:%S.%N

# UTC is used as timestamp at the start of log file's line

When the log file is written, the timestamp can be added at the start of log file's line. Basically, local time is used.
When local time is used for summer time, the clock will go or back at summer time switching. So, unexpected clock will be recorded.
Fortunately, this problem can be avoided because UTC timestamp does not support summer time.
If UTC timestamp is used instead of local time, change the LogTimestampUTC entry of [Tera Term] section in the following:

    LogTimestampUTC=on

    Default:
    LogTimestampUTC=off

# High DPI Aware

The High DPI feature is supported. Tera Term works as the Per-monitor DPI Aware application.

Tera Term works as the DPI Unaware application when "DPIAware=off" entry is added to [Tera Term] section in teraterm.ini.

Scaling results become smooth at High DPI when you choose a TrueType font for the Font.

High DPI aware has some modes. For more reference, see the DPI AwarenessMode section on the High DPI Desktop Application Development on Windows DPI AwarenessMode.

Tera Term is using the Per-monitor DPI awareness V2 feature that is supported on the Windows 10 Version 1703 or later. For more details of the Per-monitor DPI awareness V2, see the High-DPI Scaling Improvements for Desktop Applications in the Windows 10 Creators Update (1703).