Skip to main content

lookup the ieee's oui table by mac, mac prefix, org name or country

Project description

how to..

… install:

pip3 install pyoui
# master branch should be stable as well
pip3 install git+

… use by cli:

pyoui --help

usage: pyoui [-h] [-o OUTFILE] [-d] [-p PREFIX] [-c COMPANY]

optional arguments:
  -h, --help            show this help message and exit
  -o OUTFILE, --outfile OUTFILE
                        oui file which will be downloaded and read.
  -d, --debug           enable debugging
  -p PREFIX, --prefix PREFIX
                        search by mac prefix
  -c COMPANY, --company COMPANY
                        search by company name

… use by code:

from pyoui import OUI

entries = OUI(debug=True).parse()

print("entries:", entries.size())

e = next(entries.by_company("national security"))
print("company",, e.prefix)

e = next(entries.by_prefix("00:22:72"))
print("prefix",, e.prefix)

e = next(entries.by_mac("BC:23:92:42:42:42"))
print("mac",, e.prefix)

e = list(entries.by_country_code("US"))
print("length:", len(e))
print("first item:", e[0].prefix, e[0].company.__dict__)

ae = list(entries.by_country_name("United States"))
print("by country code length:", len(e), " | by name length:", len(ae))
print("lengths should be equal")

other info:

the csv folder was generated by obsolete/
the folder obsolete is as the name implies, obsolete.
all files in there are py2 and won't be refactored.

the will only install the pyoui package.

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

pyoui-0.53.tar.gz (3.7 kB view hashes)

Uploaded Source

Built Distributions

pyoui-0.53-py3.8.egg (4.0 kB view hashes)

Uploaded Source

pyoui-0.53-py3-none-any.whl (5.8 kB view hashes)

Uploaded Python 3

Supported by

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