Skip to content

A Terminal User Interface (TUI) Packet Sniffer using sockets.

License

Notifications You must be signed in to change notification settings

kelvinleandro/caramelo-sniffer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Caramelo Sniffer

Caramelo Sniffer is a terminal-based packet analysis tool designed for Linux. It provides real-time packet capturing capabilities with options to filter and navigate through the captured data using keyboard controls. If you're interested in a React version, take a look at this repository.

Preview

preview

Features

  • Real-time Packet Capturing: Start and stop packet capture dynamically.

  • Transport Protocol Filtering: Focus on TCP, UDP, or ICMP packets, or view all protocols.

  • Interactive UI: Navigate through captured data using keyboard arrows and command keys.

Requirements

  • Operating System: Linux

  • Python Packages: Pandas

  • Permissions: Requires root access to perform packet capturing.

Installation

  1. Clone the repository:
git clone https://github.com/kelvinleandro/caramelo-sniffer.git
  1. Navigate to the project directory:
cd caramelo-sniffer
  1. Create a virtual environment within the directory:
python3 -m venv .venv
  1. Activate the virtual environment:
source .venv/bin/activate
  1. Install required Python packages:
pip install -r requirements.txt

Usage

Run the script with sudo to ensure it has the necessary permissions for packet capturing:

sudo su
source .venv/bin/activate
python3 main.py

Ensure you have the necessary permissions to execute Python scripts with sudo, and consider setting up appropriate user permissions or using virtual environments for managing Python packages.