sshf

🚀 SSH Host Manager TUI
Gestor visual de hosts SSH multiplataforma, rápido y personalizable

---

✨ Características principales / Main Features

• 🔍 Búsqueda instantánea de hosts SSH desde ~/.ssh/config
• ➕ Agregar hosts fácilmente desde la TUI
• 🪄 Alias temporales con integración automática en la shell (Ctrl+A)
• 🎨 Temas claro/oscuro y soporte multilenguaje (🇪🇸/🇬🇧)
• 🐚 Integración automática con zsh, bash y fish
• 🧠 Barra de búsqueda avanzada: historial (Ctrl+↑/↓), autocompletado (Tab), borrado rápido (Ctrl+U), borrado de palabra (Ctrl+W), escape inteligente
• 🖱️ Navegación intuitiva con teclado
• ⚡ Empaquetado nativo para Linux, macOS y Windows

EN:

• 🔍 Instant search for SSH hosts from ~/.ssh/config
• ➕ Add hosts easily from the TUI
• 🪄 Temporary aliases with automatic shell integration (Ctrl+A)
• 🎨 Light/dark themes and multi-language support (en/es)
• 🐚 Automatic integration with zsh, bash, and fish
• 🧠 Advanced search bar: history (Ctrl+↑/↓), autocomplete (Tab), quick clear (Ctrl+U), word delete (Ctrl+W), smart escape
• 🖱️ Intuitive keyboard navigation
• ⚡ Native packaging for Linux, macOS, and Windows

---

🖥️ Compatibilidad / Compatibility

Sistema Operativo	Método recomendado	Estado
Arch Linux	Pacman / makepkg	✅ Stable
Debian/Ubuntu	.deb	✅ Stable
Fedora	DNF / .rpm	✅ Stable
macOS	Homebrew	✅ Stable
Windows	Scoop	✅ Stable
Universal	Cargo (Rust)	✅ Stable

EN:

• Fully cross-platform: Linux (Arch, Debian, Fedora), macOS, Windows, and any system with Rust.
• Native packages and manual installation supported.

---

⚙️ Instalación rápida / Quick install

🏴‍☠️ Arch Linux (Pacman/makepkg)

git clone https://github.com/Rooterts/sshf.git
cd sshf
makepkg -si

🐧 Debian/Ubuntu (.deb)

git clone https://github.com/Rooterts/sshf.git
cd sshf
sudo apt install cargo rustc debhelper
# Empaquetar y generar .deb
cp debian.control debian/control
cp debian.rules debian/rules
cp debian.install debian/install
chmod +x debian/rules
cargo build --release
dpkg-buildpackage -us -uc -b
sudo dpkg -i ../sshf_1.0.0_amd64.deb

🎩 Fedora (DNF/.rpm)

git clone https://github.com/Rooterts/sshf.git
cd sshf
sudo dnf install cargo rustc rpm-build
# Empaquetar y generar .rpm
cargo build --release
rpmbuild -bb sshf.spec
sudo rpm -i ~/rpmbuild/RPMS/x86_64/sshf-1.0.0-1.x86_64.rpm

🍏 macOS (Homebrew)

brew tap Rooterts/sshf
brew install sshf

🪟 Windows (Scoop)

scoop bucket add sshf https://github.com/Rooterts/sshf
scoop install sshf

🌐 Universal (any system with Rust)

cargo install --git https://github.com/Rooterts/sshf

EN:

• See each section for the recommended installation method for your OS.
• All packages can be built locally from source if desired.

---

📦 Empaquetado y distribución / Packaging & Distribution

• Arch Linux: Incluye PKGBUILD para makepkg y AUR.
• Debian/Ubuntu: Carpeta debian/ lista para dpkg-buildpackage.
• Fedora: Archivo sshf.spec para rpmbuild.
• macOS: Fórmula sshf-homebrew.rb para Homebrew.
• Windows: Manifiesto sshf-scoop.json para Scoop.
• Automatización: Usa make dist para generar todos los paquetes desde el código fuente.

Nota: sshf aún no está publicado en los repositorios oficiales de cada sistema (AUR, Homebrew, Scoop, etc.). Puedes instalarlo fácilmente siguiendo los pasos de este README, pero la instalación directa desde los gestores de paquetes estará disponible cuando se complete la publicación oficial. ¡Contribuciones y sugerencias para facilitar la publicación son bienvenidas!

EN:

• All packaging scripts are included for each platform. Official repository publication is pending. Manual/local installation is fully supported.

---

🛠️ Uso rápido / Quick usage

sshf                # Abre la interfaz TUI / Open the TUI interface
sshf install        # Instala la integración automática con la shell / Install shell integration
sshf usuario@host   # Conecta directamente usando sshf como wrapper / Connect directly using sshf as a wrapper
sshf --help         # Muestra la ayuda (en tu idioma configurado) / Show help (in your configured language)

---

⚙️ Configuración / Configuration

Edita / Edit ~/.config/sshf/config.toml para idioma y tema / to set language and theme:

lang = "es"   # o "en" / or "en"
theme = "dark" # o "light" / or "light"

---

🧠 Atajos y controles / Shortcuts & Controls

• / o escribir: enfoca la barra de búsqueda / focus search bar
• Ctrl+U: borra todo el input / clear all input
• Ctrl+W: borra la última palabra / delete last word
• Ctrl+↑/↓: historial de búsquedas / search history
• Tab: autocompleta / autocomplete
• Esc: limpia input o sale / clear input or exit
• Enter: conecta o agrega host / connect or add host
• Ctrl+A: crea alias temporal / create temporary alias
• ↑/↓: navega la lista / navigate list

---

💡 Notas importantes / Important notes

• Tras crear un alias temporal, ejecuta source ~/.zshrc (o el equivalente para tu shell) para activarlo en tu terminal actual. La recarga automática solo afecta a subshells.
• El wrapper de shell respeta el comando original de ssh: si ejecutas ssh sin argumentos, se comporta como el ssh estándar.
• Para soporte, sugerencias o reportar bugs, visita el repositorio en GitHub.

EN:

• After creating a temporary alias, run source ~/.zshrc (or your shell's equivalent) to activate it in your current terminal. Automatic reload only affects subshells.
• The shell wrapper respects the original ssh command: if you run ssh with no arguments, it behaves as standard ssh.
• For support, suggestions or bug reports, visit the GitHub repository.

---

📝 License

MIT

---

sshf - SSH Host Manager TUI · GitHub