---
id: randmac
version: "0.1"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# randmac — a random 12-digit mac address generator

License: permissive · Maintenance: abandoned · Downloads: 78.1K/mo

## What it is and what it does

randmac is a lightweight utility for generating random MAC addresses in multiple formats. It can produce either full 12-digit addresses or preserve the manufacturer (OUI) portion while randomizing the NIC-specific portion. The package supports five common MAC address formats: colon-separated (MM:MM:MM:SS:SS:SS), hyphen-separated (MM-MM-MM-SS-SS-SS), dot-separated (MM.MM.MM.SS.SS.SS), Cisco format (MMMM.MMSS.SSSS), and unformatted (MMMMMMSSSSSS).

The main use case is generating test or mock MAC addresses for network testing, device simulation, or security research. It includes a command-line interface for quick generation and a Python API for programmatic use. The optional LAA (locally administrated address) mode ensures generated addresses are marked as locally administered by constraining the first hex digit to x2, x6, xA, or xE, which is useful when you need addresses that won't collide with real hardware vendors.

Use it for:

- Generate mock MAC addresses for network testing and device simulation scenarios
- Create test data for network monitoring or DHCP server testing
- Randomize NIC portions while preserving a specific OUI for vendor-specific testing
- Generate LAA-compliant addresses for local network administration and testing
- Quick command-line MAC address generation without writing code

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates random 12-digit MAC addresses in multiple formats, with optional support for locally administrated address (LAA) format compliance.

Yes, if you need a simple, dependency-free MAC address generator for testing or development. The low install friction and permissive license make it a low-risk addition. However, the abandoned maintenance status and Alpha classification mean it's best suited for non-critical tooling; do not rely on it for production systems. Verify LAA format correctness for your specific use case before deploying.

## Install

pip install randmac
uv add randmac
poetry add randmac

## Installing randmac

Before you install: Low install friction with no runtime dependencies. Package is abandoned (last release 2020-09-13, last commit 2023-05-25) and classified as Alpha, so expect no active maintenance or bug fixes.

License in practice: MIT license is permissive, allowing commercial and private use with minimal restrictions.

Quickstart:

from randmac import RandMac

# Generate a random LAA-format MAC address
mac = RandMac()
print(mac)  # e.g., 'a6:9b:6b:8e:b3:42'

# Generate with custom format
mac_custom = RandMac("00:00:00:00:00:00", True)
print(mac_custom)  # e.g., '00:00:00:3f:8a:06'

Requires Python >3.2

Verify before relying:

- Whether the package works reliably with Python versions beyond 3.2 despite the classifier listing only 3.2
- Whether the LAA format generation (x2, x6, xA, xE prefix guarantee) is consistently correct across all output formats

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 78.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

random mac address generator, mac address generation, network mac randomizer, LAA format mac addresses, mac address utility, nic address generator, mac-address, network-testing, test-data-generation

[View on SkillFed](https://skillfed.io/packages/randmac) · [View on PyPI](https://pypi.org/project/randmac/)