A screen-edge SSH dock for KDE on Wayland.
A handle tucks itself against the edge of your screen. Hover or tap it and your servers slide out; click a reachable one and an SSH session opens in your terminal. Servers that fail their TCP check are dimmed and won’t launch, so you never open a terminal onto a box that’s down.
It lives in the system tray and has a Settings page, so adding a server never means opening a config file — though you can, and comments survive the round trip.
Try it
▸ Interactive demo — hover the dock at the right edge. You can reveal the servers, switch between the stacked and satellite layouts, click a server to open a terminal, and drag the dock to either edge.
It’s a faithful browser recreation of the interface, not the app itself — the real thing is a native Wayland client.
Features
- Two layouts —
stacked(a vertical column of cards) orsatellite(cards fan out around the handle). - Live reachability — a TCP check every 30s (configurable); unreachable servers are dimmed and unclickable.
- Reads your
~/.ssh/config— setimport_ssh_config = trueand everyHostblock joins the dock. No duplicate list to maintain. - ProxyJump support —
jump = "bastion"builds thessh -Jinvocation for you. - Drag to either edge — grab the handle, drop it left or right; the choice persists.
- Terminal of your choice —
$TERMINAL, konsole, orx-terminal-emulator; optionally opens as a new konsole tab rather than a window. - Update notifications — on Arch it uses
checkupdatesto notice a newer build in your repo and posts a tray notification. No configuration.
Install
Download the package for your distribution from the Releases page, then:
# Arch
sudo pacman -U brimdock-*.pkg.tar.zst
# Debian / Ubuntu
sudo dpkg -i brimdock_*.deb
# Fedora
sudo dnf install ./brimdock-*.rpm
Verify what you downloaded
Every release is signed. SHA256SUMS covers the packages, and SHA256SUMS.asc
is a clearsigned copy of it, so checking the signature and then the checksums
is enough to trust all four files.
gpg --import brimdock.pub # published with every release
gpg --verify SHA256SUMS.asc # expect: Good signature from "Brimdock CI"
sha256sum -c SHA256SUMS
Each artifact also ships its own detached .asc if you’d rather check one
directly: gpg --verify brimdock-0.1.0-1-any.pkg.tar.zst.asc brimdock-0.1.0-1-any.pkg.tar.zst.
The signing key fingerprint is 8744 797A 38D9 DE8A D16B 123F 9637 9513 402C 4571.
Then create your config:
mkdir -p ~/.config/brimdock
cp /usr/share/doc/brimdock/config.example.toml ~/.config/brimdock/config.toml
chmod 600 ~/.config/brimdock/config.toml
Add [[servers]] entries or set import_ssh_config = true, and run brimdock.
It autostarts on login (toggle in KDE → Autostart) and appears in the system
tray: Show/Hide · Settings… · Layout · Quit.
Requirements
KDE Plasma 6 on Wayland (kwin). All dependencies are official distribution
packages and are pulled in by the package: pyside6, python-tomlkit,
qt6-wayland, qt6-svg, layer-shell-qt, openssh.
Configuration
~/.config/brimdock/config.toml. A commented reference ships as
config.example.toml.
TOML gotcha: every top-level key must appear before the first
[[servers]]block. A bare key written after an array-of-tables belongs to that table, not the document root.
[[servers]]
| Key | Required | Default | Description |
|---|---|---|---|
name | yes | — | Display label shown in the dock |
host | yes | — | Hostname or IP address |
user | no | — | SSH user (omit to use your local username) |
port | no | 22 | SSH port |
jump | no | — | ProxyJump host (ssh -J); matches another server’s name |
Top-level keys
| Key | Default | Description |
|---|---|---|
import_ssh_config | false | Merge ~/.ssh/config Host blocks into the server list |
terminal | "" | Terminal emulator; blank → $TERMINAL → konsole → x-terminal-emulator |
terminal_new_tab | false | Open SSH in a new konsole tab instead of a window (no-op elsewhere) |
edge | "right" | Screen edge: "left" or "right" |
layout | "stacked" | "stacked" or "satellite" |
dock_y | 0 | Vertical position in px from the top of the screen (0 = centred) |
check_interval | 30 | Seconds between TCP reachability checks |
update_url | "" | Override the Arch-native update check with a plain-text VERSION URL |
Usage
- Reveal — hover over or tap the handle at the screen edge.
- Connect — click a server card. Brimdock runs
ssh [user@]host [-p port] [-J jump]in your terminal. - Move the dock — drag the handle to the left or right edge; the choice is saved to your config.
- Tray menu — Show/Hide, Settings…, Layout (switch stacked ↔ satellite), Quit.
- Settings page — add, edit and remove servers and adjust appearance;
changes are written back to
config.tomlwith your comments preserved.
Updating
Brimdock can’t modify its own root-owned files, so it only notifies you. Install updates through your package manager, or download the newer package from Releases.
Source
Brimdock is source-available, not open source.
The release packages contain the Python and QML source, and so does the release tarball. That is unavoidable for a PySide6 application — the interpreter needs the source to run it — and the tarball is what the AUR package builds from. Being able to read it grants you no rights over it: you may run it under the terms in LICENSE, and nothing else. Redistribution, modification and derivative works are not permitted. See sections 3 and 4.2 in particular.
If you want to use any of this in your own project, ask — the address is at the bottom of the licence.
This repository carries the documentation and the release downloads.
Bug reports and feature requests are welcome in Issues — please include your distribution, Plasma version, and whether you’re on Wayland or X11.
License
Copyright © 2026 Alexandru Martalogu. All rights reserved.
Brimdock is proprietary software, licensed for personal use under the terms in LICENSE. It is not open source, and no licence to the source code is granted beyond the rights that document sets out.
The packages contain Python source as a consequence of the language; that is not a publication of the source, and does not place it under any open source licence. See section 4.2 of the licence.