A simple desktop tool for spoofing MAC addresses on Windows computers. Built with Python and CustomTkinter for a modern UI.
- Adapter Selection: List and choose from available network interfaces.
- MAC Generation: Randomize valid MAC addresses or enter manually.
- Spoof and Revert: Change MAC with admin rights; revert to original easily.
- Logging: Enable/disable logging and save logs.
- Theme Toggle: Switch between Dark and Light modes.
- Auto-Start: Option to run on system boot.
- Menu Bar: Access about, license, and third-party info.
- Clone the repository:
git clone https://github.com/poli0981/macspf.git
- Install dependencies:
pip install -r requirements.txt
- Run the app (with admin privileges):
python main.py
- Launch the app as administrator.
- Select an adapter from the dropdown.
- Generate a random MAC or enter one manually.
- Click "Spoof" to apply (confirm prompt appears).
- Use "Revert" to restore original.
- Enable logging and save as needed.
- Toggle auto-start and themes via checkboxes/button.
For detailed instructions, see the Wiki.
Use PyInstaller to create a standalone .exe:
pyinstaller --onefile --windowed --hidden-import=customtkinter --name="MAC_Spoofer" main.py
- Run the .exe as administrator.
Recommended IDE for Development, debugging, and coding: PyCharm Professional Version 2025.2.1 Release Candidate.
This project was developed collaboratively with the assistance of AI.
- User Contribution (@poli0981) (35%): Providing prompts for AI, conceptualizing ideas, fixing bugs, and verifying the final product.
- Grok 4 (built by xAI) Contribution (65%): Generating code, fixing bugs, writing documentation files, proposing features, and conducting research.
MIT License - see the LICENSE file for details.
See DISCLAIMER for important warnings.
See THIRD_PARTY.md for acknowledgments.
See ABOUT.md for more information.