stumpwm.stumpwm-contrib/util/swm-ssh/README.org
Kirill A. Korinsky 46c3ef3cf1
Introduce *swm-ssh-default-term-title-opt*
`-T` looks a universal option for `xterm` and `urxvtc`, but `sakura`
requries `-t` (or `--title`) for example.
2025-05-25 20:56:09 +02:00

48 lines
1.2 KiB
Org Mode

* Requirements
- cl-ppcre
Install cl-ppcre from the REPL:
#+BEGIN_SRC lisp
(ql:quickload :cl-ppcre)
#+END_SRC
* Usage
This simple plugin parses your ssh config file and opens a connection using a
teminal emulator.
Put the following in your =~/.stumpwmrc=
#+BEGIN_SRC lisp
(load-module "swm-ssh")
#+END_SRC
And use it either by calling the appropriate function directly (~swm-ssh-menu~)
or by defining a keybind (example =<prefix> C-a=) in your =~/.stumpwmrc=
#+BEGIN_SRC lisp
(define-key *root-map* (kbd "C-a") "swm-ssh-menu")
#+END_SRC
* Variables
** *swm-ssh-default-term*
Default terminal to open an ssh connection is ~urxvtc~. To change it, use
#+BEGIN_SRC lisp
(setq swm-ssh:*swm-ssh-default-term* "xterm")
#+END_SRC
** *swm-ssh-default-term-title-opt*
Default terminal's title option is ~-T~ which is used to setup title to
a connection host. It works with both ~xterm~ and ~urxvtc~ out of the
box. ~nil~ disable it. To change it, use
#+BEGIN_SRC lisp
(setq swm-ssh:*swm-ssh-default-termt-itle-opt* "--title")
#+END_SRC
** *swm-ssh-known-host-path*
Path to thee list of know host bz SSH client. Defaults to =~/.ssh/known_hosts=.
Change it with
#+BEGIN_SRC lisp
(setq swm-ssh:*swm-ssh-known-hosts-path* "/path/to/ssh/known_hosts")
#+END_SRC