VOC Workflow Walkthrough - w0rd3/iridium-toolkit GitHub Wiki

Welcome to the w0rd3 iridium-toolkit wiki!

This fork was created from the original project by Chaos Computer Club München (https://github.com/muccc) in order to streamline collection, processing, and analysis of iridium traffic, using slightly modified versions of the MUCCC toolkit.

Workflow Assumptions

• All commands are run from iridium-toolkit/ directory
• Working directory is located in iridium-toolkit/data/ (add this to your .gitignore to avoid overwriting your data during syncs)
• Collection and Analysis is organized by date
• Prereqs (including configuring device conf files) have already been met

How-To

First run of the day start with this to establish your directories:

mkdir data/$( date '+%F')

Run iridium-extractor:

iridium-extractor -D 4 ./hackrf-10msps.conf > data/$( date '+%F')/output.bits

Meanwhile in another terminal, monitor output:

tail -f data/$( date '+F')/output.bits

When you are ready to parse and analyse the data, run voc-cluster.py from a third terminal (allowing collection to continue). Arguments are [input file] [path to output directory].

./voc-cluster.py data/$( date '+%F')/output.parsed data/$( date '+%F')

Split your terminal again and add the audio files to a vlc playlist (which will begin autoplaying):

vlc data/$( date '+%F')/*.wav