/LDN

Python package for local wireless communication with a Nintendo Switch

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

LDN

Python package for local wireless communication with a Nintendo Switch

This package is able to scan for nearby LDN networks, join them, and even host your own networks. To get started, check out the examples folder or documentation.

This package can be installed with pip install ldn.

Documentation

Usage Instructions

This package requires a Linux system with Python 3.8 or later. Your wireless hardware must also be able to receive and transmit action frames in monitor mode.

Because LDN operates at the data link layer, it requires low-level access to your WLAN hardware. This package requires at least CAP_NET_ADMIN privileges. The easiest way to get these privileges is running your scripts as root: sudo -E python3 script.py.

It is important that no other software interferes with your network hardware. You probably need to stop the NetworkManager service before using this package: sudo service NetworkManager stop. Unfortunately, this means that you cannot access the internet while using the package. To restart the NetworkManager service, run sudo service NetworkManager start. If you are using a wired connection, you may be able to skip this step.

Troubleshooting

Using LDN is hard. Check out the list of common issues. If your problem is still not solved, feel free to create an issue on github.