Skip to content

Commit 65a27e5

Browse files
binhduc1211binhduc1211
committed
Terminator SSH connection manager plugin
0 parents  commit 65a27e5

File tree

8 files changed

+1090
-0
lines changed

8 files changed

+1090
-0
lines changed

‎.gitignore‎

Lines changed: 147 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,147 @@
1+
# Byte-compiled / optimized / DLL files
2+
__pycache__/
3+
*.py[cod]
4+
*$py.class
5+
6+
# C extensions
7+
*.so
8+
9+
# Distribution / packaging
10+
.Python
11+
build/
12+
develop-eggs/
13+
dist/
14+
downloads/
15+
eggs/
16+
.eggs/
17+
lib/
18+
lib64/
19+
parts/
20+
sdist/
21+
var/
22+
wheels/
23+
pip-wheel-metadata/
24+
share/python-wheels/
25+
*.egg-info/
26+
.installed.cfg
27+
*.egg
28+
MANIFEST
29+
30+
# PyInstaller
31+
*.manifest
32+
*.spec
33+
34+
# Installer logs
35+
pip-log.txt
36+
pip-delete-this-directory.txt
37+
38+
# Unit test / coverage reports
39+
htmlcov/
40+
.tox/
41+
.nox/
42+
.coverage
43+
.coverage.*
44+
.cache
45+
nosetests.xml
46+
coverage.xml
47+
*.cover
48+
*.py,cover
49+
.hypothesis/
50+
.pytest_cache/
51+
52+
# Translations
53+
*.mo
54+
*.pot
55+
56+
# Django stuff:
57+
*.log
58+
local_settings.py
59+
db.sqlite3
60+
db.sqlite3-journal
61+
62+
# Flask stuff:
63+
instance/
64+
.webassets-cache
65+
66+
# Scrapy stuff:
67+
.scrapy
68+
69+
# Sphinx documentation
70+
docs/_build/
71+
72+
# PyBuilder
73+
target/
74+
75+
# Jupyter Notebook
76+
.ipynb_checkpoints
77+
78+
# IPython
79+
profile_default/
80+
ipython_config.py
81+
82+
# pyenv
83+
.python-version
84+
85+
# pipenv
86+
Pipfile.lock
87+
88+
# PEP 582
89+
__pypackages__/
90+
91+
# Celery stuff
92+
celerybeat-schedule
93+
celerybeat.pid
94+
95+
# SageMath parsed files
96+
*.sage.py
97+
98+
# Environments
99+
.env
100+
.venv
101+
env/
102+
venv/
103+
ENV/
104+
env.bak/
105+
venv.bak/
106+
107+
# Spyder project settings
108+
.spyderproject
109+
.spyproject
110+
111+
# Rope project settings
112+
.ropeproject
113+
114+
# mkdocs documentation
115+
/site
116+
117+
# mypy
118+
.mypy_cache/
119+
.dmypy.json
120+
dmypy.json
121+
122+
# Pyre type checker
123+
.pyre/
124+
125+
# IDEs
126+
.vscode/
127+
.idea/
128+
*.swp
129+
*.swo
130+
*~
131+
.DS_Store
132+
133+
# SSH Server configuration (user data)
134+
ssh_servers.json
135+
*.json
136+
137+
# Backup files
138+
*.bak
139+
*.backup
140+
*~
141+
142+
# Temporary files
143+
*.tmp
144+
*.temp
145+
146+
# Log files
147+
*.log

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
The MIT License (MIT)
2+
3+
Copyright (c) 2025 Daniel
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md‎

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
# Terminator SSH Manager
2+
3+
A beautiful SSH connection manager plugin for [Terminator](https://gnome-terminator.org/) terminal emulator.
4+
5+
![License](https://img.shields.io/badge/license-MIT-blue.svg)
6+
![Python](https://img.shields.io/badge/python-3.6+-blue.svg)
7+
8+
## Features
9+
10+
- 🔐 **Multiple Authentication**: SSH Key or Password authentication
11+
- 📋 **Server Management**: Add, edit, delete, and search servers
12+
- ⚡ **Quick Connect**: One-click connection to your servers
13+
- 🎨 **Native UI**: Clean interface using GTK Adwaita theme
14+
- 💾 **Local Storage**: All data stored locally in JSON format
15+
- 🔒 **100% Privacy**: No telemetry, no cloud sync, completely offline
16+
17+
## 🔒 Privacy & Security
18+
19+
**Your data stays on your machine.** This plugin:
20+
21+
- ✅ Stores all configurations locally in `~/.config/terminator/ssh_servers.json`
22+
- ✅ Never sends data to external servers
23+
- ✅ No analytics, no tracking, no telemetry
24+
- ✅ Open source - you can verify the code yourself
25+
26+
**Note**: Passwords are stored in plain text in the JSON file. For better security, use SSH key authentication instead.
27+
28+
## Installation
29+
30+
### Prerequisites
31+
32+
- Terminator terminal emulator
33+
- Python 3.6+
34+
- GTK 3.0 (usually pre-installed on Linux)
35+
36+
### Install Steps
37+
38+
1. **Download the plugin:**
39+
40+
```bash
41+
git clone https://github.com/binhduc1211/terminator-ssh-manager.git
42+
43+
mkdir -p ~/.config/terminator/plugins
44+
45+
cd ~/.config/terminator/plugins/
46+
47+
cp terminator-ssh-manager/ssh_manager.py ~/.config/terminator/plugins/
48+
49+
cp -r terminator-ssh-manager/ssh_manager_lib ~/.config/terminator/plugins/
50+
```
51+
52+
Or download and extract manually:
53+
54+
```bash
55+
mkdir -p ~/.config/terminator/plugins
56+
57+
cd ~/.config/terminator/plugins
58+
59+
cp terminator-ssh-manager/ssh_manager.py ~/.config/terminator/plugins/
60+
61+
cp -r terminator-ssh-manager/ssh_manager_lib ~/.config/terminator/plugins/
62+
```
63+
64+
2. **Enable the plugin in Terminator:**
65+
66+
- Right-click in Terminator → **Preferences**
67+
- Go to **Plugins** tab
68+
- Check ✓ **SSHManager**
69+
- Click **Close**
70+
71+
3. **Restart Terminator**
72+
73+
## Usage
74+
75+
### Open SSH Manager
76+
77+
Right-click in Terminator terminal → Select **SSH Manager**
78+
79+
### Add a Server
80+
81+
1. Click **Add Server**
82+
2. Fill in the form:
83+
- **Name**: Display name for your server
84+
- **Host**: IP address or hostname
85+
- **Port**: SSH port (default: 22)
86+
- **User**: SSH username
87+
- **Auth Type**: Choose SSH Key or Password
88+
- **SSH Key**: Browse to select key file (or leave empty for default `~/.ssh/id_rsa`)
89+
- **Password**: Enter your password for auto-login
90+
- **Description**: Optional notes
91+
3. Click **OK**
92+
93+
### Connect to Server
94+
95+
Click the **Connect** button next to any server to instantly connect.
96+
97+
### Edit or Delete
98+
99+
Use the **Edit** or **Delete** buttons to manage your servers.
100+
101+
## License
102+
103+
MIT License - feel free to use and modify.
104+
105+
## Author
106+
107+
Created with ❤️ for the Terminator community
108+
109+
---
110+
111+
**⭐ If you find this useful, please star the repository!**

‎ssh_manager.py‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
#!/usr/bin/env python3
2+
# -*- coding: utf-8 -*-
3+
"""
4+
Terminator SSH Manager Plugin - Main Entry Point
5+
File: ssh_manager.py
6+
Location: ~/.config/terminator/plugins/ssh_manager.py
7+
"""
8+
9+
import gi
10+
11+
gi.require_version("Gtk", "3.0")
12+
import terminatorlib.plugin as plugin
13+
from gi.repository import Gtk
14+
from ssh_manager_lib.dialogs import SSHManagerDialog
15+
from ssh_manager_lib.storage import ServerStorage
16+
from terminatorlib.translation import _
17+
18+
AVAILABLE = ["SSHManager"]
19+
20+
21+
class SSHManager(plugin.MenuItem):
22+
"""
23+
Main SSH Manager Plugin Class
24+
Adds SSH Manager menu item to Terminator's context menu
25+
"""
26+
27+
capabilities = ["terminal_menu"]
28+
29+
def __init__(self):
30+
plugin.MenuItem.__init__(self)
31+
self.storage = ServerStorage()
32+
33+
def callback(self, menuitems, menu, terminal):
34+
"""
35+
Add menu item to terminal context menu
36+
37+
Args:
38+
menuitems: List of menu items
39+
menu: The menu object
40+
terminal: Terminal instance
41+
"""
42+
item = Gtk.MenuItem.new_with_mnemonic(_("_SSH Manager"))
43+
item.connect("activate", self.open_manager, terminal)
44+
menuitems.append(item)
45+
46+
def open_manager(self, widget, terminal):
47+
"""
48+
Open SSH Manager dialog
49+
50+
Args:
51+
widget: The menu item widget
52+
terminal: Terminal instance
53+
"""
54+
dialog = SSHManagerDialog(self.storage, terminal)
55+
dialog.run()
56+
dialog.destroy()

‎ssh_manager_lib/__init__.py‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
#!/usr/bin/env python3
2+
# -*- coding: utf-8 -*-
3+
"""
4+
SSH Manager Library Package
5+
"""
6+
7+
__version__ = "1.0.0"
8+
__all__ = ["storage", "dialogs"]

0 commit comments

Comments
 (0)