splatnet2statink is a script that uploads battle data from the SplatNet 2 app ("Nintendo Switch Online") to https://stat.ink/, a site for recording, visualizing, and aggregating statistics from Splatoon and Splatoon 2.
(ja) 日本語版セットアップ手順はこちら。
(zh) 中文版的安装说明在这里。
$ python splatnet2statink.py [-M [N]] [-r] [-s] [-t]
The -M flag runs the script in monitoring mode, uploading new battle results as you play matches. The script checks for new battles every N seconds; if no N is provided, the script defaults to 300 (5 minutes).
The -r flag uploads any recent battle records present on SplatNet 2 that haven't been uploaded to stat.ink.
The -s flag blacks out other players' names on the scoreboard result image and doesn't send them to stat.ink.
The -t flag sends the data to stat.ink as a dry run, without uploading, for testing/validation purposes.
Note: Executing the script via ./splatnet2statink.py is also possible on macOS or Linux. If you've downloaded a .zip of this repository using the green "Clone or download" button above (instead of via git clone), the script must first be made executable by running chmod +x splatnet2statink.py.
Running python splatnet2statink.py -M 900 from the command line launches the script in monitoring mode, checking for and uploading battles every 15 minutes.
- Full automation of SplatNet cookie generation/acquisition via user log-in
- Complete battle stats
- Lobby/mode, stage, weapon
- Result, final count/percent, turf inked
- Kills, deaths, assists, specials
- Rank & rank after, level & level after, star levels (★), X Rank & Power
- Battle start & end times
- Ranked power level & league power
- Splatfest title, EXP & power
- Species (Inkling or Octoling)
- Gear/ability recognition, gear & user profile image upload, new Ver. 3.0 & Octo Expansion gear
- Monitoring for new battle results in real-time
- Scoreboard stats, player ranking & battle result image upload
- Non-English language game support
-
Download and install Python. The script supports both Python 3.x and 2.7.x.
If you're on macOS, Python 2.7 comes pre-installed. However, we recommend installing an updated version via Homebrew. Install Homebrew by running the command listed on the website, and then run
brew install python. -
Download the script from the command line (macOS: Terminal; Windows: Command Prompt/PowerShell) by running
git clone https://github.com/frozenpandaman/splatnet2statink.git(requires Git, pre-installed on macOS), or use the green "Clone or download" button above. -
Navigate to the newly-created directory (
cd splatnet2statink/) and install the required Python libraries by runningpip install -r requirements.txt.Note: Python 3.4+ and 2.7.9+, along with all Homebrew versions, automatically include pip. If you're on a lower version (check via
python --version) or the above command doesn't work, install it from the website, or by runningsudo easy_install pipon macOS. -
Running the script for the first time will prompt you to enter your stat.ink API key, which can be found in your profile settings. If you're using the app in a language other than English, you may enter your language code (locale) as well. Alternatively, these settings may be set in system ENV using the
STAT_INK_API_KEY,SPLATNET_COOKIE, andSPLATNET_LANGvariables.
READ THE ENTIRETY OF THE "COOKIE GENERATION" SECTION BELOW BEFORE PROCEEDING. →
-
You will then be asked to navigate to a specific URL on Nintendo.com, log in, and follow simple instructions to obtain your
session_token; this will be used to generate aniksm_sessioncookie. If you are opting against automatic cookie generation, enter "skip" for this step, at which point you will be asked for youriksm_sessioncookie instead (see the mitmproxy instructions).This token (used to access your SplatNet battle results) along with your stat.ink API key and language will automatically be saved into
config.txtfor you. You're now ready to upload battles!
Supports deploy to a free Heroku scheduler that will sync battles automatically.
After you have acquired the API key and Cookie mentioned above, deploy the app to Heroku using the following button.
Enter your API key and Cookie into the corresponding fields. You'll need to choose a unique name for this application. Something like myname-splatnet2statink.
When the deploy completes:
- Click the "Manage App" button at the bottom of the page
- Go to your app in Heroku.
- Click on "Heroku Scheduler" in the "Installed Add-ons" section.
- Click "Add new job"
- Enter the command to run:
python splatnet2statink.py -r - Choose "1 hour" as the frequency. More frequent updates is unnecessary and puts some excess load on Nintendo's servers, especially during times you are not playing. We are trying to be nice to Nintendo..
- Click "Save". The scheduler will now update stat.ink regularly.
Have any questions, issues, or suggestions? Feel free to message me on Twitter or Reddit.
質問があれば、ツイッター(@frozenpandaman)で連絡してください。日本語OK。
Questions regarding heroku deploy should be directed to @martinemde on Github.
If you wish to access SplatNet 2 from your computer rather than via the phone app, navigate to https://app.splatoon2.nintendo.net/home (it should show a forbidden error). Use a cookie editor – such as EditThisCookie for Chrome – to change iksm_session to the value you obtained previously (automatically or via mitmproxy – stored as cookie in config.txt), and refresh the page. If you only want to access SplatNet and don't have a stat.ink API key, simply enter "skip" for this step during setup.
Splatoon 2 stage rotation information (including Salmon Run) and current SplatNet gear are viewable at https://splatoon2.ink/.
For splatnet2statink to work, a cookie known as iksm_session is required to access SplatNet. This cookie may be obtained automatically, using the script, or manually via the app. Please read the following sections carefully to decide whether or not you want to use automatic cookie generation.
Automatic cookie generation involves making a secure request to a non-Nintendo server with minimal, non-identifying information. We aim to be 100% transparent about this and provide in-depth information on security and privacy below. Users who feel uncomfortable with this may opt to manually acquire their cookie instead.
The v1.1.0 update to the Nintendo Switch Online app, released in September 2017, changed the method used to log in to Nintendo accounts, complicating the ability to generate cookies within the script. The update introduced the requirement of a message authentication code, known as f, to verify the authenticity of the login request.
This code is only able to be generated using a key provided within the app. However, this key is sensitive and, if revealed, may assist users looking to use it for malicious purposes. To prevent sharing this key publicly (e.g. distributing it in the script's source code), I've created a small API which will generate an f token given a valid input.
Privacy statement: No identifying information is ever sent to the API server. Usernames and passwords are far removed from where the API comes into play and are never readable by anyone but you. Returned f tokens are never logged or stored and do not contain meaningful information. It is not possible to use either sent or stored data to identify which account/user performed a request, to view any identifying information about a user, or to gain access to an account.
Please read the API documentation wiki page for more information.
Users who decide against automatic cookie generation via their computer may instead generate/retrieve iksm_session cookies from the SplatNet app.
In this case, users must obtain their cookie from their phone by intercepting their device's web traffic and inputting it into splatnet2statink when prompted (or manually inputting it into config.txt). Follow the mitmproxy instructions to obtain and configure your cookie manually. To opt to manually acquire your cookie, enter "skip" when prompted to enter the "use this account" URL.