3DS:Rebuild Title Database: Difference between revisions

3DS:Rebuild Title Database (view source)

Revision as of 23:55, 1 June 2023

769 bytes added , 1 year ago

general overhaul to style & wording, make instructions os-agnostic

StarlitSkies

Approver, confirmaccount

398

edits

@@ Line 1: / Line 1: @@
-This guide will guide you in rebuilding the <code>title.db</code> file in your SD card.
+This article will guide you in rebuilding the <code>title.db</code> file in your SD card.
-<code>title.db</code> is a file on both the 3DS SD card and CTR-NAND which contain the entries of all installed 3DS titles in its respective place (eg. The SD card <code>title.db</code> would contain entries of all 3DS titles installed to the SD card). For more information check out [[3dbrew:Title Database|3dbrew]].
+<code>title.db</code> is a file on both the 3DS' SD card and its CTRNAND which contains a list of all installed 3DS titles for its respective place (e.g. The SD card's <code>title.db</code> only has entries for titles installed to the SD card). For more information, check out [[3dbrew:Title Database|3dbrew]].
 === What you need ===
 * The latest release of [https://github.com/wwylele/save3ds/releases save3ds] for your operating system
-* The latest release of [https://www.python.org/downloads/ Python 3]
+* A version of [https://www.python.org/downloads/ Python 3]
-* a 3DS console with boot9strap
+* A 3DS console with custom firmware
 * [https://github.com/ihaveamac/3DS-rom-tools/raw/master/seeddb/seeddb.bin seeddb.bin]
 === Section I - Preparing the files ===
-# Launch GodMode9 by holding START on boot
+# Launch GodMode9 by holding {{B|START}} on boot
 # Navigate into <code>[M:] MEMORY VIRTUAL</code>
-# Press A on <code>boot9.bin</code> then select "Copy to 0:/gm9/out"
+# Press {{B|A}} on <code>boot9.bin</code> then select '''Copy to 0:/gm9/out'''
-# Press A to continue
+# Press {{B|A}} to continue
-# Press B once to return to the main menu
+# Press {{B|B}} once to return to the main menu
 # Navigate into <code>[1:] SYSNAND CTRNAND</code> -> <code>private</code>
-# Press A on <code>movable.sed</code>, then select "Copy to 0:/gm9/out"
+# Press {{B|A}} on <code>movable.sed</code>, then select '''Copy to 0:/gm9/out'''
 # Turn the 3DS off
 # Insert the SD card into your computer
-# Go to https://github.com/ihaveamac/rebuild-title-database
+# Go to [https://github.com/ihaveamac/rebuild-title-database the GitHub repo for Rebuild Title Database]
-# Click the green <big>Code</big> button, then click "Download ZIP" to download it
+# Click the <big><span style="background:#008000">Code</span></big> button, then click '''Download ZIP'''
-# Extract the contents of the <code>.zip</code> into a folder
+# Extract the contents of the downloaded <code>.zip</code> into a folder
-#* Lets call this folder "rebuild folder"
+#* This folder will be referred to as the "rebuild folder" from now on
 # Go to <code>gm9</code> -> <code>out</code> on your SD card
-# Copy <code>movable.sed</code> and <code>boot9.bin</code> to the rebuild folder
+# Copy <code>movable.sed</code> and <code>boot9.bin</code> into the rebuild folder
-# Create a folder called <code>3ds</code> in the user directory (C:/Users/[your username]/)
+# Create a folder called <code>3ds</code> in your user directory
-# Copy <code>seeddb.bin</code> to the <code>3ds</code> folder in that directory
+#* On Windows, the user directory is <code>C:/Users/[your username]/</code>
-# Copy <code>save3ds_fuse.exe</code> from the  save3ds <code>.zip</code> to the rebuild folder
+#* On macOS, the user directory is <code>/Users/[your username]</code>
+#* On Linux, the user directory is <code>/home/[your username]</code> (often shortened to <code>~</code>)
+# Copy <code>seeddb.bin</code> into the new <code>3ds</code> folder
+# Copy <code>save3ds_fuse.exe</code> from the save3ds <code>.zip</code> file into the rebuild folder
 === Section II - Section II ===
+{{info|If you are on Linux, replace <code>py -3</code> with <code>python3</code> in all commands.}}
 # Navigate to the rebuild folder in file explorer
-# Click the Address bar, then replace the address with <code>cmd</code> and press ENTER
+# Hold SHIFT and right-click anywhere in the folder's empty space, then click the option that opens a terminal, PowerShell, or Command Prompt
-#* This should open a command prompt window
+# In this new window, enter the following commands one at a time:
-# In the command prompt, enter the following command: <code>py -3 -mpip install --user -r requirements.txt</code>
+## <code>py -3 -mpip install --user -r requirements.txt</code>
-# Then enter the command: <code>py -3 rebuild-title-database.py -b boot9.bin -m movable.sed -s X: -o out</code>
+## <code>py -3 rebuild-title-database.py -b boot9.bin -m movable.sed -s X: -o out</code>
-#* replace X: with the drive letter of your SD card, which should be inserted into your Computer
+##* replace <code>X:</code> with your SD card's drive letter
-# Next <code>save3ds_fuse --db sdtitle out --import --boot9 boot9.bin --movable movable.sed --sd X:</code>
+## <code>save3ds_fuse --db sdtitle out --import --boot9 boot9.bin --movable movable.sed --sd X:</code>
-#* replace X: with the drive letter of your SD card, which should be inserted into your Computer
+##* replace <code>X:</code> with your SD card's drive letter
-# If you didn't get any errors, your apps should reappear, if not and they appear greyed out in System Settings -> Data Management -> Nintendo 3DS -> Software, run [[3DS:Faketik|faketik]]
+# If you didn't get any errors, your apps should reappear on the HOME Menu immediately
+#* If they only appear in '''System Settings -> Data Management''' and they have an X through their icons there, run [[3DS:Faketik|faketik]].
+#* If they do not appear anywhere in the system, you should [[Checking SD card integrity|check your SD card for errors]] - the apps are likely gone.
 === Troubleshooting ===
 * boot9.bin is missing in <code>[M:] MEMORY VIRTUAL</code>
-** You're not using boot9strap. You should [[3DS:Luma3DS to boot9strap|switch to boot9strap]] or consult the documentation of your bootloader to dump it
+** You are not using boot9strap. You should [[3DS:Luma3DS to boot9strap|switch to boot9strap]] or consult the documentation of the bootloader you use, such as [[3DS:fastboot3DS|fastboot3DS]].
-* Make sure you have boot9.bin and movable.sed in the rebuild folder
+* The first command in Section II gave the error <code>ERROR: Could not open requirements file: [Errno 2] No such file or directory: 'requirements.txt'</code>
-* Make sure the SD card is inserted and you can view and edit its contents
+** Make sure you are in the rebuild folder and that you extracted the contents of <code>rebuild-title-database-master.zip</code> into it.
-* ERROR: Could not open requirements file: [Errno 2] No such file or directory: 'requirements.txt'
+*** Once this is fixed, delete the out folder and try the command again.
-** Make sure you are in the rebuild folder and that you extracted the contents of rebuild-title-database-master.zip in it
+* The second or third command in Section II failed
-** When you fix this, delete the out folder and try the failing command again
+** Make sure you have <code>boot9.bin</code> and <code>movable.sed</code> in the rebuild folder.
+** Make sure the SD card is inserted and you can view and edit its contents.
 [[Category:Nintendo 3DS guides]]