OUI-Master-Database

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

OUI-Master-Database

★ 100 Open GitHub ↗

The most comprehensive MAC address manufacturer lookup database - 89,704+ vendors from IEEE, Nmap, Wireshark, and HDM Mac-Tracker. One master list to rule them all.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Typing SVG](https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=22&pause=1000&color=1E40AF&center=true&vCenter=true&multiline=true&repeat=true&width=950&height=80&lines=One+master+list+to+rule+them+all.;IEEE+%2B+Wireshark+%2B+Nmap+%2B+HDM+Mac-Tracker;89%2C759+OUIs+%E2%80%94+monthly+auto-update)](https://git.io/typing-svg)

<br>

[![OUIs](https://img.shields.io/badge/OUIs-89%2C759-1E40AF?style=for-the-badge&logo=ethernet&logoColor=white)](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.csv)
[![Formats](https://img.shields.io/badge/Formats-10-3B82F6?style=for-the-badge&logo=files&logoColor=white)](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/)
[![Updates](https://img.shields.io/badge/Updates-Monthly_Auto-60A5FA?style=for-the-badge&logo=githubactions&logoColor=white)](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/)
[![License](https://img.shields.io/badge/License-MIT-93C5FD?style=for-the-badge&logo=opensourceinitiative&logoColor=white)](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/)
[![Live Demo](https://img.shields.io/badge/Live_Demo-ringmast4r.github.io-000000?style=for-the-badge&logo=googlechrome&logoColor=1E40AF)](https://ringmast4r.github.io/OUI-Master-Database/)

[![Stars](https://img.shields.io/github/stars/Ringmast4r/OUI-Master-Database?style=flat-square&color=1E40AF&label=%E2%98%85%20Stars)](https://github.com/Ringmast4r/OUI-Master-Database/stargazers)
[![Forks](https://img.shields.io/github/forks/Ringmast4r/OUI-Master-Database?style=flat-square&color=3B82F6&label=%E2%9A%A1%20Forks)](https://github.com/Ringmast4r/OUI-Master-Database/network/members)
[![Repo Size](https://img.shields.io/github/repo-size/Ringmast4r/OUI-Master-Database?style=flat-square&color=60A5FA)](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/)
[![Last Commit](https://img.shields.io/github/last-commit/Ringmast4r/OUI-Master-Database?style=flat-square&color=93C5FD)](https://github.com/Ringmast4r/OUI-Master-Database/commits/master)
[![Visitors](https://visitor-badge.laobi.icu/badge?page_id=Ringmast4r.OUI-Master-Database)](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/)

---

## `> what_is_this`

```bash
ringmast4r@github:~$ cat oui-master-db.txt

PURPOSE:        MAC address vendor lookup, the comprehensive way
  SCOPE:          Every IEEE registry + Wireshark + Nmap + HDM Mac-Tracker
  COVERAGE:       89,759 unique OUIs, 78,625 cross-validated entries
  FORMATS:        TXT, CSV, TSV, JSON, JSON-min, XML, SQLite, SQL, Kismet, Kismet.gz
  UPDATES:        First of every month via GitHub Actions
  USE CASES:      Wardriving | Network forensics | IoT discovery | Threat intel

STATUS:         [ LIVE & AUTO-UPDATING ]
```

> **OUI** = the first 3 bytes of a MAC address that identifies the manufacturer.
> Most lookup databases pick *one* source. We merged *all of them*.

---

## `> stats --live`

</div>

---

## `> growth --monthly`

```mermaid
%%{init: {'theme':'dark', 'themeVariables': {'xyChart': {'backgroundColor':'#00000000','plotColorPalette':'#1E40AF','titleColor':'#1E40AF','xAxisLabelColor':'#ffffff','yAxisLabelColor':'#ffffff'}}}}%%
xychart-beta
    title "OUI Count Growth (Last 6 Auto-Updates)"
    x-axis ["2026-04-01", "2026-05-01", "2026-06-01", "2026-08-01", "2026-08-05", "2026-08-11"]
    y-axis "Total OUIs" 88100 --> 89900
    bar [88212, 88577, 88873, 89652, 89704, 89759]
    line [88212, 88577, 88873, 89652, 89704, 89759]
```

**+1,547 OUIs in ~19 weeks** · IEEE assigns roughly **353 new vendors/month** · Next refresh: **first of next month**

</div>

---

## `> sources --breakdown`

```mermaid
%%{init: {'theme':'dark', 'themeVariables': {'pie1':'#1E40AF','pie2':'#3B82F6','pie3':'#60A5FA','pie4':'#93C5FD','pie5':'#FFD700','pie6':'#1E3A8A','pieTitleTextSize':'18px','pieLegendTextSize':'14px'}}}%%
pie showData
    title Where Each OUI Comes From
    "All 3 (IEEE+Wireshark+Nmap)" : 38512
    "IEEE only" : 18258
    "Wireshark only" : 18232
    "Nmap only" : 13159
    "IEEE+Wireshark" : 1184
    "IEEE+Nmap" : 414
```

**38,512 OUIs (43%)** are confirmed by all three primary sources. The remaining single-source entries
fill gaps that *no individual database* would catch on its own. That's the point.

</div>

### Source Roster

| SOURCE | ENTRIES | LICENSE | URL |
|:-------|:-------:|:-------:|:----|
| ![IEEE](https://img.shields.io/badge/IEEE-Official-1E40AF?style=flat-square) | `58,371` | Public Domain | [standards-oui.ieee.org](https://standards-oui.ieee.org/) |
| ![Wireshark](https://img.shields.io/badge/Wireshark-Community-1679A7?style=flat-square&logo=wireshark&logoColor=white) | `57,928` | GPLv2 | [wireshark.org](https://www.wireshark.org/download/automated/data/manuf.gz) |
| ![Nmap](https://img.shields.io/badge/Nmap-Community-7B68EE?style=flat-square&logo=nmap&logoColor=white) | `52,085` | GPLv2 (mod.) | [nmap-mac-prefixes](https://github.com/nmap/nmap/raw/master/nmap-mac-prefixes) |
| ![HDM](https://img.shields.io/badge/HDM%20Mac--Tracker-Historical-FFD700?style=flat-square) | `58,487` | MIT | [hdm/mac-tracker](https://github.com/hdm/mac-tracker) |

---

## `> registries --ieee`

```mermaid
%%{init: {'theme':'dark', 'themeVariables': {'pie1':'#1E40AF','pie2':'#3B82F6','pie3':'#60A5FA','pie4':'#93C5FD','pie5':'#FFD700','pieTitleTextSize':'18px','pieLegendTextSize':'14px'}}}%%
pie showData
    title IEEE Registry Distribution (58,371 entries)
    "MA-L (Large, ~16M each)" : 39916
    "MA-S (Small, ~4K each)" : 7127
    "MA-M (Medium, ~1M each)" : 6535
    "IAB (Individual Block)" : 4575
    "CID (Company ID)" : 218
```

| REGISTRY | ENTRIES | BLOCK SIZE | TYPICAL USE |
|:--------:|:-------:|:----------:|:------------|
| **MA-L** | `39,916` | 24-bit (~16M MACs) | Large-scale manufacturers |
| **MA-S** | `7,127`  | 36-bit (~4K MACs) | IoT, niche hardware |
| **MA-M** | `6,535`  | 28-bit (~1M MACs) | Mid-volume vendors |
| **IAB**  | `4,575`  | Individual | Legacy individual blocks |
| **CID**  | `218`    | Company-only ID | Non-MAC company markers |

</div>

---

## `> classification --devices`

> ⚠ IEEE doesn't expose device category. Our classifier is a heuristic on company name +
> known-vendor lookups, so **only 15,910 of 89,759 OUIs** (17.7%) get a category. The
> remaining 73,849 stay `Unclassified` rather than guessed.

```mermaid
%%{init: {'theme':'dark', 'themeVariables': {'pie1':'#1E40AF','pie2':'#3B82F6','pie3':'#60A5FA','pie4':'#93C5FD','pie5':'#FFD700','pie6':'#1E3A8A','pie7':'#00D4FF','pie8':'#9FEF00','pie9':'#FF00FF','pie10':'#8B5CF6','pie11':'#FF6B6B','pie12':'#00FF88','pieTitleTextSize':'16px','pieLegendTextSize':'12px'}}}%%
pie showData
    title Classified Device Types (15,910 of 89,759)
    "Phone" : 6315
    "Router" : 2349
    "Computer" : 1636
    "Smart Home" : 1371
    "IoT" : 847
    "Automotive" : 452
    "Industrial" : 420
    "Switch" : 385
    "Storage" : 341
    "Medical" : 321
    "Camera" : 272
    "Other (13 cats)" : 1201
```

</div>

<details>
<summary><b>Full device-type table (24 categories)</b></summary>

| CATEGORY | COUNT | CATEGORY | COUNT |
|:---------|:-----:|:---------|:-----:|
| Phone        | `6,315` | Media Player | `168` |
| Router       | `2,349` | Gaming       | `167` |
| Computer     | `1,636` | Appliance    | `145` |
| Smart Home   | `1,371` | VoIP         | `143` |
| IoT          | `847` | Printer      | `114` |
| Automotive   | `452` | Access Point | `59` |
| Industrial   | `420` | Server       | `58` |
| Switch       | `385` | Wearable     | `52` |
| Storage      | `341` | Audio        | `35` |
| Medical      | `321` | Modem        | `27` |
| Camera       | `272` | Thermostat   | `23` |
| TV           | `203` | Tablet       | `7` |

</details>

---

## `> demo --live`

[![Live Demo](https://img.shields.io/badge/%E2%96%B6_TRY_THE_LIVE_LOOKUP-ringmast4r.github.io/OUI--Master--Database-1E40AF?style=for-the-badge&logo=githubpages&logoColor=white)](https://ringmast4r.github.io/OUI-Master-Database/)

Search by **MAC address** or **manufacturer name**. Runs entirely in your browser. No tracking.

</div>

---

## `> example`

```
MAC Address:  3C:D9:2B:12:34:56
              └─OUI─┘ └─Device─┘

OUI:          3C:D9:2B
Manufacturer: Hewlett Packard
Device Type:  Computer
Country:      US
Registry:     MA-L
Sources:      IEEE + Wireshark + Nmap
```

**Why this matters:**
- Identify rogue/unauthorized devices on your network
- Categorize WiFi APs by vendor while wardriving
- Discover IoT devices, cameras, printers across a subnet
- Detect MAC spoofing (compare OUI registry vs claimed vendor)

---

## `> ls LISTS/`

### Direct Downloads

| FORMAT | SIZE | BEST FOR | DOWNLOAD |
|:------:|:----:|:---------|:--------:|
| ![TXT](https://img.shields.io/badge/TXT-2.5_MB-93C5FD?style=flat-square) | minimal | `grep`/`awk`, legacy tools | [master_oui.txt](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.txt) |
| ![CSV](https://img.shields.io/badge/CSV-9.5_MB-60A5FA?style=flat-square) | full | Spreadsheets, dataframes | [master_oui.csv](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.csv) |
| ![TSV](https://img.shields.io/badge/TSV-5.8_MB-3B82F6?style=flat-square) | medium | Excel/Sheets (no quote issues) | [master_oui.tsv](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.tsv) |
| ![JSON](https://img.shields.io/badge/JSON-21_MB-1E40AF?style=flat-square) | pretty | APIs, human-readable | [master_oui.json](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.json) |
| ![JSON-min](https://img.shields.io/badge/JSON.min-15_MB-1E3A8A?style=flat-square) | compact | Scripts, fast loading | [master_oui.min.json](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.min.json) |
| ![XML](https://img.shields.io/badge/XML-20_MB-172554?style=flat-square) | enterprise | Java, XSLT | [master_oui.xml](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.xml) |
| ![SQLite](https://img.shields.io/badge/SQLite-18_MB-003366?style=flat-square&logo=sqlite&logoColor=white) | indexed | Ready-to-query DB | [master_oui.db](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.db) |
| ![SQL](https://img.shields.io/badge/SQL-12_MB-336699?style=flat-square&logo=postgresql&logoColor=white) | script | Postgres/MySQL/D1 import | [import-to-d1.sql](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/import-to-d1.sql) |
| ![Kismet](https://img.shields.io/badge/Kismet-2.6_MB-9FEF00?style=flat-square) | text | Kismet wireless IDS | [kismet_manuf.txt](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/kismet_manuf.txt) |
| ![Kismet.gz](https://img.shields.io/badge/Kismet.gz-0.6_MB-7FBF00?style=flat-square) | compressed | Kismet drop-in install | [kismet_manuf.txt.gz](https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/kismet_manuf.txt.gz) |

</div>

### Raw URLs (cron / curl friendly)

```bash
https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.txt
https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.csv
https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.json
https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.db
```

---

## `> data_fields`

| FIELD | TYPE | EXAMPLE |
|:------|:----:|:--------|
| `oui` | string | `3C:D9:2B` |
| `manufacturer` | string | `Hewlett Packard` |
| `short_name` | string | `HP` |
| `registry` | enum | `MA-L`, `MA-M`, `MA-S`, `IAB`, `CID` |
| `device_type` | enum | `Router`, `Phone`, `Camera`, `IoT`, ... |
| `address` | string | `11445 Compaq Center Dr, Houston TX US` |
| `country` | iso2 | `US`, `CN`, `DE`, `JP` |
| `registered_date` | date | `2012-05-15` |
| `sources` | array | `["IEEE","Wireshark","Nmap"]` |

---

## `> usage`

### `python`

```python
import json

with open('LISTS/master_oui.min.json') as f:
    db = json.load(f)

def lookup(mac):
    oui = mac[:8].upper()
    return db.get(oui, {'manufacturer': 'Unknown'})

print(lookup('00:00:0C:12:34:56'))
# {'manufacturer': 'Cisco Systems, Inc', 'device_type': 'Router', 'country': 'US'}
```

### `node.js`

```javascript
const db = require('./LISTS/master_oui.json');
const lookup = mac => db[mac.substring(0,8).toUpperCase()] || { manufacturer: 'Unknown' };
console.log(lookup('00:00:0C:12:34:56'));
```

### `sqlite3`

```bash
sqlite3 LISTS/master_oui.db "SELECT * FROM oui_registry WHERE oui = '00:00:0C'"
sqlite3 LISTS/master_oui.db "SELECT device_type, COUNT(*) FROM oui_registry GROUP BY device_type ORDER BY 2 DESC"
```

### `grep` (TXT)

```bash
grep "3CD92B" LISTS/master_oui.txt
grep -i "apple" LISTS/master_oui.txt | head
```

### `curl` (one-liner)

```bash
curl -s https://raw.githubusercontent.com/Ringmast4r/OUI-Master-Database/master/LISTS/master_oui.txt | grep -i "00000C"
```

---

## `> cli_tool`

Cross-platform Node.js CLI in [`CLI TOOL/`](CLI%20TOOL/) — works on **Windows / Linux / macOS**.

```bash
cd "CLI TOOL"
node oui-lookup.js --interactive          # Continuous lookup REPL
node oui-lookup.js 00:00:0C:12:34:56      # Single lookup
node oui-lookup.js --search cisco         # Search by manufacturer
node oui-lookup.js --wifi                 # Scan nearby WiFi + show vendors
node oui-lookup.js --bluetooth            # Scan BT devices + show vendors
node oui-lookup.js --arp                  # Local ARP table with vendors
node oui-lookup.js --stats                # Database statistics
```

| FEATURE | WIN | LINUX | MAC |
|:--------|:---:|:-----:|:---:|
| WiFi Scan | `netsh wlan` | `nmcli` | `airport` |
| Bluetooth | PowerShell | `bluetoothctl` | `system_profiler` |
| ARP Table | `arp -a` | `arp -a` | `arp -a` |

---

## `> generate --fresh`

```bash
git clone https://github.com/Ringmast4r/OUI-Master-Database.git
cd OUI-Master-Database
npm install

bash download-sources.sh        # Pulls IEEE + Wireshark + Nmap + HDM
node merge-oui-databases.js     # Merges into LISTS/master_oui.*
```

**Windows:** double-click [`update-database.bat`](update-database.bat).

---

## `> update_schedule`

The repo auto-updates on a **monthly cron** via GitHub Actions:

```
.github/workflows/update.yml -> runs at 02:00 UTC on the 1st of each month
```

Why monthly and not weekly? IEEE assigns ~300-400 OUIs/month. Polling more often
just generates churn for marginal freshness on a slow-moving registry.

To self-host updates:

```cron
0 0 1 * * cd /path/to/OUI-Master-Database && bash download-sources.sh && node merge-oui-databases.js
```

---

## `> use_cases`

```mermaid
%%{init: {'theme':'dark', 'themeVariables': {'pie1':'#1E40AF','pie2':'#3B82F6','pie3':'#60A5FA','pie4':'#93C5FD','pie5':'#FFD700','pie6':'#9FEF00','pieTitleTextSize':'16px','pieLegendTextSize':'12px'}}}%%
pie showData
    title Who Uses This (and How)
    "Wardriving / WiFi mapping" : 30
    "Network forensics & IR" : 22
    "IoT / asset discovery" : 18
    "Threat intel pipelines" : 12
    "Educational / classroom" : 10
    "Spoofing detection" : 8
```

---

## `> credits`

Combining four authoritative sources, with respect for each license:

- **IEEE Registration Authority** · public domain · [standards-oui.ieee.org](https://standards-oui.ieee.org/)
- **Wireshark Manufacturer DB** · GPLv2 · [wireshark.org](https://www.wireshark.org/)
- **Nmap MAC Prefixes** · modified GPLv2 · [nmap.org](https://nmap.org/)
- **HDM Mac-Tracker** · MIT · [hdm/mac-tracker](https://github.com/hdm/mac-tracker)

This project is **MIT** — use commercially, modify, redistribute, embed in proprietary tools.

---

## `> related_projects`

[![WiFi Mothership](https://img.shields.io/badge/WiFi_Mothership-Wardriving_Network-1E40AF?style=for-the-badge&logo=wifi&logoColor=white)](https://wifimothership.com/)
[![FLOCK](https://img.shields.io/badge/FLOCK-336K_Cameras-3B82F6?style=for-the-badge&logo=cctv&logoColor=white)](https://github.com/Ringmast4r/FLOCK)
[![Tower-Hunter](https://img.shields.io/badge/Tower--Hunter-Cell_Tower_Logger-60A5FA?style=for-the-badge&logo=signal&logoColor=white)](https://github.com/Ringmast4r/Tower-Hunter)
[![MAC-SPOOFER](https://img.shields.io/badge/MAC--SPOOFER-Cross--Platform-93C5FD?style=for-the-badge&logo=ethernet&logoColor=white)](https://github.com/Ringmast4r/MAC-SPOOFER)

---

## `> contributing`

Issues and PRs welcome. Most-wanted contributions:

- Better device-type heuristics (we're at 17.6% classified; let's get to 30%+)
- Country-code derivation from address strings
- Additional authoritative sources beyond the current four
- API wrapper libraries (Go, Rust, Ruby)

---

**Last updated:** `2026-08-11` · **Total OUIs:** `89,759` · **Maintained by** [@Ringmast4r](https://github.com/Ringmast4r)

</div>

OUI-Master-Database

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README