SSH-Desktop-remote

README

SSH-Desktop-remote

This is a small but effective tool to control the keyboard and mouse of a linux desktop environment via SSH. It uses x11lib as library for the input, translates this into xdotool commands and executes them on a remote machine. This allows you to move your mouse and keyboard input to an other machine.

Installation/Requirements

You need to install go and libx11-dev. You can install it with

apt install -y libx11-dev

(It was developed using go1.13 so if you have trouble building it, try to use go1.13) If this is installed successfully you can compile this tool with:

go get
go build -o remoteSSH

In addition you need to install xdotool on the remote machine if it isn't already installed.

apt install xdotool -y

Usage

./remoteSSH -r user@host                    # opens keyboard remote only
./remoteSSH -r user@host -m                 # opens mouse and keyboard remote
./remoteSSH -r user@host -m -i key -p 123   # opens remote with ssh privatekey auth on port 123

• If the port is not 22 you can add ':port' to the hostname-argument
  
• If you press the '`' key you can choose to which machine the input should be send (use the host or remote machine). By activating the remotemachine again you have to press return additionally! You can turn off this switch-feature by adding the -t=false argument in case you need the grave key or don't want to switch.
• Note: To exit this program you need to press the right control key. ('Strg' or 'Control' at the right side of the spacebar)
• If unclutter is installed, the mouse will automatically disappear if it controls the remote machine. You can turn this off with -e

Features

• SSH
  • SSH password auth
  • Privatekey auth (only without passphrase)
  • SSHAgent auth
  • Knownhost check/handling
• Keyboard
  • Full keyboard support!
• Mouse
  • Full mouse support!