Skip to content

Latest commit

 

History

History
99 lines (71 loc) · 5.47 KB

README.md

File metadata and controls

99 lines (71 loc) · 5.47 KB

Driftnet

release version license IDE Refactored CircleCI codecov jProfiler FOSSA Status

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 option to delay between reading packets from dump file
Deprecate GTK2
Migrate display to GKT3 (GTK2 still supported)
Added WebP image format support
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 libpng-dev libgif-dev libwebp-dev. 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.

GTK display

Driftnet links by default against GTK 3 (GTK2 is still supported disabling GTK3 in the configure script ./configure --disable-gtk3).

  • GTK3 dependencies: sudo apt-get install libgtk-3-dev
  • GTK2 dependencies: sudo apt-get install libgtk2.0-dev

HTTP display

Instead of the GTK interface you can use a new HTML based one (the display could be selected at launch time).

Dependencies: sudo apt-get install libwebsockets-dev

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.

License

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!