EShop analysis tool 3DS: Difference between revisions

Revision as of 06:32, 27 July 2021

3DS eShop analysis tool is a python script to help you get deeper insights into the Nintendo 3DS eshops.

This script will scrape the Nintendo 3DS eShops for all available regions (> 200 regions), merge the data, and compare with the 3dsdb and the data from that titlekey site. It gives insights (among others) into what titles are available globally, and what titles have already been archived.

User guide

Requirements

To run this script, you need the following:

An up-to-date installation of Python 3 (at least 3.6.x).
The requests module installed (py -3 -mpip install requests from the command line).

How to run

Run the script the script via py -3 eat.py (or python3 eat.py on unix).

To include information about titlekeys to the results (highly recommended), add -t [TITLEKEYURL] or --titlekeyurl [TITLEKEYURL], whereas [TITLEKEYURL] is the URL (with 'http//') of that titlekeys site.

If you don't want to do this every time, edit titlekeyurl in the source code (it's right at the top).

To add proper title ids and title sizes to the results (highly recommended), you need to provide ctr-common-1.crt and ctr-common-1.key.

To limit the scope of analysed regions (optional), you need to provide -r [REGION] or --region=[REGION], whereas [REGION] is english, main or the two letter country code of a specific region.

Resulting CSV files will be written to the results subdirectory, intermediate dumps will be written to the dumped subdirectory.

Credits

Thanks to ihaveamac for the help and started this by providing the eShop parser function.

@@ Line 3: / Line 3: @@
 | image = https://dlhb.gamebrew.org/3dshomebrew/3DS-eShop-analysis-tool.jpeg|250px
 | type = Utilities
-| version = v1.0
+| version = 1.0 (5 Mar 2018)
 | licence = Mixed
 | author = d0k3
@@ Line 11: / Line 11: @@
 }}
-= 3DS eShop analysis tool =
+DS eShop analysis tool is a python script to help you get deeper insights into the Nintendo 3DS eshops.
-''A python script to help you get deeper insights into the Nintendo 3DS eshops''
-== Requirements ==
+This script will scrape the Nintendo 3DS eShops for all available regions (> 200 regions), merge the data, and compare with the 3dsdb and the data from that titlekey site. It gives insights (among others) into what titles are available globally, and what titles have already been archived.
+==User guide==
+===Requirements===
 To run this script, you need the following:
-* an up-to-date installation of Python 3 (at least 3.6.x)
+* An up-to-date installation of Python 3 (at least 3.6.x).
-* the requests module installed (<code>py -3 -mpip install requests</code> from the command line)
+* The requests module installed (<code>py -3 -mpip install requests</code> from the command line).
-== What it does ==
-This script will scrape the Nintendo 3DS eShops for all available regions (&gt; 200 regions), merge the data, and compare with the [http://www.3dsdb.com/ 3dsdb] and the data from ''that titlekey site''. It gives insights (among others) into what titles are available globally, and what titles have already been archived.
+==How to run==
-== How to run ==
+Run the script the script via <code>py -3 eat.py</code> (or <code>python3 eat.py</code> on unix).
-Just run the script via <code>py -3 eat.py</code> (or <code>python3 eat.py</code> on unix). To include information about titlekeys into the results '''(highly recommended)''', add <code>-t [TITLEKEYURL]</code> or <code>--titlekeyurl [TITLEKEYURL]</code>, whereas <code>[TITLEKEYURL]</code> is the URL (with 'http//') of ''that titlekeys site''. If you don't want to do this every time, you may also edit <code>titlekeyurl</code> in the source code, it's right at the top. To add proper title ids and title sizes to the results '''(also highly recommended)''', you need to provide <code>ctr-common-1.crt</code> and <code>ctr-common-1.key</code>. You may also limit the scope of analysed regions via <code>-r [REGION]</code> or <code>--region=[REGION]</code>, whereas <code>[REGION]</code> is <code>english</code>, <code>main</code> or the two letter country code of a specific region. Resulting CSV files will be written to the <code>results</code> subdirectory, intermediate dumps will be written to the <code>dumped</code> subdirectory.
-== Credits ==
+To include information about titlekeys to the results (highly recommended), add <code>-t [TITLEKEYURL]</code> or <code>--titlekeyurl [TITLEKEYURL]</code>, whereas <code>[TITLEKEYURL]</code> is the URL (with 'http//') of that titlekeys site.
-I actually learnt Python writing this script, and doing so wouldn't have been possible without @ihaveamac's help. @ihaveamac also started this by providing the eShop parser function. Thanks a gigaton!
+If you don't want to do this every time, edit <code>titlekeyurl</code> in the source code (it's right at the top).
+To add proper title ids and title sizes to the results (highly recommended), you need to provide <code>ctr-common-1.crt</code> and <code>ctr-common-1.key</code>.
+To limit the scope of analysed regions (optional), you need to provide <code>-r [REGION]</code> or <code>--region=[REGION]</code>, whereas <code>[REGION]</code> is <code>english</code>, <code>main</code> or the two letter country code of a specific region.
+Resulting CSV files will be written to the <code>results</code> subdirectory, intermediate dumps will be written to the <code>dumped</code> subdirectory.
+==Credits==
+Thanks to ihaveamac for the help and started this by providing the eShop parser function.
+[[Category:3DS homebrew applications]]
+[[Category:PC utilities for 3DS homebrew]]