Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐍 goPacketSniffer

A simple network packet sniffer written in Go (Golang) — designed for learning, experimentations, and basic packet capture tasks. This repository includes various sniffing examples and tools, such as Wi-Fi sniffing, WPA2/AES crypto utilities, and experimental protocol capture helpers.


📌 Overview

This project contains a set of Go programs and utilities that demonstrate basic packet sniffing concepts:

  • ⚡ Simple packet sniffer
  • 🛡️ WPA2-AES encryption/decryption helpers
  • 🧪 Experimental sniffing examples

This is an exploratory project — not a full network analyzer like Wireshark. It’s best suited for learning and experimentation with Go networking and packet capture techniques.


🧠 What This Project Does

  • Uses Go’s networking capabilities and packet capture libraries
  • Includes example sniffers for different network tasks
  • Demonstrates reading and interpreting packets
  • Provides utilities for experimenting with encryption and hashes

Packet sniffing involves monitoring live network traffic — use responsibly and only on networks you have permission to analyze.


📦 Project Structure

goPacketSniffer/
│
├── README.md
├── LICENSE
├── goSnort.go
├── WPA2-AES-crypto.go
├── bitcoin-wallet-backup-2023-04-08-13-47
└── other utilities...

📌 Each Go source file contains a different example/sniffer experiment.


🛠️ Requirements

To build and run any of the sniffing tools:

  • Go installed (1.16+ recommended)
  • Proper system permissions for capturing packets (usually root)
  • For low-level packet access you may need libraries like libpcap installed (platform dependent)

🚀 Building

  1. Clone the repository:

    git clone https://github.com/pressure679/goPacketSniffer.git
    cd goPacketSniffer
  2. Build the Go program you want to try. For example:

    go build goSnort.go
  3. Run with appropriate privileges:

    sudo ./goSnort

⚠️ Capturing network traffic usually requires elevated permissions.


📝 Notes

  • Some code in this repository (like WPA2/AES crypto) is experimental and not production-ready.
  • These tools may interact with encrypted traffic — do not use them on networks where you do not have permission.
  • This is primarily for education, research, and learning about Go and packet capture.

⚠️ Legal & Ethical Disclaimer

Packet sniffing can be illegal or unethical on networks without permission. Always ensure you have authorization before capturing traffic. Respect privacy and legal boundaries.


📜 License

This project includes a LICENSE file — please review it before using or modifying this code.


🚧 Want to Improve This?

You might consider:

  • Adding support for filtering by protocol
  • Saving captured packets to .pcap files
  • Integrating with gopacket or similar libraries for decoding
  • Creating a simple CLI wrapper

⭐ If you find this project helpful, feel free to give it a star!

About

Simple sniffer in Golang/Go

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages