{"id":23164767,"url":"https://github.com/ndejong/ouilookup","last_synced_at":"2025-08-18T04:32:43.136Z","repository":{"id":53600076,"uuid":"136856456","full_name":"ndejong/ouilookup","owner":"ndejong","description":"A CLI tool and Python3 module for looking up hardware MAC addresses from the published OUI source at ieee.org.","archived":false,"fork":false,"pushed_at":"2023-05-13T16:02:58.000Z","size":2164,"stargazers_count":22,"open_issues_count":2,"forks_count":7,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-07-31T21:14:45.115Z","etag":null,"topics":["arp","network-analysis","network-monitoring","oui-database","oui-search","ouilookup","python"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/ouilookup/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ndejong.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-06-11T00:45:03.000Z","updated_at":"2025-03-25T14:05:14.000Z","dependencies_parsed_at":"2024-06-21T15:34:19.818Z","dependency_job_id":"309fccf4-55aa-4b34-8d51-b20e3a640edf","html_url":"https://github.com/ndejong/ouilookup","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/ndejong/ouilookup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndejong%2Fouilookup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndejong%2Fouilookup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndejong%2Fouilookup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndejong%2Fouilookup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ndejong","download_url":"https://codeload.github.com/ndejong/ouilookup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndejong%2Fouilookup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270945173,"owners_count":24672873,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-18T02:00:08.743Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arp","network-analysis","network-monitoring","oui-database","oui-search","ouilookup","python"],"created_at":"2024-12-18T01:12:50.775Z","updated_at":"2025-08-18T04:32:42.783Z","avatar_url":"https://github.com/ndejong.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ouilookup\n\n[![PyPi](https://img.shields.io/pypi/v/ouilookup.svg)](https://pypi.python.org/pypi/ouilookup/)\n[![Python Versions](https://img.shields.io/pypi/pyversions/ouilookup.svg)](https://github.com/ndejong/ouilookup/)\n[![build tests](https://github.com/ndejong/ouilookup/actions/workflows/build-tests.yml/badge.svg)](https://github.com/ndejong/ouilookup/actions/workflows/build-tests.yml)\n[![License](https://img.shields.io/github/license/ndejong/ouilookup.svg)](https://github.com/ndejong/ouilookup)\n\nA CLI tool and Python module for looking up hardware MAC addresses from the published OUI source list at ieee.org.\n\n## Project\n* https://github.com/ndejong/ouilookup/\n\n## Install\n#### via PyPi\n```bash\npip3 install ouilookup\n```\n\n## Versions\nLegacy versions based on year-date (eg v2018.2) have been hard-deprecated in favour of a backward incompatible \nstandard versioning scheme (eg v0.2.0).\n\n## CLI usage\n```text\nusage: ouilookup [-h] [-q [\u003chwaddr\u003e ...] | -s | -u | -ul \u003cfilename\u003e] [-d] [-df \u003cdata-file\u003e]\n\nouilookup v0.3.0\n\noptions:\n  -h, --help            show this help message and exit\n  -q [\u003chwaddr\u003e ...], --query [\u003chwaddr\u003e ...]\n                        Query to locate matching MAC hardware address(es) from \n                        the oui ouilookup.json data file. Addresses may be \n                        expressed in formats with or without ':' or '-' \n                        separators. Use a space or comma between addresses to \n                        query for more than one item in a single query.\n  -s, --status          Return status metadata about the ouilookup.json data \n                        file.\n  -u, --update          Download the latest from \n                        https://standards-oui.ieee.org/oui/oui.txt then parse \n                        and save as a ouilookup.json data file.\n  -ul \u003cfilename\u003e, --update-local \u003cfilename\u003e\n                        Supply a local oui.txt then parse and save as a \n                        ouilookup.json data file.\n\n  -d, --debug           Enable debug logging\n  -df \u003cdata-file\u003e, --data-file \u003cdata-file\u003e\n                        Use a data file that is not in the default data file \n                        search paths: /home/\u003cuser\u003e/.local/ouilookup, \n                        \u003cpackage-path\u003e/ouilookup/data, /var/lib/ouilookup\n\nA CLI tool for interfacing with the OuiLookup module that provides CLI access \nthe query(), update() and status() functions. Outputs at the CLI are JSON \nformatted allowing for easy chaining with other toolchains. The update() \nfunction updates directly from \"standards-oui.ieee.org\".\n```\n\n## Python3 Module usage\n\n```console\n\u003e\u003e\u003e from OuiLookup import OuiLookup\n\n\u003e\u003e\u003e OuiLookup().query('00:00:aa:00:00:00')\n[{'0000AA000000': 'XEROX CORPORATION'}]\n\n\u003e\u003e\u003e OuiLookup().query(['00:00:01:00:00:00','00-00-10-00-00-00','000011000000'])\n[{'000001000000': 'XEROX CORPORATION'}, {'000010000000': 'SYTEK INC.'}, {'000011000000': 'NORMEREL SYSTEMES'}]\n\n\u003e\u003e\u003e OuiLookup().update()\n{'timestamp': '2023-05-13T14:11:17+00:00', 'source_url': 'https://standards-oui.ieee.org/oui/oui.txt', 'source_data_file': '/tmp/ouilookup-qm5aq0dk/oui.txt', 'source_bytes': '5468392', 'source_md5': '55a434f90da0c24c1a4fcfefe5b2b64b', 'source_sha1': 'dd5e8849ab8c65b2fb12c4b5aef290afee6bbfcd', 'source_sha256': 'af7e4bb1394109f4faad814074d3a6d5b792078074549a5d554c0904612c0bfc', 'vendor_count': '33808', 'data_file': '~/.local/ouilookup/ouilookup.json'}\n\u003e\u003e\u003e OuiLookup().status()\n{'timestamp': '2023-05-13T14:11:17+00:00', 'source_url': 'https://standards-oui.ieee.org/oui/oui.txt', 'source_data_file': '/tmp/ouilookup-qm5aq0dk/oui.txt', 'source_bytes': '5468392', 'source_md5': '55a434f90da0c24c1a4fcfefe5b2b64b', 'source_sha1': 'dd5e8849ab8c65b2fb12c4b5aef290afee6bbfcd', 'source_sha256': 'af7e4bb1394109f4faad814074d3a6d5b792078074549a5d554c0904612c0bfc', 'vendor_count': '33808', 'data_file': '~/.local/ouilookup/ouilookup.json'}\n```\n\n## Authors\n* [Nicholas de Jong](https://nicholasdejong.com)\n\n## License\nBSD-2-Clause - see LICENSE file for full details.\n\nNB: License change from Apache-2.0 to BSD-2-Clause in February 2020 at version 0.2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fndejong%2Fouilookup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fndejong%2Fouilookup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fndejong%2Fouilookup/lists"}