Splatlogger 1.5.2__tar.gz → 1.6__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,100 @@
1
+ Metadata-Version: 2.4
2
+ Name: Splatlogger
3
+ Version: 1.6
4
+ Summary: A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon.
5
+ Author-email: Shadow Doggo <shadowdoggo@protonmail.com>
6
+ License-Expression: MIT
7
+ Project-URL: Source Code, https://codeberg.org/ShadowDoggo/Splatlogger
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: Operating System :: OS Independent
10
+ Requires-Python: >=3.11
11
+ Description-Content-Type: text/markdown
12
+ Requires-Dist: userpaths
13
+ Requires-Dist: requests
14
+ Requires-Dist: psutil
15
+ Requires-Dist: pymemoryeditor
16
+
17
+ # Splatlogger
18
+ A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon, written in Python.
19
+
20
+ ## Prerequisites
21
+ To install the package, you'll need to have Python 3.11 or newer installed on your system
22
+ (on Android devices you can use Termux).
23
+ Python is not required for the Windows executable.
24
+
25
+ Both the Wii U and Cemu (Windows and Linux only) are supported.
26
+
27
+ Your Wii U will need to have either the Tiramisu or Aroma environment set up or have another way to run homebrew
28
+ (e.g. Haxchi, browser exploit).
29
+
30
+ On Tiramisu, use [TCPGecko](https://github.com/BullyWiiPlaza/tcpgecko) (Geckiine or SDGeckiine will work as well).
31
+
32
+ On Aroma, install the [TCPGecko Aroma plugin](https://codeberg.org/ShadowDoggo/TCPGeckoAroma).
33
+
34
+ ## Installation
35
+ To install the package from PyPI, run:
36
+ ```
37
+ python -m pip install Splatlogger
38
+ ```
39
+
40
+ Or download the latest release from GitHub and run:
41
+ ```
42
+ python -m pip install /path/to/Splatlogger-1.x.zip
43
+ ```
44
+
45
+ On Windows, use the executable provided on the releases page.
46
+ Though if you already have Python installed, it's recommended to use the package.
47
+
48
+ If you do have Python installed but do not wish to install the package, you can run the module directly from the source code:
49
+ ```
50
+ cd /path/to/Splatlogger-1.x/src && python -m splatlogger
51
+ ```
52
+
53
+ ## Usage
54
+ Run Splatlogger with:
55
+ ```
56
+ python -m splatlogger -ip IP [options]
57
+ ```
58
+ where `IP` is your Wii U's LAN IP address
59
+ (if you have your scripts directory in your PATH, you can omit `python -m`).
60
+
61
+ If using the Windows executable, run:
62
+ ```
63
+ /path/to/Splatlogger-1.x.exe -ip IP [options]
64
+ ```
65
+
66
+ Options:
67
+ - `-log-level [option]` - Set how much data should be logged.
68
+ - `none` - Don't create a log file.
69
+ - `standard` - Log only basic player information, the same as what's printed to the console (default).
70
+ - `extended` - Log all player information and additional match information.
71
+ - `stats` - Same as above with the addition of player stats (points, K/D). Requires the match to end to finish logging.
72
+
73
+ - `-auto [option]` - Enable auto logging. When enabled will automatically log every match you play (log level must be at least `standard`).
74
+ - `all` - Save a log of all matches you play (default).
75
+ - `latest` - Save a log of only the latest match.
76
+
77
+ - `-aroma` - Switch to Aroma mode. Enable if using the TCPGecko Aroma plugin.
78
+
79
+ - `-cemu [PID]` - Switch to Cemu mode. The `-ip` argument is not required and will be ignored.
80
+ - `PID` - PID of the Cemu process (optional).
81
+
82
+ - `-stack Address (in hex)` - (Cemu only) Beginning address of the stack space for Default Core 1 (Debug > View PPC threads).
83
+ Reuired for logging stats, not needed otherwise.
84
+
85
+ <img src="stack.png" width="600" alt="(example)">
86
+
87
+ - `-silent` - Disable printing logs to the console.
88
+
89
+ Logs are saved in `/[User]/Documents/Splatlogger/logs/[Date]`.
90
+
91
+ To always run with the same IP and options without having to type them in manually, create an `args.txt` file in
92
+ `/[User]/Documents/Splatlogger` and put the arguments following `splatlogger` in there.
93
+ Afterward any arguments passed through the command line will be ignored.
94
+
95
+ Only one program can be connected to TCPGecko at a time. If you have something else connected, disconnect it beforehand.
96
+
97
+ ## Credits
98
+ - [pyGecko](https://github.com/wiiudev/pyGecko) authors for most of `tcpgecko.py`.
99
+
100
+ - Everyone who contributed to [PNIDGrab](https://github.com/JerrySM64/PNIDGrab) and other similar PID grabbers as those were used as a reference.
@@ -0,0 +1,84 @@
1
+ # Splatlogger
2
+ A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon, written in Python.
3
+
4
+ ## Prerequisites
5
+ To install the package, you'll need to have Python 3.11 or newer installed on your system
6
+ (on Android devices you can use Termux).
7
+ Python is not required for the Windows executable.
8
+
9
+ Both the Wii U and Cemu (Windows and Linux only) are supported.
10
+
11
+ Your Wii U will need to have either the Tiramisu or Aroma environment set up or have another way to run homebrew
12
+ (e.g. Haxchi, browser exploit).
13
+
14
+ On Tiramisu, use [TCPGecko](https://github.com/BullyWiiPlaza/tcpgecko) (Geckiine or SDGeckiine will work as well).
15
+
16
+ On Aroma, install the [TCPGecko Aroma plugin](https://codeberg.org/ShadowDoggo/TCPGeckoAroma).
17
+
18
+ ## Installation
19
+ To install the package from PyPI, run:
20
+ ```
21
+ python -m pip install Splatlogger
22
+ ```
23
+
24
+ Or download the latest release from GitHub and run:
25
+ ```
26
+ python -m pip install /path/to/Splatlogger-1.x.zip
27
+ ```
28
+
29
+ On Windows, use the executable provided on the releases page.
30
+ Though if you already have Python installed, it's recommended to use the package.
31
+
32
+ If you do have Python installed but do not wish to install the package, you can run the module directly from the source code:
33
+ ```
34
+ cd /path/to/Splatlogger-1.x/src && python -m splatlogger
35
+ ```
36
+
37
+ ## Usage
38
+ Run Splatlogger with:
39
+ ```
40
+ python -m splatlogger -ip IP [options]
41
+ ```
42
+ where `IP` is your Wii U's LAN IP address
43
+ (if you have your scripts directory in your PATH, you can omit `python -m`).
44
+
45
+ If using the Windows executable, run:
46
+ ```
47
+ /path/to/Splatlogger-1.x.exe -ip IP [options]
48
+ ```
49
+
50
+ Options:
51
+ - `-log-level [option]` - Set how much data should be logged.
52
+ - `none` - Don't create a log file.
53
+ - `standard` - Log only basic player information, the same as what's printed to the console (default).
54
+ - `extended` - Log all player information and additional match information.
55
+ - `stats` - Same as above with the addition of player stats (points, K/D). Requires the match to end to finish logging.
56
+
57
+ - `-auto [option]` - Enable auto logging. When enabled will automatically log every match you play (log level must be at least `standard`).
58
+ - `all` - Save a log of all matches you play (default).
59
+ - `latest` - Save a log of only the latest match.
60
+
61
+ - `-aroma` - Switch to Aroma mode. Enable if using the TCPGecko Aroma plugin.
62
+
63
+ - `-cemu [PID]` - Switch to Cemu mode. The `-ip` argument is not required and will be ignored.
64
+ - `PID` - PID of the Cemu process (optional).
65
+
66
+ - `-stack Address (in hex)` - (Cemu only) Beginning address of the stack space for Default Core 1 (Debug > View PPC threads).
67
+ Reuired for logging stats, not needed otherwise.
68
+
69
+ <img src="stack.png" width="600" alt="(example)">
70
+
71
+ - `-silent` - Disable printing logs to the console.
72
+
73
+ Logs are saved in `/[User]/Documents/Splatlogger/logs/[Date]`.
74
+
75
+ To always run with the same IP and options without having to type them in manually, create an `args.txt` file in
76
+ `/[User]/Documents/Splatlogger` and put the arguments following `splatlogger` in there.
77
+ Afterward any arguments passed through the command line will be ignored.
78
+
79
+ Only one program can be connected to TCPGecko at a time. If you have something else connected, disconnect it beforehand.
80
+
81
+ ## Credits
82
+ - [pyGecko](https://github.com/wiiudev/pyGecko) authors for most of `tcpgecko.py`.
83
+
84
+ - Everyone who contributed to [PNIDGrab](https://github.com/JerrySM64/PNIDGrab) and other similar PID grabbers as those were used as a reference.
@@ -4,16 +4,18 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "Splatlogger"
7
- version = "1.5.2"
7
+ version = "1.6"
8
8
  authors = [
9
9
  { name="Shadow Doggo", email="shadowdoggo@protonmail.com" }
10
10
  ]
11
- description = "A PID/PNID grabber and match logger for Splatoon using TCPGecko."
11
+ description = "A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon."
12
12
  readme = "README.md"
13
13
  requires-python = ">=3.11"
14
14
  dependencies = [
15
15
  "userpaths",
16
- "requests"
16
+ "requests",
17
+ "psutil",
18
+ "pymemoryeditor"
17
19
  ]
18
20
  classifiers = [
19
21
  "Programming Language :: Python :: 3",
@@ -23,7 +25,7 @@ license = "MIT"
23
25
  license-files = ["LICENSE"]
24
26
 
25
27
  [project.urls]
26
- "Source Code" = "https://github.com/spoongaming61/Splatlogger"
28
+ "Source Code" = "https://codeberg.org/ShadowDoggo/Splatlogger"
27
29
 
28
30
  [project.scripts]
29
31
  splatlogger = "splatlogger.__main__:main"
@@ -0,0 +1,100 @@
1
+ Metadata-Version: 2.4
2
+ Name: Splatlogger
3
+ Version: 1.6
4
+ Summary: A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon.
5
+ Author-email: Shadow Doggo <shadowdoggo@protonmail.com>
6
+ License-Expression: MIT
7
+ Project-URL: Source Code, https://codeberg.org/ShadowDoggo/Splatlogger
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: Operating System :: OS Independent
10
+ Requires-Python: >=3.11
11
+ Description-Content-Type: text/markdown
12
+ Requires-Dist: userpaths
13
+ Requires-Dist: requests
14
+ Requires-Dist: psutil
15
+ Requires-Dist: pymemoryeditor
16
+
17
+ # Splatlogger
18
+ A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon, written in Python.
19
+
20
+ ## Prerequisites
21
+ To install the package, you'll need to have Python 3.11 or newer installed on your system
22
+ (on Android devices you can use Termux).
23
+ Python is not required for the Windows executable.
24
+
25
+ Both the Wii U and Cemu (Windows and Linux only) are supported.
26
+
27
+ Your Wii U will need to have either the Tiramisu or Aroma environment set up or have another way to run homebrew
28
+ (e.g. Haxchi, browser exploit).
29
+
30
+ On Tiramisu, use [TCPGecko](https://github.com/BullyWiiPlaza/tcpgecko) (Geckiine or SDGeckiine will work as well).
31
+
32
+ On Aroma, install the [TCPGecko Aroma plugin](https://codeberg.org/ShadowDoggo/TCPGeckoAroma).
33
+
34
+ ## Installation
35
+ To install the package from PyPI, run:
36
+ ```
37
+ python -m pip install Splatlogger
38
+ ```
39
+
40
+ Or download the latest release from GitHub and run:
41
+ ```
42
+ python -m pip install /path/to/Splatlogger-1.x.zip
43
+ ```
44
+
45
+ On Windows, use the executable provided on the releases page.
46
+ Though if you already have Python installed, it's recommended to use the package.
47
+
48
+ If you do have Python installed but do not wish to install the package, you can run the module directly from the source code:
49
+ ```
50
+ cd /path/to/Splatlogger-1.x/src && python -m splatlogger
51
+ ```
52
+
53
+ ## Usage
54
+ Run Splatlogger with:
55
+ ```
56
+ python -m splatlogger -ip IP [options]
57
+ ```
58
+ where `IP` is your Wii U's LAN IP address
59
+ (if you have your scripts directory in your PATH, you can omit `python -m`).
60
+
61
+ If using the Windows executable, run:
62
+ ```
63
+ /path/to/Splatlogger-1.x.exe -ip IP [options]
64
+ ```
65
+
66
+ Options:
67
+ - `-log-level [option]` - Set how much data should be logged.
68
+ - `none` - Don't create a log file.
69
+ - `standard` - Log only basic player information, the same as what's printed to the console (default).
70
+ - `extended` - Log all player information and additional match information.
71
+ - `stats` - Same as above with the addition of player stats (points, K/D). Requires the match to end to finish logging.
72
+
73
+ - `-auto [option]` - Enable auto logging. When enabled will automatically log every match you play (log level must be at least `standard`).
74
+ - `all` - Save a log of all matches you play (default).
75
+ - `latest` - Save a log of only the latest match.
76
+
77
+ - `-aroma` - Switch to Aroma mode. Enable if using the TCPGecko Aroma plugin.
78
+
79
+ - `-cemu [PID]` - Switch to Cemu mode. The `-ip` argument is not required and will be ignored.
80
+ - `PID` - PID of the Cemu process (optional).
81
+
82
+ - `-stack Address (in hex)` - (Cemu only) Beginning address of the stack space for Default Core 1 (Debug > View PPC threads).
83
+ Reuired for logging stats, not needed otherwise.
84
+
85
+ <img src="stack.png" width="600" alt="(example)">
86
+
87
+ - `-silent` - Disable printing logs to the console.
88
+
89
+ Logs are saved in `/[User]/Documents/Splatlogger/logs/[Date]`.
90
+
91
+ To always run with the same IP and options without having to type them in manually, create an `args.txt` file in
92
+ `/[User]/Documents/Splatlogger` and put the arguments following `splatlogger` in there.
93
+ Afterward any arguments passed through the command line will be ignored.
94
+
95
+ Only one program can be connected to TCPGecko at a time. If you have something else connected, disconnect it beforehand.
96
+
97
+ ## Credits
98
+ - [pyGecko](https://github.com/wiiudev/pyGecko) authors for most of `tcpgecko.py`.
99
+
100
+ - Everyone who contributed to [PNIDGrab](https://github.com/JerrySM64/PNIDGrab) and other similar PID grabbers as those were used as a reference.
@@ -1,4 +1,3 @@
1
- LICENSE
2
1
  README.md
3
2
  pyproject.toml
4
3
  src/Splatlogger.egg-info/PKG-INFO
@@ -9,6 +8,7 @@ src/Splatlogger.egg-info/requires.txt
9
8
  src/Splatlogger.egg-info/top_level.txt
10
9
  src/splatlogger/__init__.py
11
10
  src/splatlogger/__main__.py
11
+ src/splatlogger/cemu_gecko.py
12
12
  src/splatlogger/data.py
13
13
  src/splatlogger/match_logger.py
14
14
  src/splatlogger/tcpgecko.py
@@ -0,0 +1,4 @@
1
+ userpaths
2
+ requests
3
+ psutil
4
+ pymemoryeditor