oui

README

oui

MAC Address CLI Toolkit

Installation

macOS

$ brew tap thatmattlove/oui
$ brew 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

TODO

Usage

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

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

VERSION:
   0.1.5


COMMANDS:
   update, u, up    Refresh the MAC address database
   convert, c, con  Convert a MAC Address to other formats
   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                               │
├──────────────────────┼────────────────────┼─────────────────────────────────────┤
│ f4:bd:9e:00:00:00/24 │ Cisco Systems, Inc │ f4:bd:9e:00:00:00-f4:bd:9e:ff:ff:ff │
╰──────────────────────┴────────────────────┴─────────────────────────────────────╯

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
██████████████████████████████████████████████████ 100.0% Completed
Updated MAC Address database (v0) with 44,839 records in 14 seconds