From 4c6a07f44d92eb8b50b5d3f922dd7cba4f6cf8eb Mon Sep 17 00:00:00 2001 From: terminaldweller Date: Wed, 4 Sep 2024 19:52:59 -0400 Subject: added key bindings for going up and down a page --- README.md | 37 ++++++++++++++++++++++++++++--------- 1 file changed, 28 insertions(+), 9 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 94a7fd4..d803ac6 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,30 @@ # tunneltop + A tunnel manager in the familiar top style written with ncurses and asyncio. ![Image](tunneltop.png) ## Install + ```sh -pip install tunneltop +pipx install tunneltop ``` ## what it is -* a simple tunnel manager written in python that uses the standard library only(standard library only in python 3.11) -* it starts and manages the tunnels for you -* lets the user interactively manage the tunnels as well -* will reload the config file if it receives a `SIGHUP` -* it is intentionally written as simple and tunnel-agnostic -* may or may not work on windows(let me know if you test it on windows) + +- a simple tunnel manager written in python that uses the standard library only(standard library only in python 3.11) +- it starts and manages the tunnels for you +- lets the user interactively manage the tunnels as well +- will reload the config file if it receives a `SIGHUP` +- it is intentionally written as simple and tunnel-agnostic +- may or may not work on windows(let me know if you test it on windows) ## toml file tunneltop expects its config file to be at at `$HOME/.tunneltoprc`. You can see an example config file below:
+ ```toml [color] header_fg = 4 @@ -62,40 +66,55 @@ auto_start = true The tunnel names must be unique.
### address + Displays the address at which the tunnel is available at. It is a display-only option.
### port + Displays the port at which the tunnel is available at. It is a display-only option.
### command + The command used to start the tunnel.
### test_command + The command used to test the state of the tunnel.
### test_command_result + The expected result of the test command.
### test_interval + How often should the `test_command` be run.
### test_timeout + How long before the test is considered to have timed out.
### auto_start -Whether to automatically start this tunnel on startup.
+ +Whether to automatically start this tunnel on startup.
## keybindings + `j` and `k` move you up and down.
`g` and `G`move you to the first or last tunnel.
`s` toggles a tunnel from enabled to disabled or vice versa.
-`r` restarts a tunnel.
+`r` restarts a tunnel.
`t` runs the test right now.
+`pgup` and `ctrl-b` move you up a page.
+ +`pgdown` and `ctrl-f` move you down a page.
+ +`ctrl-u` and `ctrl-d` move you up and down half a page respectively.
+ To quit send a `SIGINT` or a `SIGTERM`. I'm working on improving this of course.
tunneltop will reload its config file upon receiving a `SIGHUP` and apply the changes immediately if there are any.
-- cgit v1.2.3