somo 1.1.0

A human-friendly alternative to netstat for socket and port monitoring on Linux and macOS.
somo-1.1.0 is not a library.
Visit the last successful build: somo-1.3.3

A human-friendly alternative to netstat for socket and port monitoring on Linux and macOS.

[!NOTE]
The master branch code and readme may include features that are not yet released. For the official, stable version and its documentation, please refer to the crates.io page.

✨ Highlights:

  • pleasing to the eye thanks to a nice table view
  • filterable and sortable output
  • interactive killing of processes
  • JSON and custom formattable output
  • from netstat -tulpn to somo -l
  • cross-platform support for Linux and macOS
  • you can find all features further down

⬇️ Installation:

Option 1 - Debian:

If you use a Debian OS go to releases and download the latest .deb release.

Option 2 - crates.io:

cargo install somo

Most of the time you will want to run this in sudo mode to see all processes and ports. By default, this is not possible when installed via cargo. But you can create a symlink so the binary can be run as root:

sudo ln -s ~/.cargo/bin/somo /usr/local/bin/somo
sudo somo   # this works now

Option 3 - GitHub (Development Version):

Warning: This is the cutting-edge development version and may be unstable or contain incomplete features. You can install it via cargo directly from the GitHub repository.

cargo install --git https://github.com/theopfr/somo

Option 4 - Nix (Development Version):

You can build and use the development version using Nix with Flakes.

nix build 'github:theopfr/somo?dir=nix'
sudo ./result/bin/somo

🏃‍♀️ Running somo:

To run somo just type:

sudo somo

Somo supports the following features:

✨ Filtering:

You can use the following flags to filter based on different attributes:

filter flag description value
--tcp, -t filter by TCP connections -
--udp, -u filter by UDP connections -
--proto deprecated – use --tcp / --udp instead tcp or udp
--port, -p filter by a local port port number, e.g 5433
--remote-port filter by a remote port port number, e.g 443
--ip filter by a remote IP IP address e.g 0.0.0.0
--program filter by a client program program name e.g chrome
--pid filter by a PID PID number, e.g 10000
--open, -o filter by open connections -
--listen, -l filter by listening connections -
--exclude-ipv6 don't list IPv6 connections -

✨ Compact table view:

To get a smaller, more compact table use the --compact, -c flag.

✨ Process killing:

With the --kill, -k flag you can choose to kill a process after inspecting the connections using an interactive selection option.

✨ JSON and custom output format:

Using the --json flag you can choose to retrieve the connection data in JSON format. You can also define a custom output format using the --format flag, for example:

somo --format "PID: {{pid}}, Protocol: {{proto}}, Remote Address: {{remote_address}}" # attributes must be specified in snake_case

In the format-string, the attributes have to be specified in snake_case.

✨ Sorting by columns:

The --sort, -s flag can be used to sort the table after a specific column ascending. For example:

somo --sort pid   # column names must be specified in snake_case

To get a descending order, you can use the --reverse, -r flag.

🐚 Shell Completions:

Somo supports shell completions for bash, zsh, fish, and elvish. Choose your shell:

Bash

mkdir -p ~/.local/share/bash-completion/completions
somo generate-completions bash > ~/.local/share/bash-completion/completions/somo

Zsh

mkdir -p ~/.local/share/zsh/site-functions
somo generate-completions zsh > ~/.local/share/zsh/site-functions/_somo
echo 'fpath=(~/.local/share/zsh/site-functions $fpath)' >> ~/.zshrc
echo 'autoload -U compinit && compinit' >> ~/.zshrc

Fish

mkdir -p ~/.config/fish/completions
somo generate-completions fish > ~/.config/fish/completions/somo.fish

Elvish

mkdir -p ~/.config/elvish/lib
somo generate-completions elvish > ~/.config/elvish/lib/somo.elv
echo 'use somo' >> ~/.config/elvish/rc.elv

🖥️ Platform Support:

Somo currently supports: