Awesome

trzsz-ssh ( tssh ) - an openssh client alternative

trzsz-ssh ( tssh ) is an ssh client designed as a drop-in replacement for the openssh client. It aims to provide complete compatibility with openssh, mirroring all its features, while also offering additional useful features not found in the openssh client.

Basic Features

trzsz-ssh ( tssh ) works exactly like the openssh client. The following common features have been implemented:

Extra Features

trzsz-ssh ( tssh ) offers additional useful features:

Installation

• Install with scoop / winget / choco on Windows

  <details><summary><code>scoop install tssh</code> / <code>winget install tssh</code> / <code>choco install tssh</code></summary>

  scoop install tssh
  

  winget install tssh
  

  choco install tssh
  

  </details>

• Install with homebrew on MacOS

  <details><summary><code>brew install trzsz-ssh</code></summary>

  brew update
  brew install trzsz-ssh
  

  </details>

• Install with apt on Ubuntu

  <details><summary><code>sudo apt install tssh</code></summary>

  sudo apt update && sudo apt install software-properties-common
  sudo add-apt-repository ppa:trzsz/ppa && sudo apt update
  
  sudo apt install tssh
  

  </details>

• Install with apt on Debian

  <details><summary><code>sudo apt install tssh</code></summary>

  sudo apt install curl gpg
  curl -s 'https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x7074ce75da7cc691c1ae1a7c7e51d1ad956055ca' \
    | gpg --dearmor -o /usr/share/keyrings/trzsz.gpg
  echo 'deb [signed-by=/usr/share/keyrings/trzsz.gpg] https://ppa.launchpadcontent.net/trzsz/ppa/ubuntu jammy main' \
    | sudo tee /etc/apt/sources.list.d/trzsz.list
  sudo apt update
  
  sudo apt install tssh
  

  </details>

• Install with yum on Linux

  <details><summary><code>sudo yum install tssh</code></summary>

  • Install with gemfury repository.

    echo '[trzsz]
    name=Trzsz Repo
    baseurl=https://yum.fury.io/trzsz/
    enabled=1
    gpgcheck=0' | sudo tee /etc/yum.repos.d/trzsz.repo
    
    sudo yum install tssh
    

  • Install with wlnmp repository. It's not necessary to configure the epel repository for tssh.

    curl -fsSL "https://sh.wlnmp.com/wlnmp.sh" | bash
    
    sudo yum install tssh
    

  </details>

• Install with yay on ArchLinux

  <details><summary><code>yay -S tssh</code></summary>

  yay -Syu
  yay -S tssh
  

  </details>

• Install with Go ( Requires go 1.21 or later )

  <details><summary><code>go install github.com/trzsz/trzsz-ssh/cmd/tssh@latest</code></summary>

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

  The binaries are usually located in ~/go/bin/ ( C:\Users\your_name\go\bin\ on Windows ).

  </details>

• Build from source ( Requires go 1.21 or later )

  <details><summary><code>sudo make install</code></summary>

  git clone --depth 1 https://github.com/trzsz/trzsz-ssh.git
  cd trzsz-ssh
  make
  sudo make install
  

  </details>

• Download from the GitHub Releases, unzip and add to PATH environment.

Development

The github.com/trzsz/trzsz-ssh/tssh can be used as a library, for example:

package main

import (
	"log"
	"os"

	"github.com/trzsz/trzsz-ssh/tssh"
)

func main() {
	// Example 1: execute command on remote server
	client, err := tssh.SshLogin(&tssh.SshArgs{Destination: "root@192.168.0.1"})
	if err != nil {
		log.Fatal(err)
	}
	defer client.Close()
	session, err := client.NewSession()
	if err != nil {
		log.Fatal(err)
	}
	defer session.Close()
	output, err := session.CombinedOutput("whoami")
	if err != nil {
		log.Fatal(err)
	}
	log.Printf("I'm %s", string(output))

	// Example 2: run the tssh program
	code := tssh.TsshMain([]string{"-t", "root@192.168.0.1", "bash -l"})
	os.Exit(code)
}

Contributing

Welcome and thank you for considering contributing. We appreciate all forms of support, from coding and testing to documentation and CI/CD improvements.

• Fork and clone the repository https://github.com/trzsz/trzsz-ssh.git.

• Make your changes just ensure that the unit tests go test ./tssh pass.

• Build the binary go build -o ./bin/ ./cmd/tssh and test it ./bin/tssh.

• Once you are happy with your changes, please submit a pull request.

Screenshot

Contact

Feel free to email the author lonnywong@qq.com, or create an issue. Welcome to join the QQ group: 318578930.

Sponsor

❤️ Sponsor trzsz ❤️, buy the author a drink 🍺 ? Thank you for your support!