Skip to main content

Sniffer for Modbus RTU traffic with CLI and GUI

Project description

🐍 ModbusSniffer – Free Modbus RTU Analyzer with GUI (Python / PyQt6)

A lightweight and user-friendly Modbus RTU sniffer tool with a graphical interface.
Easily analyze and debug communication between PLCs, HMIs, and other Modbus RTU devices via serial ports.

GitHub release License: MIT

Demo

🔧 Features

  • 🧰 Sniffs raw Modbus RTU frames from serial ports (RS-485, USB)
  • 🖥️ GUI interface built with PyQt6
  • 📋 Frame table: Real-time decoded Modbus traffic
  • 🌈 Color-coded logging of request–response frames
  • 🪟 Cross-platform: Windows & Linux
  • 🆓 MIT licensed, open-source

📦 Installation

Install directly from PyPI:

pip install modbus-sniffer

or download Binary files for Ubuntu and Windows from here.

You can also build and install app from sourcess. Click here for deatails about it.


▶️ Usage

🎛️ Run GUI:

modbus-sniffer-gui

🖥️ Run CLI:

To list all options:

modbus-sniffer -h

Example of runnig sniffer on ttyUSB0 with baud 115200 and no parity:

modbus-sniffer -p /dev/ttyUSB0 -b 115200 -r none

For more usage options, development guide, and installation from source, visit the GitHub repository:

👉 ModbusSniffer on GitHub


🤝 Contributing

Please see CONTRIBUTING.md for development setup and contribution guidelines.


📜 License

MIT License — see the LICENSE file for details.
This project is a fork of BADAndrea ModbusSniffer, maintained by niwciu with enhancements described above.


myEmbeddedWayBanerWhiteSmaller

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

modbus_sniffer-1.0.3.tar.gz (24.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

modbus_sniffer-1.0.3-py3-none-any.whl (18.5 kB view details)

Uploaded Python 3

File details

Details for the file modbus_sniffer-1.0.3.tar.gz.

File metadata

  • Download URL: modbus_sniffer-1.0.3.tar.gz
  • Upload date:
  • Size: 24.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for modbus_sniffer-1.0.3.tar.gz
Algorithm Hash digest
SHA256 7b528e795dd3dfe6165a1cfa2b88aea2ab082418e127678968a6540085775f61
MD5 d5852270715c671126dbe5f7a7ea35e4
BLAKE2b-256 081f4edf77d54d78b94a66ccb7b783ab8ec4f6168b41b1ca74a09972a4907f99

See more details on using hashes here.

File details

Details for the file modbus_sniffer-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: modbus_sniffer-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 18.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for modbus_sniffer-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 fdbde996e7c8c507b86e81d6b9e917702e2b9dca0433d08ac1b3690992c9a513
MD5 fa6e5058112b5b08107311d980a8621f
BLAKE2b-256 17f14c35bc156d6455b4a6aef208227a767e59fc9f1ae3d6f4b0f3a8d0fac972

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page