Skip to content

Repository files navigation

SSH Manager for Omarchy

Português

Omarchy Quickshell plugin that reads SSH aliases from ~/.ssh/config and opens a terminal running ssh when a server is selected.

SSH Manager dashboard

Install

From GitHub:

omarchy plugin add https://github.com/luizeof/omarchy-sshmanager-plugin.git --enable

From a local checkout:

./install.sh

Open it with:

omarchy-shell shell summon io.github.luizeof.omarchy-sshmanager '{}'

The installer places the terminal icon  in the left side of the Omarchy bar. Click it for the server list: Dashboard is first and Add server is last, separated from the hosts.

Configuration and languages

The installer creates ~/.config/omarchy/sshmanager.json. English is the default. Set locale to pt-BR to use Brazilian Portuguese:

{
  "locale": "en",
  "sshConfig": "~/.ssh/config",
  "knownHosts": "~/.ssh/known_hosts",
  "includeKnownHosts": true,
  "defaultUser": "",
  "terminal": "omarchy-launch-terminal",
  "sshOptions": [],
  "showWildcards": false
}
  • sshConfig: SSH configuration file to list.
  • knownHosts: optional known_hosts source.
  • includeKnownHosts: includes known hosts not already defined in SSH config.
  • defaultUser: passed through ssh -l when set.
  • terminal: terminal launcher; defaults to omarchy-launch-terminal.
  • sshOptions: extra SSH options, such as ["-A"].
  • showWildcards: include SSH entries such as Host *.

The plugin preserves SSH options such as User, Port, and IdentityFile by connecting through the original alias.

Requirements and privacy

Requires Omarchy/Quickshell, ssh, bash, awk, and jq. It reads only the configured local files and launches the selected SSH client. It does not store passwords or send host lists to external services.

Development

omarchy plugin validate .
qmllint -I "$OMARCHY_PATH/shell" BarWidget.qml Panel.qml

It follows Omarchy's bar-widget pattern: BarWidget.qml is the only declared entry point and loads Panel.qml internally. The popup is anchored to the icon and closes with Esc or an outside click.

Removal

omarchy plugin remove io.github.luizeof.omarchy-sshmanager

This removes the bar plugin but leaves SSH files and ~/.config/omarchy/sshmanager.json untouched.

Publishing

The public repository includes a root manifest, README, MIT license, safe installation/removal instructions, and a preview. Validate a clean checkout and tag the manifest version before submitting it to the marketplace.


Português

English

Plugin Quickshell para Omarchy que lê aliases de SSH em ~/.ssh/config e abre um terminal executando ssh ao selecionar um servidor.

Instalação

Pelo GitHub:

omarchy plugin add https://github.com/luizeof/omarchy-sshmanager-plugin.git --enable

Em um checkout local:

./install.sh

Para abrir:

omarchy-shell shell summon io.github.luizeof.omarchy-sshmanager '{}'

O instalador posiciona o ícone de terminal  no lado esquerdo da barra. Clique nele para listar servidores: Dashboard é o primeiro item e Adicionar servidor é o último, separado dos hosts.

Configuração e idiomas

O instalador cria ~/.config/omarchy/sshmanager.json. O inglês é o padrão. Para usar português brasileiro, defina "locale": "pt-BR":

{
  "locale": "pt-BR"
}

As demais opções são as mesmas da seção em inglês: sshConfig, knownHosts, includeKnownHosts, defaultUser, terminal, sshOptions e showWildcards.

Dependências, privacidade e remoção

Requer Omarchy/Quickshell, ssh, bash, awk e jq. O plugin lê somente arquivos locais configurados, não guarda senhas e não envia a lista de hosts a serviços externos.

omarchy plugin remove io.github.luizeof.omarchy-sshmanager

A remoção não apaga os arquivos SSH nem ~/.config/omarchy/sshmanager.json.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages