Jatify Brimdock All Jatify projects

Brimdock

A screen-edge SSH dock — hover to reveal your servers, click to connect.

Code closed for now, until it’s finished. GitHub has the docs and signed releases.

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) or satellite (cards fan out around the handle).
  • Live reachability — a TCP check every 30s (configurable); unreachable servers are dimmed and unclickable.
  • Reads your ~/.ssh/config — set import_ssh_config = true and every Host block joins the dock. No duplicate list to maintain.
  • ProxyJump support — jump = "bastion" builds the ssh -J invocation for you.
  • Drag to either edge — grab the handle, drop it left or right; the choice persists.
  • Terminal of your choice — $TERMINAL, konsole, or x-terminal-emulator; optionally opens as a new konsole tab rather than a window.
  • Update notifications — on Arch it uses checkupdates to 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]]

KeyRequiredDefaultDescription
nameyes—Display label shown in the dock
hostyes—Hostname or IP address
userno—SSH user (omit to use your local username)
portno22SSH port
jumpno—ProxyJump host (ssh -J); matches another server’s name

Top-level keys

KeyDefaultDescription
import_ssh_configfalseMerge ~/.ssh/config Host blocks into the server list
terminal""Terminal emulator; blank → $TERMINAL → konsole → x-terminal-emulator
terminal_new_tabfalseOpen 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_y0Vertical position in px from the top of the screen (0 = centred)
check_interval30Seconds 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.toml with 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.