The goal of this project is to workaround Wi-Fi problems on macOS.
Apple Developer Command Line Tools are required for both compiling and using.
Due to the nature of this tool, this tool requires root access. It will call sudo
automatically if it is not currently running as root user.
-
Clone this repo.
-
Go to
nativeapi
directory, and runmake
to compile the native library. -
Simply run
python3 /path/to/this/repo
. Can optionally set an alias in your shell for better convenience.
-
airportd
(default) This workaround suspends theairportd
program to disable Wi-Fi roaming and scanning. When this workaround is active, connecting to a different Wi-Fi will not work. Wi-Fi list on the UI will also freeze. Should the current Wi-Fi connection becomes out of range and disconnected, no further reconnection attempt will be made until this workaround is disabled. -
airplay
This workarounds suspends AirPlay (theAirPlayXPCHelper
process) and disables theawdl0
interface to avoid ping spikes for a much more stable internet. When this workaround is active, AirPlay will not work, and the chances ofawdl0
being restarted is reduced. Additionally, automatic audio sink/source switching when connecting and/or disconnecting Bluetooth audio will not work until this workaround is disabled (already connected Bluetooth audio will work just fine).