Skip to content

thatmattlove/oui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

d5b0679 · Aug 1, 2024

History

76 Commits
Sep 24, 2023
Oct 24, 2023
Sep 24, 2023
Aug 1, 2024
Jan 25, 2022
Jul 28, 2023
Sep 24, 2023
Aug 1, 2024
Jan 19, 2022
Jan 19, 2022
Oct 23, 2023
Oct 23, 2023
Oct 24, 2023
Oct 24, 2023
Oct 24, 2023
Jan 19, 2022

Repository files navigation

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