html/setup/teraterm-win.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>Window (Tera Term setup file)</title>
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="stylesheet" href="../style.css" type="text/css">
</head>
<body>

<h1 id="autocopy">Disabling auto text copying</h1>

<p>
If you select text by mouse, it is copied to the clipboard at the same time. To disable the auto text copying, edit the AutoTextCopy line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
AutoTextCopy=off
</pre>

<pre>
Default:
AutoTextCopy=on
</pre>


<h1 id="delimiter">Delimiters of a word selected by double clicking</h1>

<p>
You can select a word by double clicking it with the left mouse button. You can specify delimiter characters for the word selection by editing the DelimList line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
DelimList=&lt;delimiter characters&gt;
</pre>

<p>
For example:
</p>

<pre>
DelimList=&lt;&gt;()[]
</pre>

<p>
specifies 6 delimiter characters "&lt;", "&gt;", "(", ")", "[" and "]".
Note that the space and "$" characters should be specified as "$20" and "$24":
</p>

<pre>
DelimList=$20    ; space character
</pre>

<pre>
Default:
DelimList=$20!"#$24%&amp;'()*+,-./:;&lt;=&gt;?@[\]^`{|}~
</pre>

<p>
In the DelimList line, only singe-byte code characters can be specified. Double-byte code characters (Japanese kanji) are regarded as delimiters. You can make them be non-delimiters by editing the DelimDBCS line like the following:
</p>

<pre>
DelimDBCS=off
</pre>

<pre>
Default:
DelimDBCS=on
</pre>

<p>
If you prefer the word selection behavior of earlier Tera Term versions, specify like the following:
</p>

<pre>
DelimList=$20
DelimDBCS=off
</pre>


<h1 id="popup">Disabling the pop-up menu</h1>

<p>
When the menu bar is hidden, clicking the left mouse button while pressing the Ctrl key causes the pop-up menu to appear. To disable the pop-up menu, edit the EnablePopupMenu line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
EnablePopupMenu=off
</pre>

<pre>
Default:
EnablePopupMenu=on
</pre>


<h1 id="menubar">Hiding the "Show menu bar" command</h1>

<p>
When the menu bar is hidden, the "Show menu bar" command appears in the system menu. To hide the "Show menu bar" command, edit the EnableShowMenu line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
EnableShowMenu=off
</pre>

<pre>
Default:
EnableShowMenu=on
</pre>


<h1 id="lang">Disabling the language mode selection</h1>

<p>
To disable the language mode selection in the [Setup] General dialog box, edit the LanguageSelection line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
LanguageSelection=off
</pre>

<pre>
Default:
LanguageSelection=on
</pre>


<h1 id="scrollbuf">Maximum scroll buffer size</h1>

<p>
You can change the maximum scroll buffer size, which can be specified in the [Setup] Window dialog box, by editing the MaxBuffSize line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
MaxBuffSize=&lt;number of lines&gt;
    (should be less than or equal to 500000)
</pre>

<p>
Note: Tera Term consumes &lt;scroll buffer size&gt; * &lt;terminal width&gt; * 5 bytes of memory for the scroll buffer.
</p>

<pre>
Default:
MaxBuffSize=10000
</pre>


<h1 id="blink">Nonblinking cursor</h1>

<p>
You can make the cursor nonblinking by editing the NonblinkingCursor line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
NonblinkingCursor=on
</pre>

<pre>
Default:
NonblinkingCursor=off
</pre>


<h1 id="scrollline">Maximum number of lines to move in a jump scrolling</h1>

<p>
To change the maximum number of lines to move in a jump scrolling, edit the ScrollThreshold line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
ScrollThreshold=&lt;number of lines&gt;
</pre>

<pre>
Default:
ScrollThreshold=12
</pre>


<h1 id="textselect">Disabling text selection when the window is activated by mouse</h1>

