Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/deiv/driftnet
Driftnet watches network traffic, and picks out and displays JPEG and GIF images for display
https://github.com/deiv/driftnet
driftnet network sniffer
Last synced: 12 days ago
JSON representation
Driftnet watches network traffic, and picks out and displays JPEG and GIF images for display
- Host: GitHub
- URL: https://github.com/deiv/driftnet
- Owner: deiv
- License: gpl-2.0
- Created: 2012-07-17T13:18:51.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2024-04-20T18:55:11.000Z (7 months ago)
- Last Synced: 2024-08-09T13:21:35.584Z (3 months ago)
- Topics: driftnet, network, sniffer
- Language: C
- Homepage:
- Size: 6.15 MB
- Stars: 435
- Watchers: 13
- Forks: 54
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog
- License: COPYING
Awesome Lists containing this project
- StarryDivineSky - deiv/driftnet
README
Driftnet
========
[](https://github.com/deiv/driftnet/releases)
[](https://github.com/deiv/driftnet/releases)
[](https://github.com/deiv/driftnet/blob/master/COPYING)
[](https://www.jetbrains.com/clion/?from=driftnet)
[](https://structure101.com/)
[](https://circleci.com/gh/deiv/driftnet/tree/master)
[](https://codecov.io/gh/deiv/driftnet)
[](https://www.ej-technologies.com/products/jprofiler/overview.html)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fdeiv%2Fdriftnet?ref=badge_shield)
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:
* [libpcap](https://sourceforge.net/projects/libpcap/)
* [libjpeg](http://libjpeg.sourceforge.net/)
* [libungif](http://directory.fsf.org/wiki/Libungif)
* [libpng](http://www.libpng.org/pub/png/libpng.html)
* [libwebp](https://developers.google.com/speed/webp/)
* [libwebsockets](https://libwebsockets.org/) (if you want the http server)
* [libgtk](https://www.gtk.org/) (if you want the GTK display)
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](http://www.mpg123.de/).
### 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:
* [libwinpcap](http://www.winpcap.org/devel.htm)
* ~~[libjpeg](http://libjpeg.sourceforge.net/)~~
* ~~[libungif](http://directory.fsf.org/wiki/Libungif)~~
* ~~[libpng](http://www.libpng.org/pub/png/libpng.html)~~
* ~~[libwebp](https://developers.google.com/speed/webp/)~~
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](http://www.kismetwireless.net/) 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](http://68.38.68.127:81/writings/driftnet.html) 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
------------
+ [Jetbrains](https://www.jetbrains.com) for his marvelous IDE [CLion](https://www.jetbrains.com/clion/)
+ **Headway Software Technologies Ltd** and their fantastic refactor tool [Structure101](https://structure101.com/)
+ All the [contributors](https://github.com/deiv/driftnet/graphs/contributors)
Support development
------------
If you interested in this software (or other FOSS activities I do),
get on board and become a Patron!