# USB-Mouse-Pcap-Visualizer

**Repository Path**: bdtl/USB-Mouse-Pcap-Visualizer

## Basic Information

- **Project Name**: USB-Mouse-Pcap-Visualizer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-29
- **Last Updated**: 2024-11-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Description

A forensic script that can help you to extract mouse movement / click data from usb traffic files.

![Animation](https://github.com/WangYihang/USB-Mouse-Pcap-Visualizer/assets/16917636/1dd15ae6-ef58-416d-b5af-8cd8aaceeaaf)

## Installation

### Clone this repository

```bash
git clone https://github.com/WangYihang/USB-Mouse-Pcap-Visualizer.git
```

### Install Python dependencies

```bash
cd USB-Mouse-Pcap-Visualizer
pip install poetry
poetry install
```

### Install tshark

> Winodws

Install WireShark and add `tshark` to your `PATH`.

> Linux (Ubuntu)

```bash
sudo apt install tshark
```

## Usage

```bash
$ poetry run python usb-mouse-pcap-visualizer.py --help
usage: usb-mouse-pcap-visualizer.py [-h] -i INPUT_FILE -o OUTPUT_FILE

options:
  -h, --help            show this help message and exit
  -i INPUT_FILE, --input-file INPUT_FILE
                        Path to the input pcap file.
  -o OUTPUT_FILE, --output-file OUTPUT_FILE
                        Path to the output csv file.
```

```bash
poetry run python usb-mouse-pcap-visualizer.py -i assets/example/XNUCA/data.pcap -o assets/example/XNUCA/data.csv
```

The csv file can be visualized by `assets/index.html`, or try it [online](https://usb-mouse-pcap-visualizer.vercel.app/).

```csv
timestamp,x,y,left_button_holding,right_button_holding
1478943238.284336,0,0,False,False
1478943238.899621,0,0,False,False
1478943238.899621,0,0,False,False
```

![](assets/example/XNUCA/data.png)


## Demonstration Videos

* https://www.youtube.com/watch?v=unBwmcpXbhE