tssh v0.1.3 Release: Installation and Usage Guide

tssh v0.1.3 has been released, adding support for specifying multiple private keys and using password‑protected keys.

GitHub: https://github.com/trzsz/trzsz-ssh Gitee: https://gitee.com/trzsz/tssh

Ever struggled to remember many servers and missed a terminal with server‑management features? tssh lets you select (search) servers defined in ~/.ssh/config for login and supports Vim‑style operations.

tssh also includes built‑in support for trzsz (trz/tsz), solving the slow upload issue of trzsz ssh on Windows.

Installation Methods

The server must have trzsz installed to use trz / tsz for upload and download; three implementations are available: Go, Python, and JavaScript. If the server lacks trzsz, tssh still works but without trz / tsz transfer.

Client installation of tssh can be done in either of the following ways:

Install directly with Go (requires Go 1.20 or higher):

go install github.com/trzsz/trzsz-ssh/cmd/tssh@latest

After installation, the tssh binary is usually located in ~/go/bin/ (on Windows: C:\Users\your_name\go\bin\ ).

Download a pre‑built binary from the Releases page.

Usage

In the examples below, ~/ denotes the home directory; on Windows replace it with C:\Users\your_name\.

Generate an SSH key pair on the client, typically stored under ~/.ssh/ : ssh-keygen -t rsa -b 4096 This creates a private key ~/.ssh/id_rsa and a public key ~/.ssh/id_rsa.pub .

Append the public key (the .pub file) to the server’s ~/.ssh/authorized_keys file, and set correct permissions:

chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys

Create or edit ~/.ssh/config on the client, for example:

Host alias1
    HostName 192.168.0.1
    Port 22
    User your_name
Host alias2
    HostName 192.168.0.2
    Port 22
    User your_name

Log in to a server using tssh: tssh alias1 tssh reads the matching entry from ~/.ssh/config and connects accordingly.

Run tssh without arguments to interactively search and select a host defined in ~/.ssh/config for login.

Remembering Passwords

To stay compatible with standard SSH, password entries are stored separately in ~/.ssh/password , while other settings remain in ~/.ssh/config .

It is recommended to use key‑based authentication; if passwords are required, set proper permissions: chmod 700 ~/.ssh && chmod 600 ~/.ssh/password Example password configuration (the entry for test2 uses password 123456 , while entries starting with test use 111111 ):

Host test2
    Password 123456
# ~/.ssh/config and ~/.ssh/password support wildcards; tssh uses the first matching entry.
# Here we place test2 after test* to give it a distinct password.

Host test*
    Password 111111

Demo

Found this guide helpful? Like and share to show your support!