<p>
When the window is inactive, you can activate the window by clicking the text area of window. In the default setup, the text selection is started by this mouse clicking at the same time. To disable the text selection when the window is activated by mouse, edit the SelectOnActivate line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
SelectOnActivate=off
</pre>

<pre>
Default:
SelectOnActivate=on
</pre>


<h1 id="title">Title format</h1>

<p>
To change the title format, edit the TitleFormat line in the [Tera Term] section of the setup file like the following:
</p>

<p>
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:
</p>

<pre>
TitleFormat=&lt;format ID&gt;
</pre>

<p>
&lt;format ID&gt; is an integer value. It is treated as bit string.
</p>

<table>
 <tr>
  <td>1st bit (1)</td>
  <td>Displays tcp hostname or serial port number</td>
 </tr>
 <tr>
  <td>2nd bit (2)</td>
  <td>Displays session No.</td>
 </tr>
 <tr>
   <td>3rd bit (4)</td>
   <td>Displays VT/TEK</td>
  </tr>
 <tr>
   <td>4th bit (8)</td>
   <td>Displays &lt;host/port&gt; first</td>
  </tr>
 <tr>
  <td>5th bit (16)</td>
  <td>Displays TCP port number</td>
 </tr>
 <tr>
  <td>6th bit (32)</td>
  <td>Displays the speed of serial port</td>
 </tr>
</table>

<p>
Examples of &lt;format ID&gt; are shown as follows.
</p>

<pre>
Format ID   Title format
0           &lt;title&gt;
1           &lt;title&gt; - &lt;host/port&gt;
2           &lt;title&gt; (session no.)
3           &lt;title&gt; - &lt;host/port&gt; (session no.)
4           &lt;title&gt; VT/TEK
5           &lt;title&gt; - &lt;host/port&gt; VT/TEK
6           &lt;title&gt; (session no.) VT/TEK
7           &lt;title&gt; - &lt;host/port&gt; (session no.) VT/TEK
13          &lt;host/port&gt; - &lt;title&gt; VT/TEK
29          &lt;host:tcpport/port&gt; - &lt;title&gt; VT/TEK
45          &lt;host/port:bps&gt; - &lt;title&gt; VT/TEK
61          &lt;host:tcpport/port:bps&gt; - &lt;title&gt; VT/TEK
</pre>

<pre>
Default:
TitleFormat=5
</pre>


<h1 id="color">Actual colors of "white" and "black" colored text</h1>

<p>
The escape sequences "&lt;ESC&gt;[37m" and "&lt;ESC&gt;[30m" make the text color white and black, respectively. Similarly, the escape sequences "&lt;ESC&gt;[47m" and "&lt;ESC&gt;[40m" make the background color white and black, respectively.
</p>

<p>
Some applications assume that the screen background is black (like real VT100 terminal), and expect that white colored text is visible. However, when the background color of Tera Term is white, therefore white colored text is invisible.
</p>

<p>
If you edit the UseTextColor line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
UseTextColor=on
</pre>

<p>
the actual color of "white" colored text (background) becomes a color for "Text" specified in the [Setup] Window dialog box. Similarly, the actual colors for "black" text (background) becomes a color for "Background".
</p>

<pre>
Default:
UseTextColor=off
</pre>


<h1 id="space">Space between characters (lines)</h1>

<p>
To change space between characters (lines), edit the VTFontSpace line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
VTFontSpace=&lt;dx1&gt;,&lt;dx2&gt;,&lt;dy1&gt;,&lt;dy2&gt;
</pre>

<pre>
Where:
  &lt;dx1&gt;  Left side space for each character in pixels.
  &lt;dx2&gt;  Right side space for each character in pixels.
  &lt;dy1&gt;  Space above each line in pixels.
  &lt;dy2&gt;  Space below each line in pixels.
</pre>

<pre>
Example:
VTFontSpace=0,1,0,0    1 pixel of right side space for each character.
VTFontSpace=0,0,1,0    1 pixel of space above each line.
</pre>

