OUImap

OUImap is a command-line (CLI) tool for querying Organizationally Unique Identifier (OUI) information and MAC address prefixes from an always up-to-date Wireshark database. It allows you to quickly look up which vendor is associated with a given MAC address (or part of it) and also supports text-based searches for vendor names.

Table of Contents

• Overview
• Main Features
• Requirements
• Installation
• Usage
• Execution Example
• Automatic Updates
• Contributing
• License
• Donations

Overview

OUImap is designed for developers, network analysts, and enthusiasts who need to quickly identify the vendor of a complete or partial MAC address. It downloads the vendor database from Wireshark, keeps a local copy for reference, and provides an interactive search mode.

Main Features

• Automatic download of the Wireshark vendor database.
• Integrity check of the downloaded file.
• Local storage and updating of the database.
• MAC prefix (OUI) lookups in standardized formats (XX:XX:XX).
• Support for various input formats (e.g., 00-50-56, 00:50:56, 001a.b623.3499, etc.).
• Text-based search for vendor names (e.g., “Intel,” “Dell”).
• Detailed results, including search time and total number of records found.
• Simple and interactive command-line tool.

Requirements

If you want to build OUImap from source, you need:

• Git 2.47.1 (or higher).
• Google Go 1.23.4 (or higher).
• Internet connection to download the vendor database if no local copy exists or if your local copy is out of date.
• Compatible operating system (Linux, macOS, or Windows).

Installation

Step 1: Clone the Repository

If you want to compile from source:

1. Clone the repository: git clone https://github.com/adhoniran/ouimap.git ouimap

2. Go to the project folder:
   cd ouimap

Step 2: Compile

In the terminal, run:

For Linux or macOS:

sh build.run

For Windows 11 (Powershell):

Invoke-Expression (Get-Content -Raw .\build.run)

This will produce the “ouimap” executable (or “ouimap.exe” on Windows) in the same project folder.

Step 3: Run

On Linux or macOS:

./ouimap

On Windows:

.\ouimap.exe

Usage

When running OUImap, you can provide your search parameters interactively.

1. Open a terminal and run the OUImap binary.
2. Enter a list of MAC addresses, prefixes, and/or vendor names (one per line).
3. Press Enter on a blank line to start the search.
4. Review the results that display the matching vendors and prefix ranges.

Execution Example

$ ./ouimap

The OUImap tool simplifies looking up OUIs and MAC address prefixes...

# Enter each search term pressing ENTER for a new term:

suse linux
0050.56
00-19-1D-0F-DA-08

# Press ENTER on a blank line to start the search:

Searching...

0C:FD:37:00:00:00/24      SUSE Linux
00:50:56:00:00:00/24      VMware, Inc.
00:19:1D:00:00:00/24      Nintendo Co., Ltd.

>> 3 record(s) found from your search parameters...
>> Search completed in 253.819µs.

# Press CTRL+C to exit:

If no results are found, the tool will display a message indicating that no matches were found.

Automatic Updates

• OUImap periodically checks whether your local database is older than seven days. If so, it downloads the latest manufacturer list from the Wireshark server and automatically replaces your local copy.
• Additionally, whenever OUImap starts, it notifies if a new version is available.

Contributing

Contributions are welcome! To contribute improvements, fixes, or new features:

1. Fork this repository.
2. Create a branch for your contribution:
   git switch -b my-feature
3. Commit your changes:
   git commit -m "Implemented a new feature"
4. Push to your repository:
   git push origin my-feature
5. Open a Pull Request describing your changes so they can be reviewed.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE.md file for details.

Copyright (C) 2025 Adhonian Gomes

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Donations

Donations are greatly appreciated! You can make your contribution via the PayPal button below.