from GitHub releases 

You can install Sniffnet through the installers available in the latest release.
Choose from a Windows installer, a macOS disk image, or a DEB package (depending on your operating system).
Here for your convenience you can find the direct link to the downloads: - Windows (8.4 MB) - macOS (6.9 MB) - Linux (.deb) (5.3 MB)

from Crates.io 

Follow this method only if you have Rust installed on your machine.
In this case, the application binary can be installed with:

sh cargo install sniffnet

You can install Sniffnet Homebrew package with:

sh brew install sniffnet

Windows dependencies 

In order to correctly run Sniffnet on Windows systems you need to:

• Install Npcap.

• Download the Npcap SDK.

• Add the SDK's /Lib or /Lib/x64 folder to your LIB environment variable.

Linux dependencies 

In order to correctly run Sniffnet on Linux systems, install the libraries and header files for the libpcap library:

sh sudo apt-get install libpcap-dev

Note that if you are not running as root, you need to set capabilities to inspect a network adapter:

sh sudo setcap cap_net_raw,cap_net_admin=eip <your/Sniffnet/executable/path>

Most Linux system also need this dependency (required to build the library used to play sounds):

sh sudo apt-get install libasound2-dev

Depending on your Linux environment you may also need libfontconfig:

sh sudo apt-get install libfontconfig libfontconfig1-dev

MacOS dependencies 

MacOS natively has all the dependencies you need to build and run Sniffnet!

Geolocation refers to the remote IP address of the connection, and it's performed against a MMDB file:

The MMDB (MaxMind database) format has been developed especially for IP lookup.
It is optimized to perform lookups on data indexed by IP network ranges quickly and efficiently.
It permits the best performance on IP lookups, and it's suitable for use in a production environment.

This product includes GeoLite2 data created by MaxMind, available from https://www.maxmind.com

This format potentially allows Sniffnet to execute different hundreds of IP lookups in a matter of a few milliseconds.

Sometimes it is not possible to determine the location of an IP address (in this case the country will be marked as ?); this is most likely due to the address being a private IP address.

Application layer protocols are inferred from the transport port numbers, following the convention maintained by IANA.

Please, remember that this is just a convention:

The Internet Assigned Numbers Authority (IANA) is responsible for maintaining the official assignments of port numbers for specific uses.
However, many unofficial uses of well-known port numbers occur in practice.

The following table reports the port-to-service mappings used by Sniffnet, chosen from the most common assignments by IANA.

Some keyboard shortcuts are available to improve the efficiency of use and the overall user experience.

If you want to suggest a different key combination for one of the existing shortcuts or if you want to propose a new shortcut, give a look at this issue.

The currently usable hotkeys are reported in the following:

Missing dependencies

Most of the errors that can occur are likely due to your system missing required pcap dependencies, necessary to correctly analyze a network adapter.
Check the required dependencies section for instructions on how to proceed.

For a Windows reference, you can check issue #1.

Note that most Linux system also need this dependency (required to build the library used to play sounds):

sh sudo apt-get install libasound2-dev

Some Linux systems also need libfontconfig, see issue #18 for a reference.

Installers incompatibilities

If you have problems after having installed Sniffnet through the provided installers, it could be due to your OS not being compatible with the pre-built binaries I generated for you.
Reach me out, and I'll try to generate an installer for your specific operating system.

In any case don't hesitate to open an issue, and I will do my best to help you!