{"id":43514245,"url":"https://github.com/subgraph/macouflage","last_synced_at":"2026-02-03T13:30:40.757Z","repository":{"id":33680976,"uuid":"37333726","full_name":"subgraph/macouflage","owner":"subgraph","description":"macouflage is a MAC address anonymization tool, written in Golang, for Linux-based operating systems.","archived":false,"fork":false,"pushed_at":"2023-07-13T14:51:32.000Z","size":13,"stargazers_count":114,"open_issues_count":2,"forks_count":14,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-06-20T17:52:32.178Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/subgraph.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":"2015-06-12T16:55:40.000Z","updated_at":"2024-05-15T18:59:06.000Z","dependencies_parsed_at":"2024-06-20T17:32:34.963Z","dependency_job_id":"ed8ae849-6b37-498a-9902-205c620291f2","html_url":"https://github.com/subgraph/macouflage","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/subgraph/macouflage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subgraph%2Fmacouflage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subgraph%2Fmacouflage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subgraph%2Fmacouflage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subgraph%2Fmacouflage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/subgraph","download_url":"https://codeload.github.com/subgraph/macouflage/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subgraph%2Fmacouflage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29046554,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T10:09:22.136Z","status":"ssl_error","status_checked_at":"2026-02-03T10:09:16.814Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-02-03T13:30:40.163Z","updated_at":"2026-02-03T13:30:40.744Z","avatar_url":"https://github.com/subgraph.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Macouflage\nMacouflage is a MAC address anonymization tool similar in functionality to\n[GNU Mac Changer](http://directory.fsf.org/wiki/GNU_MAC_Changer). The main\ndifference is that Macouflage supports additional modes of operation such as\ngenerating spoofed MAC addresses from a list of popular network devices.\n\n# Data sources\n\nMacouflage ships with a JSON database derived from IEEE's OUI \n(Organizationally Unique Identifier)/MA-L (MAC Address Block Large) [registry](http://standards.ieee.org/develop/regauth/oui/oui.txt).\n\nThe popular mode currently uses the data gathered  by Etienne Perot's\n[macchiato](https://github.com/EtiennePerot/macchiato) project. \n\nThe data is merged from these data sources by the supplementary [ouiner](https://github.com/mckinney-subgraph/ouiner) \nproject.\n\n# Usage\n\n```\n$ macouflage\nNAME:\n   macouflage - macouflage is a MAC address anonymization tool\nUSAGE:\n   macouflage -i/--interface \u003cdevice\u003e [-b/--bia] command [command options] [arguments...]\nVERSION:\n   0.1\nAUTHOR(S):\n   David McKinney \u003cmckinney@subgraph.com\u003e \nCOMMANDS:\n   show\t\t\t\tPrint the MAC address and exit\n   ending\t\t\tDon't change the vendor bytes (generate last three bytes: XX:XX:XX:??:??:??)\n   another\t\t\tSet random vendor MAC of the same kind\n   any\t\t\t\tSet random vendor MAC of any kind\n   permanent\t\t\tReset to original, permanent hardware MAC\n   random\t\t\tSet fully random MAC\n   popular\t\t\tSet a MAC from the popular vendors list\n   list (popular)\t\tPrint known vendors\n   search\t\t\tSearch vendor names\n   mac\t\t\t\tSet the MAC XX:XX:XX:XX:XX:XX\n   help, h\t\t\tShows a list of commands or help for one command\n   \nGLOBAL OPTIONS:\n   -i, --interface \tTarget device (required)\n   -b, --bia\t\tPretend to be a burned-in-address\n   --help, -h\t\tshow help\n   --version, -v\tprint the version\n```\n\n# Examples\n\n## List vendors\n```\n$ macouflage list\n#\tVendorPrefix\tVendor\n1\t00:00:00\tXEROX CORPORATION\n2\t00:00:01\tXEROX CORPORATION\n3\t00:00:02\tXEROX CORPORATION\n4\t00:00:03\tXEROX CORPORATION\netc.\n```\n\n## List popular vendors\n```\n$ macouflage list popular\n#\tVendorPrefix\tVendor\n1\t00:00:48\tSEIKO EPSON CORPORATION\n2\t00:01:29\tDFI Inc.\n3\t00:03:0D\tUniwill Computer Corp.\n4\t00:08:54\tNetronix, Inc.\netc.\n```\n\n## Popular mode\nFirst take down the interface:\n```\n$ sudo ip link set eth0 down\n```\nThen change the MAC:\n```\n$ sudo macouflage -i eth0 popular                                                                                                                                                                                  -- INSERT --\nCurrent MAC:   (Some MAC) (Some vendor))\nPermanent MAC: (Some MAC) (Some vendor)\nNew MAC:\tbc:5f:f4:79:32:a6 (ASRock Incorporation)\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubgraph%2Fmacouflage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubgraph%2Fmacouflage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubgraph%2Fmacouflage/lists"}