Publish PCAP result to MQTT
Project description
================
Python PCAP2MQTT
================
.. image:: https://img.shields.io/pypi/v/pcapmq.svg
:target: https://pypi.python.org/pypi/pcapmq
.. image:: https://img.shields.io/travis/rtfol/pcapmq.svg
:target: https://travis-ci.org/rtfol/pcapmq
.. image:: https://readthedocs.org/projects/pcapmq/badge/?version=latest
:target: https://pcapmq.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://pyup.io/repos/github/rtfol/pcapmq/shield.svg
:target: https://pyup.io/repos/github/rtfol/pcapmq/
:alt: Updates
Publish PCAP result to MQTT
* Free software: BSD license
* Documentation: https://pcapmq.readthedocs.io.
Features
--------
* Sniffer network packet
* Publish message to MQTT when found particular packet on network
Installation
--------
```
sudo apt install libpython3-dev libpcap-dev
pip install pcapmq
```
Configuration
--------
*(TODO)
Usage
--------
* Listening all UDP and ARP packet, display only, no MQTT
```
sudo pcapmq --filter "udp or arp"
```
* Send message to broker under topic devices/1/online, when found specific device's MAC address
```
sudo pcapmq --filter "ether src xx:xx:xx:xx:xx:xx" --topic devices/1/online --broker-url mqtt://username:password@localhost --payload-format "{0} - {1}"
```
=======
History
=======
0.1.0 (2018-05-04)
------------------
* First release on PyPI.
Python PCAP2MQTT
================
.. image:: https://img.shields.io/pypi/v/pcapmq.svg
:target: https://pypi.python.org/pypi/pcapmq
.. image:: https://img.shields.io/travis/rtfol/pcapmq.svg
:target: https://travis-ci.org/rtfol/pcapmq
.. image:: https://readthedocs.org/projects/pcapmq/badge/?version=latest
:target: https://pcapmq.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://pyup.io/repos/github/rtfol/pcapmq/shield.svg
:target: https://pyup.io/repos/github/rtfol/pcapmq/
:alt: Updates
Publish PCAP result to MQTT
* Free software: BSD license
* Documentation: https://pcapmq.readthedocs.io.
Features
--------
* Sniffer network packet
* Publish message to MQTT when found particular packet on network
Installation
--------
```
sudo apt install libpython3-dev libpcap-dev
pip install pcapmq
```
Configuration
--------
*(TODO)
Usage
--------
* Listening all UDP and ARP packet, display only, no MQTT
```
sudo pcapmq --filter "udp or arp"
```
* Send message to broker under topic devices/1/online, when found specific device's MAC address
```
sudo pcapmq --filter "ether src xx:xx:xx:xx:xx:xx" --topic devices/1/online --broker-url mqtt://username:password@localhost --payload-format "{0} - {1}"
```
=======
History
=======
0.1.0 (2018-05-04)
------------------
* First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pcapmq-0.1.0.tar.gz
(9.7 kB
view hashes)
Built Distribution
Close
Hashes for pcapmq-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 719b7205d231cb314d3a5e4b9c3222e9aacbbd188c682472bfc70fd4755f84dc |
|
MD5 | 01c4d8f9e8a2b4ab467e5ef54f6bac3b |
|
BLAKE2b-256 | 1b190282b804f80210d9dde5ffd384d3002454554d59f70172a6190202852560 |