Documentation

Basic Usage

Logging into your server

Once you are connected to the server, you will typically be prompted for your user name and password. TeSSH tries to auto-detect this, and will pop-up a dialog with your username and password and ask if you want TeSSH to create an auto-login trigger for you. If you click OK, then the next time you log-in, TeSSH will automatically enter your username and password. If you click Cancel, this trigger will not be created for you. Of course, the next time you log in, TeSSH will ask about creating the trigger again. If you want to stop TeSSH from auto-detecting your login process, simply go into the session properties and fill in a value for your user name.

Note that you can either type directly into the session window or you can type into the Command Line at the bottom of the window.  When you press <Enter>, the text in this field is sent to the server. It is also echoed to your text window if you have the Echo flag enabled (default is enabled) using the current command color (changeable in the Color preferences). You can quickly toggle between the main session window and the Command Line using the SHIFT-TAB key.

The Command Line

Once you have entered your character name and password, answer any other questions displayed by the server. All of the text that you type will be shown in the command line. You can use the <Backspace> key to edit this line or you can move the insertion point within the command line by using the mouse. If you have a separate set of arrow keys on your keyboard, you can use the right and left arrow to move within the command line. Note that the keys on the numeric keypad might have macros assigned to them by default so they cannot be used as arrow keys. When you press <Enter>, the text in the command entry field is sent to the server. If the Echo flag is enabled, it will be shown in the large text window in the current command color

You can enter multiple commands on the same line using the Separator character, which defaults to semi-colon (;). Thus,

cd ..;ls -al

will send the two commands "cd .." and "ls -al" to the server in quick succession. Also, when commands are sent to the server from the command line, a newline (CR/LF) is always added to the end automatically.

The command line can contain more than one line at a time. As you type, the text will automatically word-wrap at the right-edge of the line and the command line will expand to show the entire text string. Note that even though the text is displayed on a multiple lines, it is still considered one line by TeSSH and will be sent to the server as a single line. To add an actual second line, press Shift-Enter to force a hard new-line in the command. This works just like the command separator character. To clear the line, press the ESC key. You can turn off the word-wrap setting in the Preferences.

Commands that you send to the server are stored in your Command History. With the cursor on the first line of the command line, press UP-Arrow to recall the last command you entered. Press UP-Arrow again to recall the next command, and so on. If the cursor is in the last line of the command line, pressing Down-arrow will move the opposite direction through the command history. Or, if you have started typing a command, pressing Down-arrow will store the command in the command history without sending it.

This Down-arrow "save" feature is very useful if you are in the middle of typing a long message and you need to do something on the server quickly. Just press Down-arrow to save your command in the command buffer without sending it, then type the command you need to send to the server quickly and press Enter. Now that the command has been sent, press Up-arrow to retrieve your long message and continue working on it, and press Enter when you are ready to send it to the server.

The Output Window

You can scroll the main server window by clicking the scrollbars to the right and below the main window. You can also use the PgUp and PgDn keys on the keyboard (but again, not the number pad). When you scroll the window, the screen splits, with the scrollback shown above and the live text from the server shown below. The split bar can be dragged to any position to see as much or as little live text as desired. Once the screen is split, the Shift-Up and Shift-Down arrows can be used to move line by line, or the PgUp and PdDn keys can be used to scroll a page at a time.

You can still type commands in the command line and send them to the server while the screen is split. To unsplit the window and automatically return to the bottom of the scroll buffer, click the Pause button in the lower right corner of the window, or press the Ctrl-Z key, or press the ScrollLock key, or type #FREEZE on the command line. You can also unsplit the window by dragging the scroll bar to the bottom, or by pressing the PgDn key to scroll to the bottom. If your mouse has a Mouse-Wheel, it can also be used to split and scroll the screen.

You can search for text in the output window using the Find command in the Edit menu, or by pressing Ctrl-F. You can search backwards (default) and forwards through the buffer. Since this buffer can grow quite large, the Find command is very handy for rapidly locating past text. The screen is automatically split when the text is found so that you can view the scrollback buffer and the live text at the same time.

You can also copy text from the output window and paste it into other programs. When you highlight text with the mouse the screen is automatically frozen to prevent scrolling from disturbing your selection. When you release the mouse button, the text is automatically copied to the clipboard (you do not need to press Ctrl-C). You can select large portions of text (more that a screenful) by left clicking the start location, the left clicking while holding the Shift key at the end location. If you double-left-click, the word under the mouse is highlighted then copied to the clipboard. If you left-click in the narrow margin to the left of a line, the entire line will be selected.

Contents of the screen are stored to the clipboard in both plain ASCII text format and in color ANSI format. When you paste to an external program like Notepad, the plain text format is used. If you paste to the Command Editor the ANSI color format is used to preserve server colors. If you paste to the Command Line, plain text is used unless you have defined a color translation syntax in the color preferences in which case the ANSI color is converted to color commands for your server. If you paste more than one line of text into the command line, the line breaks are replaced with the command separator character (;).

Add comment

Login or register to post comments