netwhale

Netwhale is a Linux tool to capture packets and process it to audio sound. It sounds like whale talking in the ocean of network.

Backgroud

Once upon a time, I read the《Expert C Programming: Deep C Secrets》. Like those curious adventurers in those old tales, I was attracted by this sentence: "solaris has a tool to listen the sound of network packets", I didn't find it in my virtual machine, so I implement netwhale.

Example

ping from local machine（github do not support the "audio" tag, plz click this link ）

Requirement

Before install this project, the following libirary is required.

libpcap
libao

you can run the command to test if libao is succesfully installed.

make makeaudio && make clean
./little_star

it will play a short music.

Install

git clone 
make && make clean

Usage

use -h to show the Usage.

-f [bpf statement] : Use Filter in packet capturing, it's optional,default capture all packets.
-i [interface name] : Use which card, you can find your network interface by using 'ifconfig', it's optional but should work with -t
-t [link layer type] : If you know the type of your link layer, set this, default as Ethernet, The Type code as Follows:
[1] Ethernet -- 0x00
[2] WLAN 802.11 -- 0x01
-h : this help page
-lx : contains l2, l3, l4, l5, design to filter the audio, such as '-l3' only listen to network layer, not implement yet.

Architecture

Project Structure

netwhale
    |------dispatch.c : handle diffrent layer and send packet to parse.
    |------main.c : Main Logic
    |------parse.c : handle protocol header and proc to sound
    |------utils.c : some utils in this project
    |------little_star.c : libao demo
    |------makefile : make this project
    |------makeaudio : make test for libao
    |------....(header files)

Contribution

Welcome to write new rules to convert packet to music.

hdznrrd/netwhale