From 2a200b155722cc2bf1fc768943dc21308af602f5 Mon Sep 17 00:00:00 2001 From: Digital Studium Date: Sun, 26 May 2024 10:58:20 +0300 Subject: [PATCH] Add readme --- 1 | 34 ++++++++++++++++++++++++++++++++++ README.md | 35 +++++++++++++++++++++++++++++++++++ 2 files changed, 69 insertions(+) create mode 100644 1 create mode 100644 README.md diff --git a/1 b/1 new file mode 100644 index 0000000..cc7d54c --- /dev/null +++ b/1 @@ -0,0 +1,34 @@ +# SSHTUI + +## Description +`sshtui` is a cli tool based on `ssh` for managing ssh connecctions via terminal. +Inspired by `lf` and `ranger` file managers, written in python curses. + +It is lightweight (~250 lines of code) and easy to customize. +Supports mouse navigation as well as keyboard navigation. + +## Key bindings +### For ssh +You can customize these bindings or add extra bindings in `KEY_BINDINGS` variable of `sshtui` in a row #6: +- `Enter` - connect to host + +### Other: +- letters - enter filter mode and apply filter +- `Escape` - exit filter mode or `sshtui` itself +- `Backspace` - remove letter from filter +- arrow keys, `PgUp`, `PgDn`, `Home`, `End` - navigation + + +## Dependencies +- `python3` + +## Installation +Download latest `sshtui`: +``` +curl -O "https://git.digitalstudium.com/digitalstudium/sshtui/raw/branch/main/sshtui" +``` +Then install it: +``` +sudo install ./sshtui /usr/local/bin/ +``` + diff --git a/README.md b/README.md new file mode 100644 index 0000000..6a26191 --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ +# SSHTUI + +## Description +`sshtui` is a cli tool based on `ssh` for managing ssh connecctions via terminal. +Inspired by `lf` and `ranger` file managers, written in python curses. + +It is lightweight (~250 lines of code) and easy to customize. +Supports mouse navigation as well as keyboard navigation. + +## Key bindings +### For ssh +You can customize these bindings or add extra bindings in `KEY_BINDINGS` variable of `sshtui` in a row #6: +- `Enter` - connect to host + +### Other: +- letters - enter filter mode and apply filter +- `Escape` - exit filter mode or `sshtui` itself +- `Backspace` - remove letter from filter +- arrow keys, `PgUp`, `PgDn`, `Home`, `End` - navigation + + +## Dependencies +- `python3` +- `~/.ssh/config` file created with hosts inside it + +## Installation +Download latest `sshtui`: +``` +curl -O "https://git.digitalstudium.com/digitalstudium/sshtui/raw/branch/main/sshtui" +``` +Then install it: +``` +sudo install ./sshtui /usr/local/bin/ +``` +