Metadata-Version: 2.4
Name: Splatlogger
Version: 1.5
Summary: A PID/PNID grabber and match logger for Splatoon using TCPGecko.
Author-email: Shadow Doggo <shadowdoggo@protonmail.com>
License-Expression: MIT
Project-URL: Source Code, https://github.com/spoongaming61/Splatlogger
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: userpaths
Requires-Dist: requests
Dynamic: license-file

# Splatlogger
A PID/PNID grabber and match logger for Splatoon using TCPGecko, written in Python.

## Prerequisites
You'll need a modded Wii U running either Tiramisu or Aroma, as well as Python 3.11 or newer installed on your system (on Android devices you can use [Termux](https://termux.com/)).

On Tiramisu, use [TCPGecko](https://github.com/BullyWiiPlaza/tcpgecko) (Geckiine or SDGeckiine will work as well).

On Aroma, install the [TCPGecko Aroma plugin](https://github.com/spoongaming61/TCPGeckoAroma).

## Installation and Usage
Install the package from PyPI:

`python -m pip install Splatlogger`

Or download and install the latest release from GitHub:

`python -m pip install /path/to/Splatlogger-1.x.zip`

Run Splatlogger with `splatlogger -ip IP [options]` (or `python -m splatlogger -ip IP [options]`) where `IP` is your Wii U's LAN IP address.

Alternatively, you can run the script directly from the source code:

`cd /path/to/Splatlogger/src && python -m splatlogger -ip IP [options]`

Options:
- `-log-level [option]` - Set how much data should be logged.
  - `none` - Don't create a log file (default).
  - `basic` - Log only basic player information (name, PID, PNID, region).
  - `full` - Log all player information (basic + team, level, rank, appearance, gear, weapons).
  - `stats` - Log all player information and player stats (points, kills, deaths). Requires the match to end to finish logging.

- `-auto [option]` - Enable auto logging. When enabled will automatically log every match you play (log level must be at least `basic`).
  - `all` - Save a log of all matches you play (default).
  - `latest` - Save a log of only the latest match

- `-aroma` - Enable Aroma mode.

- `-silent` - Disable printing logs to the console.

Logs are saved in `/[User]/Documents/Splatlogger/logs/[Date]`.

To always run with the same IP and options, create an `args.txt` file in `/[User]/Documents/Splatlogger` and put all the arguments in there.
Afterward run Splatlogger without any arguments.

Only one program can be connected to TCPGecko at a time. If you have something else connected, disconnect it beforehand.

## Credits
[pyGecko](https://github.com/wiiudev/pyGecko) authors - tcpgecko.py

Everyone who contributed to [PNIDGrab](https://github.com/JerrySM64/PNIDGrab) and other similar PID grabbers as this is partly based on those.
