https://github.com/isometry/ssh-scheme-handler
SSH Scheme Handler for FreeDesktop/XDG
https://github.com/isometry/ssh-scheme-handler
freedesktop gnome handler ssh tmux xdg
Last synced: 7 months ago
JSON representation
SSH Scheme Handler for FreeDesktop/XDG
- Host: GitHub
- URL: https://github.com/isometry/ssh-scheme-handler
- Owner: isometry
- License: mit
- Created: 2019-06-24T20:27:13.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-07-04T18:46:30.000Z (over 6 years ago)
- Last Synced: 2025-01-16T20:28:40.990Z (9 months ago)
- Topics: freedesktop, gnome, handler, ssh, tmux, xdg
- Language: Python
- Size: 4.88 KB
- Stars: 1
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://www.openssh.com/): `ssh://[user@]host[:port]`
* [mosh](https://mosh.org/): `mosh://[user@]host[:port]`
### Supported Terminal Emulators
* [gnome-terminal](https://wiki.gnome.org/Apps/Terminal): opens a new tab titled `[user]@host`
* [xfce4-terminal](https://docs.xfce.org/apps/terminal/): opens a new tab titled `[user]@host`
* [tmux](https://github.com/tmux/tmux): opens a new window named `[user]@host`
* [kitty](https://sw.kovidgoyal.net/kitty/): opens a new tab titled `[user]@host`; requires [remote control](https://sw.kovidgoyal.net/kitty/remote-control.html) be enabled
* [urxvt](http://software.schmorp.de/pkg/rxvt-unicode.html): opens a new window titled `[user]@host`
* [xterm](https://linux.die.net/man/1/xterm): opens a new window titled `[user]@host`
## Requirements
* A supported terminal emulator (`xfce4-terminal` recommended)
* [openssh-client](https://www.openssh.com/)
* [xdg-utils](https://www.freedesktop.org/wiki/Software/xdg-utils/)
## Installation
```sh
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).