README

Tunnels

Awesome Electron app to manage your ssh tunnels.

Keep a list of ssh tunnel to your remotes and open them all at once.

Tunnel edit window

Tunnels list window

Installation

OS X

Manually

Download, unzip, and move Tunnels.app to the /Applications directory.

Linux

Download and unzip to some location.

To add a shortcut to the app, create a file in ~/.local/share/applications called Tunnels.desktop with the following contents:

[Desktop Entry]
Name=Tunnels
Exec=/full/path/to/folder/Tunnels
Terminal=false
Type=Application
Icon=/full/path/to/folder/Tunnels/resources/app/media/IconTemplate.png

Windows

Download and unzip to some location.

NPM

Install the module globally:

npm install -g electron-tunnels

to start the app:

tunnels

Development

Setup environment

git clone https://github.com/parro-it/tunnels.git
cd tunnels
npm i
npm run rebuild
npm start

Lint your code

npm run lint

Run tests

npm test

some tests requires an account defined on freebsd.unixssh.com to run them, setup an account there, and then define UNIXSSH_USER and UNIXSSH_PWD environment variables before running tests. If these two env are not found, these tests are skipped.

Todo

[*] Package the app for Linux, OSX, Windows
Make the app autolunch at startup
Provide visual feedback when tunnels are opening
Save tunnel passwords in system keychain
Improve UI

Related modules

open-ssh-tunnel - Tunneling module at the core of this app
Caprine - Install instructions and scripts are copied from this app.

Credits

App icons come from Entypo icon set by Daniel Bruce

License

The MIT License (MIT)

Usage no npm install needed!