Jump to content

Nintendo Clients

¿Quieres enterarte al momento de las nuevas descargas? Síguenos en Twitter o Mastodon!

Python package to communicate with Nintendo servers

To import this into your code, run python setup.py install or place the nintendo folder somewhere Python can find it.

You might need to adjust your scripts if you pull new commits from this package (it may receive backwards compatibility breaking changes at any time).


  • Python 3.6 or higher
  • Python requests (http://docs.python-requests.org)
  • BeautifulSoup4 and lxml
  • PyCryptodome
  • PyOpenSSL
  • netifaces

Example scripts

Wii U

  • example_donkeykong.py: Downloads DKC Tropical Freeze rankings and the replay file of the world record.
  • example_mariokart.py: Downloads Mario Kart 8 rankings and the replay file of whoever is in 500th place.
  • example_miis.py: Requests all kinds of information about the primary mii associated with a NNID.
  • example_friend_list.py: Requests your friend list, incoming and outgoing friend requests, and blacklist.
  • example_friend_notifications.py: Listens for friend notifications (a friend starting a game for example).
  • example_createroom.py: Shows how to create a friend room in Mario Kart 8. You'll get an error if you try to join it on a real Wii U though, because this script does not implement the P2P protocol.


  • example_lan_splatoon2.py: Searches for Splatoon 2 LAN sessions and prints information about them.
  • example_lan_smm2.py: Searches for Super Mario Maker 2 LAN sessions and prints information about them.
  • example_smm2.py: Downloads a Super Mario Maker 2 level and its thumbnails, and prints information about both the level and its creator. This script requests new tokens every time it's run, even though the dauth and aauth tokens are valid for 24 hours and the id token is valid for 3 hours. If you want to avoid unnecessary requests, you can adjust the script to reuse old tokens as long as possible.


  • example_server.py: Shows how to create a simple game server with both an authentication server and a secure server.
  • example_server_login.py: Logs in on a game server and disconnects immediately. This can be used to test custom servers (such as example_server.py).

by Kinnay.

No te pierdas nada, síguenos en Twitter o Mastodon!
¿Tienes alguna duda, petición o aporte? Utiliza el foro!

  • Crear nuevo...