SSH Scheme Handler for freedesktop.org/XDG-compliant desktop environments

Overview

Handle ssh://[user@]host[:port] scheme links with your preferred terminal emulator in any freedesktop.org/XDG-compliant desktop environment, including Gnome, OpenBox, KDE & Xfce.

Supported Schemes

• ssh: ssh://[user@]host[:port]
• mosh: mosh://[user@]host[:port]

Supported Terminal Emulators

• gnome-terminal: opens a new tab titled [user]@host
• xfce4-terminal: opens a new tab titled [user]@host
• tmux: opens a new window named [user]@host
• kitty: opens a new tab titled [user]@host; requires remote control be enabled
• urxvt: opens a new window titled [user]@host
• xterm: opens a new window titled [user]@host

Requirements

• A supported terminal emulator (xfce4-terminal recommended)
• openssh-client
• xdg-utils

Installation

sudo make install
make activate

Configuration

By default, the handler will try to pick the first available terminal emulator from the TERMINAL_SEARCH_ORDER list in ssh-scheme-handler.py:

1. xfce4-terminal
2. gnome-terminal
3. urxvt
4. xterm

Alternatively, the terminal emulator may be explicitly specified by:

• either, adding the -t/--terminal argument to the Exec= line in ssh-scheme-handler.desktop, e.g. Exec=/usr/local/bin/ssh-scheme-handler %u -t tmux.
• or, setting the PREFERRED_TERMINAL_EMULATOR environment variable, e.g. echo export PREFERRED_TERMINAL_EMULATOR=tmux >> ~/.xsessionrc (Xorg restart required).