Nintendo Clients

:warning: Keep in mind that Nintendo is actively banning Switch devices. This package tries to mimic the behavior of a real Switch as closely as possible, but using it is at your own risk. Make sure that you know what you are doing.

This package implements a client for various 3DS, Wii U and Switch servers. Check out the documentation for the list of servers that are currently supported.

Installation

This package requires Python 3.8 or later and can be installed with pip: pip install nintendoclients.

This package does not have a stable interface yet (it may receive backwards compatibility breaking changes at any time). If you use it in a project, it is recommended to pin a specific version.

Documentation

• Nintendo's servers and protocols
• The classes and functions in this package

Example scripts

• switch/
  • smm2_level.py: Downloads a Super Mario Maker 2 level and its thumbnails, and prints information about both the level and its creator.
  • smm2_ninji.py: Requests the list of ninji courses and downloads a replay file.
  • animalcrossing.py: Searches for an island by dodo code and prints information about it.
    
    
• wiiu/
  • donkeykong.py: Downloads DKC Tropical Freeze rankings and the replay file of the world record.
  • mariokart.py: Downloads Mario Kart 8 rankings and the replay file of whoever is in 500th place.
  • miis.py: Requests all kinds of information about the primary mii associated with a NNID.
  • friends.py: Requests your friend list, incoming and outgoing friend requests, and blacklist.
    
    
• 3ds/
  • friends.py: Changes your comment to 'Hello World'.
    
    
• custom/
  • server.py: Shows how to create a simple game server with both an authentication server and a secure server.
  • server_login.py: Logs in on a game server and disconnects immediately. This can be used to test custom servers.