{"library":"oui","title":"OUI MAC Address Lookup CLI","description":"The `oui` package provides a command-line interface (CLI) tool for looking up vendor information associated with MAC addresses within the IEEE Organizationally Unique Identifier (OUI) database. As of version 13.1.7, this package is exclusively a CLI utility, meaning it does not expose any JavaScript or TypeScript APIs for programmatic usage. For developers requiring programmatic access to the OUI data or a library interface, the `oui-data` package is the designated alternative. The project maintains an active development status, with major versions often introducing breaking changes such as Node.js version requirements, removal of features like `search` and `update`, and changes in data sources. Its primary differentiator is its simplicity as a direct command-line lookup tool, relying on the official IEEE data source since version 12.0.0.","language":"javascript","status":"active","last_verified":"Wed Apr 22","install":{"commands":["npm install oui"],"cli":{"name":"oui","version":null}},"imports":["This package is CLI-only. Do not import `oui` into JavaScript/TypeScript code.","This feature has been removed. Use the CLI directly for lookup.","This feature has been removed."],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"// This package is CLI-only. For direct programmatic access to OUI data,\n// consider using the 'oui-data' package (npm install oui-data).\n\n// Example: Using the 'oui' CLI tool via Node.js child_process\nconst { exec } = require('child_process');\n\nconst macAddressToLookup = '20:37:06:12:34:56';\n\nconsole.log(`Looking up vendor for MAC: ${macAddressToLookup}...\\n`);\n\nexec(`oui ${macAddressToLookup}`, (error, stdout, stderr) => {\n  if (error) {\n    console.error(`Error executing oui CLI: ${error.message}`);\n    return;\n  }\n  if (stderr) {\n    console.error(`CLI stderr: ${stderr}`);\n  }\n  console.log(`Vendor Information:\\n${stdout.trim()}`);\n\n  // Example of how you would use 'oui-data' if installed:\n  /*\n  import { lookupMacAddress } from 'oui-data';\n  (async () => {\n    try {\n      const vendorInfo = await lookupMacAddress('20:37:06:12:34:56');\n      console.log('\\n(Programmatic lookup via oui-data):', vendorInfo);\n    } catch (e) {\n      console.error('Error looking up via oui-data:', e);\n    }\n  })();\n  */\n});","lang":"javascript","description":"Demonstrates how to install and use the `oui` CLI via the command line and programmatically using `child_process` in Node.js, highlighting the CLI-only nature and suggesting `oui-data` for API usage.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":null}