electron-tunnels

Electron app to manage your ssh tunnels

Usage no npm install needed!

<script type="module">
  import electronTunnels from 'https://cdn.skypack.dev/electron-tunnels';
</script>

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.

Travis Build Status NPM module NPM downloads

Tunnel edit window

image

Tunnels list window

image

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

License

The MIT License (MIT)

Copyright (c) 2015 Andrea Parodi