Skip to content

A minimal, fast GUI for quickly launching SSH sessions from your ~/.ssh/config.

License

Notifications You must be signed in to change notification settings

m-a-x-s-e-e-l-i-g/very-ssh

Repository files navigation

VerySSH - Windows SSH Launcher

Build License Python

A minimal, fast GUI for quickly launching SSH sessions from your ~/.ssh/config.
SSH keychain 🔑🔗
screenshots

🔧 Features

  • Parses ~/.ssh/config and lists all hosts
  • Click to connect via Windows Terminal (wt ssh <host>)
  • Auto light/dark mode based on Windows settings
  • Minimal, fast, and easy to use
  • Easy keyboard navigation

⌨️ Keyboard Shortcuts

Type to filter hosts

  • Arrow Up/Down: Navigate through the list of hosts
  • Enter: Connect to the selected host
  • Esc: Close the application
  • Delete: Clear the filter

🚀 How to Run

1. Download the latest release

Go to the Releases page and download the pre-built .exe file for your platform.

2. Run the executable

Simply double-click the downloaded .exe file to launch the application.


📦 Build Standalone .exe (Optional)

If you prefer to build the executable yourself, follow these steps:

1. Install Requirements

pip install -r requirements.txt

2. Build executable

Run the build script:

build.bat

Output will be in the dist/ folder.


📁 Project Structure

ssh_launcher/
├── __main__.py         # Entry point
├── config.py           # SSH config parsing
├── theme.py            # Windows theme detection
├── ui.py               # GUI logic
├── assets/
│   └── icon.ico        # Application icon
.github/
└── workflows/
    └── release.yml     # GitHub Actions workflow for releases
assets/
├── banner.png          # Banner image for documentation
├── icon.ai             # Editable icon source
└── icon.png            # Icon image
build.bat               # Build script for PyInstaller
launcher.py             # Launcher script for the standalone executable
README.md               # Project documentation
LICENSE                 # License file
requirements.txt        # Python dependencies

✅ Example SSH Config

Make sure your ~/.ssh/config has entries like:

Host my-server
    HostName 192.168.1.10
    User max

🤝 Contributing

Contributions are welcome! Please open an issue or submit a pull request. For major changes, discuss them first by opening an issue.

License

MIT. Do whatever the hell you want.

About

A minimal, fast GUI for quickly launching SSH sessions from your ~/.ssh/config.

Topics

Resources

License

Stars

Watchers

Forks