https://github.com/kkrypt0nn/pymanuf

📇 A very simple Python library to get the manufacturer of a specific MAC address
https://github.com/kkrypt0nn/pymanuf

mac mac-address mac-address-analyzer mac-address-generator mac-address-manufacturer mac-addresses manuf manufacturer pymanuf python wireshark

Last synced: 19 days ago
JSON representation

📇 A very simple Python library to get the manufacturer of a specific MAC address

• Host: GitHub
• URL: https://github.com/kkrypt0nn/pymanuf
• Owner: kkrypt0nn
• License: mit
• Created: 2025-02-10T13:35:40.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2025-03-29T01:17:24.000Z (27 days ago)
• Last Synced: 2025-03-29T02:24:26.707Z (27 days ago)
• Topics: mac, mac-address, mac-address-analyzer, mac-address-generator, mac-address-manufacturer, mac-addresses, manuf, manufacturer, pymanuf, python, wireshark
• Language: Python
• Homepage: https://krypton.ninja
• Size: 743 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        


# pymanuf

[![PyPi Badge](https://img.shields.io/pypi/v/pymanuf.svg)](https://pypi.org/p/pymanuf)

[![PyPi Supported Versions Badge](https://img.shields.io/pypi/pyversions/pymanuf.svg)](https://pypi.org/p/pymanuf)

[![CI Badge](https://github.com/kkrypt0nn/pymanuf/actions/workflows/ci.yml/badge.svg)](https://github.com/kkrypt0nn/pymanuf/actions)

[![Last Commit Badge](https://img.shields.io/github/last-commit/kkrypt0nn/pymanuf)](https://github.com/kkrypt0nn/pymanuf/commits/main)

[![Conventional Commits Badge](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white)](https://conventionalcommits.org/en/v1.0.0/)



---

A very simple Python library to get the manufacturer of a specific MAC address

## Getting Started

### Installation

If you want to use this library for one of your projects, you can install it like any other Python library

```bash

python -m pip install pymanuf

```

### Versioning

The versioning of the library is the following: `YYYY.MM.DD` where the leading `0` is **removed**.

Versions are automatically released every month on the first day of that month.

### Example Usage

#### Offline Lookup (preferred)

```python

from pymanuf import lookup

try:

    manuf = lookup("C4:A8:1D:73:D7:8C")

    print(f"Manufacturer: {manuf}")

except Exception as e:

    print(f"Error: {e}")

```

#### Online Lookup

```python

from pymanuf.online import lookup

try:

    manuf = lookup("C4:A8:1D:73:D7:8C")

    print(f"Manufacturer: {manuf}")

except Exception as e:

    print(f"Error: {e}")

```

## Troubleshooting

If you have problems using the library, you can open up an [issue](https://github.com/kkrypt0nn/pymanuf/issues).

## Contributing

People may contribute by following the [Contributing Guidelines](./CONTRIBUTING.md) and

the [Code of Conduct](./CODE_OF_CONDUCT.md)

## License

This library was made with 💜 by Krypton and is under the [MIT License](./LICENSE.md).