:link: Link-Layer MAC spoofing GUI for macOS
This is an intuitive macOS status menu application written in Swift to help you spoof the MAC addresses of your Wi-Fi and Ethernet interfaces. It is free open-source.
➡️ How do I install this?
If you star this project (by clicking on ✭ in the top-right corner), you help me to prioritize among my open-source projects.
Requirements
Installation
If you have Homebrew, just run brew install --cask linkliar
.
To install it manually, follow these instructions in the documentation.
Documentation
What you're looking at right now is the technical documentation.
The end-user documentation is located at halo.github.io/LinkLiar.
There is also a source-code documentation in progress, see bin/docs
for inspiration.
Limitations/Caveats
System Preferences
will still show you the original hardware MAC address.
This is normal behavior and your actual network traffic uses the new, changed MAC address.Troubleshooting
You can create this logfile and whenever it exists, all LinkLiar components will write to it:
touch "/Library/Application Support/LinkLiar/linkliar.log"
Delete the log file again to silence logging.
Once LinkLiar is started and the menu is visible, you can hold the Option ⌥ key for advanced options. This is only intended for developers.
If you want a more colorful output, clone this git repository and run bin/logs
.
That's what I use when I'm debugging.
This utility is also bundled in LinkLiar so you can run it with
# Run this in a Terminal for live debugging logs. /Applications/LinkLiar.app/Contents/Resources/logsDevelopment
HelpBook
To update the HelpBook (end-user documentation), change the source files in LinkLiarHelp/en.lproj and then generate the output with bin/docs
.
Future work
Thanks
Link/Images.xcassets
is from Iconmonstr.License
MIT 2012-2021 halo. See MIT-LICENSE.
Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.
We'll never share your email with anyone else.