<pre>
Default:
VTFontSpace=0,0,0,0
</pre>


<h1 id="window">Hiding the [Window] menu</h1>

<p>
To hide the [Window] menu, edit the WindowMenu line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
WindowMenu=off
</pre>

<pre>
Default:
WindowMenu=on
</pre>

<h1 id="maximize">How to scroll the screen when the window size is maximized</h1>
<p>
The screen scrolling method can be specified when the window size is maximized.
</p>
<p>
When the window size is maximized, the screen will be corrupted while the screen is scrolling as same normal window. 
So, a user can change the method of scrolling method. <br
Currently, below scrolling methods are as follows:
</p>

<ul>
  <li> Method 0. Normal scrolling method is used. However, a part of character will be corrupted while scrolling.</li>
  <li> Method 1. Scrolling method until Tera Term 4.94 is used. Character is not corrupted, however the screen flickers and the scrolling speed is slow. </li>
  <li> Method 2. New method since Tera Term 4.95 is used. The screen does not flicker, however bottom line will remain garbage on scrolling back.</li>
</ul>

<p>
The default value is Method 2 when the window size is maximized. If you have a problem by using scrolling, the method can be changed another method. <br>
For example, when the MaximizedBugTweak entry of [Tera Term] section is changed below setting, the Method 1 is used for scrolling.
</p>

<pre>
MaximizedBugTweak=1
</pre>

<pre>
Default:
MaximizedBugTweak=2
</pre>


<h1 id="killfocus">Display the cursor even if the window comes out of focus</h1>
<p>
Tera Term will display the cursor even if the window comes out of focus.<br>
If you want to disable this option, modify a line of KillFocusCursor in [Tera Term] section of setup file as follows.
</p>

<pre>
KillFocusCursor=off
</pre>

<pre>
Default:
KillFocusCursor=on
</pre>


<h1 id="vttekpos">Fix the initial window position</h1>
<p>
In order to change the default window position, change values of VTPos line(VT Window) and TEKPos line(TEK Window) at [Tera Term] section inside the setup file.<br>
For example, if you want to set the default VT window position to 200 pixels from the left side of the screen and 100px from the top of the screen, change the setup file as follows.
</p>

<pre>
VTPos=200,100
</pre>

<p>
The initial position is not fixed and Windows can decide the position by changing the setup file as follows.
</p>

<pre>
VTPos=-2147483648,-2147483648
TEKPos=-2147483648,-2147483648
</pre>

<p>
Notice: As described <a href="#savevtwinpos">below</a>, if SaveVTPosWinPos is on and at the time of executing "Save setup" or closing VT window, VTPos setting will be overwritten by current window position setting.
</p>

<pre>
Default:
VTPos=-2147483648,-2147483648
TEKPos=-2147483648,-2147483648
</pre>


<h1 id="savevtwinpos">Save the window position</h1>
<p>
Tera Term does not save the window position when "Save setup" was called.<br>
If you enable this position, current window position is saved to a specified setup file.
</p>

<p>
Also if this option is enabled, current window position and terminal size are saved to the current setup file when VT window was closed.
</p>

<pre>
SaveVTWinPos=on
</pre>

<pre>
Default:
SaveVTWinPos=off
</pre>


<h1 id="WindowIcon">Change the window icon</h1>
<p>
Tera Term executable program includes "VT window" icon, "TEK window" icon, and some other icons.
If you change the value of VTIcon or TEKIcon, the displaying icon of VT window or TEK window is changed.
</p>

<p>
For example, to use old icon for VT window, specify like the following:
</p>

<pre>
VTIcon=VT_CLASSIC
</pre>

<p>
Following icon names are available:
</p>

<table>
<thead>
  <tr><th>Icon name</th>     <th>Icon</th></tr>
</thead>

