Skip to content

isometry/ssh-scheme-handler

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 

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

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).