{"id":16156779,"url":"https://github.com/hemantapkh/macswitcher","last_synced_at":"2025-03-18T20:30:40.529Z","repository":{"id":113479307,"uuid":"309367724","full_name":"hemantapkh/macswitcher","owner":"hemantapkh","description":"Ⓜ️ MACSwitcher (MACS) is a tool to manipulate the MAC addresses of network interfaces. macs already contain the OUI of more than 12500 vendors, so you don't need to specify them.","archived":false,"fork":false,"pushed_at":"2020-11-17T15:18:06.000Z","size":300,"stargazers_count":12,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-28T12:06:22.621Z","etag":null,"topics":["hacktoberfest","linux-mac-changer","mac-address-changer","mac-changer","macchanger","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","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/hemantapkh.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":"2020-11-02T12:47:38.000Z","updated_at":"2023-11-12T22:37:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"4c1a72e5-a85d-4075-8183-a5851c0b3b53","html_url":"https://github.com/hemantapkh/macswitcher","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemantapkh%2Fmacswitcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemantapkh%2Fmacswitcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemantapkh%2Fmacswitcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemantapkh%2Fmacswitcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hemantapkh","download_url":"https://codeload.github.com/hemantapkh/macswitcher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243950792,"owners_count":20373664,"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","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":["hacktoberfest","linux-mac-changer","mac-address-changer","mac-changer","macchanger","python3"],"created_at":"2024-10-10T01:46:27.199Z","updated_at":"2025-03-18T20:30:40.519Z","avatar_url":"https://github.com/hemantapkh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/platform-linux-blue?style=flat-square\" alt=\"platform\" /\u003e\n\u003ca href=\"https://github.com/hemantapkh/macswitcher/blob/master/LICENSE\"\u003e\n\u003cimg src=\"https://img.shields.io/github/license/hemantapkh/macswitcher?style=flat-square\" alt=\"licence\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/hemantapkh/macswitcher/graphs/contributors\"\u003e\n\u003cimg src=\"https://img.shields.io/github/contributors/hemantapkh/macswitcher.svg?style=flat-square\" alt=\"Contributors\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/hemantapkh/macswitcher/fork\"\u003e\n\u003cimg src=\"https://img.shields.io/github/forks/hemantapkh/macswitcher.svg?style=flat-square\" alt=\"Forks\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/hemantapkh/macswitcher/stargazers\"\u003e\n\u003cimg src=\"https://img.shields.io/github/stars/hemantapkh/macswitcher?style=flat-square\" alt=\"Stars\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/hemantapkh/macswitcher/issues\"\u003e\n\u003cimg src=\"https://img.shields.io/github/issues/hemantapkh/macswitcher?style=flat-square\" alt=\"Issues\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/hemantapkh/macswitcher/pulls\"\u003e\n\u003cimg src=\"https://img.shields.io/github/issues-pr/hemantapkh/macswitcher?style=flat-square\" alt=\"Pull Requests\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.youtube.com/c/H9TechYouTube?sub_confirmation=1\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/subscribe-H9-red?style=flat-square\" alt=\"Subscribe my channel H9\"/\u003e\n\u003c/a\u003e\n\u003cp align=\"center\"\u003e\n \u003cimg src=\"image/MacsMenu.png\" align=\"center\" alt=\"MacSwitcher\" /\u003e\n\u003ch2 align=\"center\"\u003eMACSwitcher - Easy way to spoof MAC address\u003c/h2\u003e\n\n\u003c/p\u003e\n\n\n## ℹ️ MACSwitcher\n \nMACSwitcher [(macs)](https://github.com/hemantapkh/macswitcher) is a tool to manipulate the [MAC](https://en.wikipedia.org/wiki/MAC_address) addresses of network interfaces. Sometimes we need to change our MAC address to a specific vendor, which is a boring and time-consuming task. MACS was created so that you can simply change the MAC address to the desired vendor just by typing the vendor name. It contains the [OUI](https://en.wikipedia.org/wiki/Organizationally_unique_identifier) of more than 12500 vendors.\n\n\n ##  ⚠️ Requirements\n\n- Python3\n- [Ifconfig](https://en.wikipedia.org/wiki/Ifconfig)\n\n\n\n## 🛠️ Installation\n\n* Simply execute the following command\n\n```bash\ngit clone https://github.com/hemantapkh/macswitcher \u0026\u0026 cd macswitcher \u0026\u0026 sudo bash install.sh --install\n```\n\n*To uninstall macs, execute the command `macs --uninstall`*\n\n\n### ⁉️ Usage\n\n```Usage: macs [Option/s] \u003cinterface\u003e```\n\n### ➡️ Arguments\n  \n  - **Main Options**\n\n    ```\n    -m, --mac \u003ccustom mac\u003e     : Set the custom MAC address\n    -v, --vendor \u003cvendor\u003e      : Set a MAC address from a vendor\n    -r, --random-registered    : Set a random registered MAC\n    -R, --random [option/s]    : Set a random MAC address\n    ```\n\n    *You are only supposed to pass one argument from the main options.*\n      \n  - **Random MAC Options**\n\n    ```\n    --transmission \u003ctype\u003e    : Choose transmission type [unicast/multicast]\n    --administration \u003ctype\u003e  : Choose administrative type [Local/Global]\n    ```\n\n    *You are supposed to pass these arguments only if `-R` or `--random` is passed from the main options.*\n\n  - **Other Options**\n\n    ```\n    -h, --help    : Show this help menu and exit\n    -s, --show    : Show current MAC address/es with interface/s\n    ```\n\n\n## 🎯 Examples\n\n- **To set a custom MAC address**\n    \u003e macs -m XX:XX:XX:XX:XX:XX:XX:XX wlan0\n\n    \u003e macs --mac XXXX wlan0\n\n- **To set a MAC address from certain vendors**\n    \u003e macs -v samsung wlan0\n    \n    \u003e macs --vendor cisco wlan0\n\n- **To set a random registered MAC address**\n    \u003e macs -r  wlan0\n\n- **To set a fully random MAC address**\n   \u003e macs --random wlan0 \n   \n   \u003e macs -R --transmission unicast --administration global wlan0 \n\n    \u003e macs -R --transmission multicastcast wlan0\n\n- **To see the current list of interfaces with their MAC**\n    \u003e macs -s\n\n\n## 💚 Contributing\n\nAny contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n*You can also contribute to this project by creating an issue of bugs and feature requests.*\n\n\n## 🔑 License\n\nDistributed under the MIT License. See [LICENSE](LICENSE) for more information.\n\n-----\nProject Maintainer: [Hemanta Pokharel](https://github.com/hemantapkh/) [[✉️](mailto:hemantapkh@yahoo.com) [💬](https://t.me/hemantapkh) [📺](https://youtube.com/h9techyoutube)]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhemantapkh%2Fmacswitcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhemantapkh%2Fmacswitcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhemantapkh%2Fmacswitcher/lists"}