<tbody>
  <tr><td>TTERM</td>         <td><img src="../image/icon-teraterm.png" ALT="Icon of TTERM"></td></tr>
  <tr><td>VT</td>            <td><img src="../image/icon-vt.png" ALT="Icon of VT"></td></tr>
  <tr><td>TEK</td>           <td><img src="../image/icon-tek.png" ALT="Icon of TEK"></td></tr>
  <tr><td>TTERM_CLASSIC</td> <td><img src="../image/icon-teraterm_classic.png" ALT="Icon of TTERM_CLASSIC"></td></tr>
  <tr><td>VT_CLASSIC</td>    <td><img src="../image/icon-vt_classic.png" ALT="Icon of VT_CLASSIC"></td></tr>
  <tr><td>TTERM_3D</td>      <td><img src="../image/icon-teraterm_3d.png" ALT="Icon of TTERM_3D"></td></tr>
  <tr><td>VT_3D</td>         <td><img src="../image/icon-vt_3d.png" ALT="Icon of VT_3D"></td></tr>
  <tr><td>TTERM_FLAT</td>    <td><img src="../image/icon-teraterm_flat.png" ALT="Icon of TTERM_FLAT"></td></tr>
  <tr><td>VT_FLAT</td>       <td><img src="../image/icon-vt_flat.png" ALT="Icon of VT_FLAT"></td></tr>
  <tr><td>CYGTERM</td>       <td><img src="../image/icon-cygterm.png" ALT="Icon of CYGTERM"></td></tr>
  <tr><td>Default</td>       <td>Default("VT" at VT window, "TEK" at TEK window)</td></tr>
</tbody>
</table>

<p>
Also, the icon of SSH connection can be changed. For example, when the yellow icon(TTSSH2.62 earlier) is specified, please change the SSHIcon entry in the [TTSSH] section in the following:
</p>

<pre>
SSHIcon=yellow
</pre>

<p>
The SSHIcon can be specified in the following names:
</p>

<table>
<thead>
  <tr><th>Name</th>          <th>Icon</th></tr>
</thead>

<tbody>
  <tr><td>flat2</td>         <td><img src="../image/icon-ttsecure.png" ALT="flat2 ttssh icon"></tr>
  <tr><td>classic</td>       <td><img src="../image/icon-ttsecure_classic.png" ALT="original ttssh icon"></tr>
  <tr><td>yellow</td>        <td><img src="../image/icon-ttsecure_yellow.png" ALT="yellow ttssh icon"></tr>
  <tr><td>green</td>         <td><img src="../image/icon-ttsecure_green.png" ALT="green ttssh icon"></tr>
  <tr><td>flat</td>          <td><img src="../image/icon-ttsecure_flat.png" ALT="flat ttssh icon"></tr>
  <tr><td>Default</td>       <td>A default icon(equal to flat2)</td></tr>
</tbody>
</table>

<pre>
Default:
VTIcon=Default
TEKIcon=Default
SSHIcon=Default
</pre>


<h1 id="delayselect">Delay for stating of text selection</h1>
<p>
You can configure the delay for the start of text selection with the mouse and treat it as a click if the time you drag with the mouse is short.<br>
For example, to handle as a click when the mouse drag time is shorter than 200 msecs, edit the MouseSelectStartDelay line in the [Tera Term] section of the setup file like the following:
</p>

<pre>
MouseSelectStartDelay=200
</pre>

<pre>
Default:
MouseSelectStartDelay=0
</pre>


<h1 id="WindowCornerDontround">Don&#39;t round window corners</h1>

<p>
On Windows 11 the corners of window are rounded, so some areas are not shown.
To prevent rounding the corners of the VT and TEK window, change the WindowCornerDontround line in [Tera Term] section of the setup file like the following:
</p>

<pre>
WindowCornerDontround=on
</pre>

<pre>
Default:
WindowCornerDontround=off
</pre>


</body>
</html>