https://github.com/m-a-x-s-e-e-l-i-g/very-ssh

A minimal, fast GUI for quickly launching SSH sessions from your ~/.ssh/config.
https://github.com/m-a-x-s-e-e-l-i-g/very-ssh

keychain ssh ssh-config

Last synced: 9 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/m-a-x-s-e-e-l-i-g/very-ssh
• Owner: m-a-x-s-e-e-l-i-g
• License: mit
• Created: 2025-03-26T10:57:21.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-24T15:38:45.000Z (about 1 year ago)
• Last Synced: 2025-04-24T16:48:57.885Z (about 1 year ago)
• Topics: keychain, ssh, ssh-config
• Language: Python
• Homepage:
• Size: 522 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# VerySSH - Windows SSH Launcher

![Build](https://img.shields.io/github/actions/workflow/status/m-a-x-s-e-e-l-i-g/very-ssh/release.yml)

![License](https://img.shields.io/github/license/m-a-x-s-e-e-l-i-g/very-ssh)

![Python](https://img.shields.io/badge/python-3.11%2B-blue)

[![Download VerySSH](https://img.shields.io/sourceforge/dt/very-ssh.svg)](https://sourceforge.net/projects/very-ssh/files/latest/download)

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

SSH keychain 🔑🔗  

![screenshots](assets/banner.png)

---

[![Download VerySSH](https://a.fsdn.com/con/app/sf-download-button)](https://sourceforge.net/projects/very-ssh/files/latest/download)

## 🔧 Features

- Parses `~/.ssh/config` and lists all hosts

- Click to connect via Windows Terminal (`wt ssh `)

- 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](https://github.com/your-repo/very-ssh/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

```bash

pip install -r requirements.txt

```

### 2. Build executable

Run the build script:

```bash

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:

```ssh

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](./LICENSE). Do whatever the hell you want.