https://github.com/X-croot/MacDroid
Mac Changer Magisk Module
https://github.com/X-croot/MacDroid
mac-spoof mac-spoofing magisk magisk-module termux
Last synced: 4 months ago
JSON representation
Mac Changer Magisk Module
- Host: GitHub
- URL: https://github.com/X-croot/MacDroid
- Owner: X-croot
- License: other
- Created: 2025-08-19T18:50:07.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-08-19T19:07:14.000Z (5 months ago)
- Last Synced: 2025-08-19T21:18:51.530Z (5 months ago)
- Topics: mac-spoof, mac-spoofing, magisk, magisk-module, termux
- Language: Shell
- Homepage:
- Size: 10.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-root - MacDroid - A minimal, fast, and colorful CLI to manage and persist custom MAC addresses on Android via Magisk. `FOSS` `[M]` (Network and Connectivity / Misc Network Tools)
README
# MacDroid (Magisk Module)
A minimal, fast, and colorful CLI to manage and persist custom MAC addresses on Android via Magisk. Includes an interactive TUI (`macd`) and boot‑time application of a saved MAC.
---
## Installation (Magisk)
1. Download `MacDroid.zip` to your device.
2. Open **Magisk** → **Modules** → **Install from storage** → select `MacDroid.zip`.
3. Reboot.
> Requires root/Magisk. Tested with Wi‑Fi interfaces like `wlan0`.
---
## CLI: `macd`
`macd` supports both interactive mode and direct command mode.
### Interactive Mode
```sh
macd
```
* Shows a menu to **Show**, **Set**, **Randomize**, or **Apply saved** MAC.
### Direct Commands
```sh
macd show
macd set
macd random
macd apply
macd help
```
#### Arguments
* ``: Network interface (e.g., `wlan0`).
* ``: MAC in `XX:XX:XX:XX:XX:XX` format.
#### Examples
```sh
# Show current MAC on wlan0
macd show wlan0
# Set a specific MAC on wlan0 and save it for reboot
macd set 12:34:56:78:9A:BC wlan0
# Generate and apply a random MAC on wlan0 (also saves it)
macd random wlan0
# Re-apply the last saved MAC (also done automatically on boot)
macd apply
```
---
## 🔁 Boot Behavior
* On boot, if a saved MAC exists, it is applied to the stored interface.
* If no MAC has been saved yet, **nothing is changed**.
---
## ⚖️ Disclaimer
Random MAC addresses default to Locally Administered (LAA). Do not spoof OUIs you do not own in environments where policy or compliance applies.
Changing your MAC address may affect network access controls (e.g., MAC filtering) and could violate network policies.
This software is provided strictly for educational and personal use only.
The user is solely responsible for any damages, disruptions, or legal consequences resulting from its use.
The developer cannot be held liable under any circumstances.