Skip to content

pkusgm1/driftnet

Repository files navigation

Driftnet

release version license IDE Refactored CircleCI codecov jProfiler

Driftnet watches network traffic, and picks out and displays JPEG, GIF and other image formats for display. It is a horrific invasion of privacy and shouldn't be used by anyone anywhere. It can also extract MPEG audio data from the network and play it. If you live in a house with thick walls, this may be a useful way to find out about your neighbours' musical taste.

News

Added new, http and websockets based, display
Added basic windows support (cygwin)
Added option to list capture interfaces
Added support for putting the interface in monitor mode

Dependencies

Unix

You will need:

On most Linux distributions (APT based) these can be installed by executing sudo apt-get install libpcap-dev libjpeg-dev libpng12-dev giflib-tools. If you don't want a version of driftnet which will display images itself, but just want to use it to gather images for some other application, you only need libpcap. See comments in the Makefile for more information. To play MPEG audio, you need an MPEG player. By default, driftnet will use mpg123.

Windows (on cygwin)

You will need:

Only 32 bits builds are supported (libwinpcap did not provide a x64 library). You should pass a x86 compiler to configure: ./configure --target=i686-pc-cygwin --host=i686-pc-cygwin

Compilation

To compile, generate the needed autotools files with autoreconf -fi (you probably need to install autotools) then run ./configure; make; make install. Driftnet is at a very early stage of development and probably won't work for you at all.

Usage

Driftnet needs to run with sufficient privilege to obtain raw packets from the network. On most systems, this means running it as root.

You can use Driftnet to sniff images passing over a wireless network. However, Driftnet does not understand the optional WEP encryption used with wireless ethernet. Instead, you can use Kismet to decrypt packets and pass them into a named pipe; the -f option can then be used to have Driftnet read the packets from the pipe. Thanks to Rob Timko and Joshua Wright for pointing this out; Rob's page describes the process in greater detail.

If you find this program entertaining, you might want to help me develop it. The TODO file contains a list of yet-to-be-done ideas.

Driftnet is licensed under the GNU GPL. See the file COPYING in the distribution.

Thanks

Support development

If you interested in this software (or other FOSS activities I do), get on board and become a Patron!