oui icon indicating copy to clipboard operation
oui copied to clipboard

MAC Address CLI Toolkit

oui


MAC Address CLI Toolkit

GitHub Workflow Status GitHub release (latest SemVer)
Check Out the Web Version

Installation

macOS

Homebrew

brew tap thatmattlove/oui
brew install oui

MacPorts

sudo port install oui

Linux

Debian/Ubuntu (APT)

echo "deb [trusted=yes] https://repo.fury.io/thatmattlove/ /" > /etc/apt/sources.list.d/thatmattlove.fury.list
sudo apt update
sudo apt install oui

RHEL/CentOS (YUM)

echo -e "[fury-thatmattlove]\nname=thatmattlove\nbaseurl=https://repo.fury.io/thatmattlove/\nenabled=1\ngpgcheck=0" > /etc/yum.repos.d/thatmattlove.fury.repo
sudo yum update
sudo yum install oui

Windows

Coming Soon

Usage

$ oui --help
NAME:
   oui - MAC Address CLI Toolkit

USAGE:
   oui [global options] command [command options] [arguments...]

VERSION:
   2.0.4


COMMANDS:
   update, u, up      Refresh the MAC address database
   convert, c, con    Convert a MAC Address to other formats
   entires, e, count  Show the number of MAC addresses in the database
   help, h            Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --debug        Enable debugging (default: false)
   --help, -h     show help (default: false)
   --version, -v  print the version (default: false)

OUI Lookup

$ oui F4:BD:9E:01:23:45

 F4:BD:9E:01:23:45 Results

╭──────────────────────┬────────────────────┬─────────────────────────────────────┬──────────╮
│ Prefix               │ Organization       │ Range                               │ Registry │
├──────────────────────┼────────────────────┼─────────────────────────────────────┼──────────┤
│ f4:bd:9e:00:00:00/24 │ Cisco Systems, Inc │ f4:bd:9e:00:00:00-f4:bd:9e:ff:ff:ff │ MA-L     │
╰──────────────────────┴────────────────────┴─────────────────────────────────────┴──────────╯

Conversion

$ oui convert F4:BD:9E:01:23:45

 F4:BD:9E:01:23:45

╭─────────────┬───────────────────────╮
│ Hexadecimal │ f4:bd:9e:01:23:45     │
│ Dotted      │ f4bd.9e01.2345        │
│ Dashed      │ f4-bd-9e-01-23-45     │
│ Integer     │ 269095236870981       │
│ Bytes       │ {244,189,158,1,35,69} │
╰─────────────┴───────────────────────╯

Updating the Database

$ oui update

Updating MAC Address Database
██████████▌░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 20.0% Populating database...finished parsing vendors from MA-L registry
██████████████████▌░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 37.0% Populating database...finished parsing vendors from CID registry
███████████████████████████▌░░░░░░░░░░░░░░░░░░░░░░ 54.0% Populating database...finished parsing vendors from IAB registry
███████████████████████████████████▌░░░░░░░░░░░░░░ 71.0% Populating database...finished parsing vendors from MA-M registry
████████████████████████████████████████████▌░░░░░ 88.0% Populating database...finished parsing vendors from MA-S registry
██████████████████████████████████████████████████ 100.0% Completed
Updated MAC Address database (2.0.4) with 49,949 records in 5 seconds

GitHub