Repository navigation
v0.9.4
Borg 0.9.4 shows what talks on your network: open ports, connections and traffic per process, and packet captures you can read inside Borg.
New
- Network screen. Alt-N opens it from the System plugin, with four pages. Ports lists every listening port, its process and who can reach it. Processes ranks processes by download and upload rate, and the details chart the last 60 seconds and list the process's connections. Connections shows every connection with its process, remote host name, protocol, state and rates, and Interfaces shows addresses, rates, packet and error counts. The filter takes plain words and fields such as
port:443,proc:node,host:andstate:. Enter shows the row's process in the activity monitor, and Esc there brings you back to the network screen. Alt-N in the activity monitor opens the network screen on the selected process. - Capture traffic. R on the network screen records the selected row's packets with the installed
tcpdump: a port, one connection, a process, or the whole interface, for 5 to 60 seconds or until you press R again, whole packets or headers only. The capture is saved as a.pcapfile only you can read, in the panel's folder. - Traffic viewer. A finished capture opens with pages for processes, hosts, connections and packets. Hosts are named from the capture's DNS answers and TLS server names, Enter goes one level down and Esc steps back, and a packet shows its layers and a hex dump.
proto:dns,proto:tls,proto:httpandproto:quicfilter by what Borg recognized. F3 opens.pcap,.pcapngand.capfiles from the panels in the same viewer. - Capture as administrator. When tcpdump has no permission, Borg asks to capture as administrator and opens the system's own password dialog, so Borg never sees the password. On macOS such a capture listens through
pktap, and every packet carries the process that sent or received it, short-lived ones included. - Install tcpdump from Borg. A capture that finds no tcpdump offers the exact install command for apt, dnf, pacman, zypper, apk or Homebrew and types it at the shell prompt, so you see the output and answer the password prompt yourself. R works as soon as it finishes.
- Agents can capture traffic. An agent connected through
borg mcpcan ask for a capture with the newcapturetool. Borg asks you first, saves the.pcap, and gives the agent a summary of processes, hosts, connections and protocols without packet contents.readon a capture file gives the same summary. - Three new screensavers. Borg now picks one of five: the spinning cube, the glitching logo, a clock in the logo's block letters that tears apart as each minute turns, the logo swirling out into a spiral galaxy and back, or the logo rebuilt plank by plank while the old planks gather into a second logo.
Fixes
- Hotkeys work in Cyrillic layouts. With a Russian, Ukrainian or Belarusian layout on, Ctrl and Alt keys and the letter keys of screens and dialogs act as the US key in the same place. Ctrl-C reaches the shell again in terminals with the keyboard protocol. Questions also answer to the first letter of their buttons in Borg's language, such as Д and Н in Russian, and Y and N keep working.
- Pictures stay on screen after a resize of the terminal window in kitty-protocol terminals, in the viewer (F3) and the quick view (Ctrl-Q).
Updating
From 0.8.3 or later:
borg updateBorg 0.8.2 and earlier cannot download an update larger than 10 MiB. Install again instead:
curl -fsSL https://raw.githubusercontent.com/0xcd21h/borg-commander/main/scripts/install.sh | shHomebrew and Cargo installations should use their package manager. Restart Borg on both client and host after updating.
Downloads
Borg binaries are provided for Linux and macOS on x86_64 and ARM64. Linux Borg and relay binaries are static MUSL builds. Each archive has a SHA-256 checksum file.
The relay container image is ghcr.io/0xcd21h/borg-relay:0.9.4 for linux/amd64 and linux/arm64.