3DS:FTP

2022-11-04T18:42:52Z

ZCJ: add a recommended ftp client for Linux systems

{{Page WIP}}
'''FTP''' (File Transfer Protocol) is a way to transfer files wirelessly through a network. While New3DS models are capable of performing a similar function with microSD Management, there are a number of downsides to that method:
* microSD Management does not exist on Old3DS models.
* microSD Management is only compatible with Windows.
* microSD Management uses an outdated protocol (SMBv1) that [https://techcommunity.microsoft.com/t5/storage-at-microsoft/stop-using-smb1/ba-p/425858 is now considered to be a security risk]. It is therefore disabled by default on modern installations of Windows.

Luckily, with custom firmware, we can instead use FTP to transfer files wirelessly on both New3DS ''and'' Old3DS.

== What You Need ==

'''On your computer''':
* A working FTP client
** Windows: Use [https://winscp.net/eng/download.php WinSCP]
** macOS: ???
** Linux: Use [https://github.com/masneyb/gftp/releases/latest gFTP]

'''On your 3DS''':
* The latest release of {{GitHub|mtheall/ftpd/releases|ftpd}} (<code>ftpd.cia</code>)
** The normal (unlabelled) version has a GUI while the <code>classic</code> version is entirely text-based
** Download the <code>.3dsx</code> file and place it in the <code>3ds</code> folder if you want to run it from Homebrew Launcher

== Instructions ==

=== Section I - Prep Work ===

# Insert your SD card into your computer
# Copy <code>ftpd.cia</code> to the <code>cias</code> folder on your SD card
#* Create the folder if it does not exist; it is for organization purposes
# Insert your SD card into your 3DS
# Open FBI
# Navigate to <code>SD</code> -> <code>cias</code>
# Press (A) while <code>ftpd.cia</code> is selected, then select <code>Install and delete CIA(s)</code>
# Allow FBI to install the CIA
# Exit FBI
# Ensure your 3DS is connected to the same Internet connection as your computer
# Open ftpd

=== Section II - FTP Client ===

# If you haven't already, install the FTP client for your operating system
# Open the FTP client and fill in the information as follows:
#* File protocol: FTP (''not'' SFTP)
#* Host name/IP address: The IP address displayed on the top screen of the 3DS (e.g. 192.168.0.67)
#** This is a local IP address, so you don't need to censor it if you need assistance
#* Port number: The number after the colon in the IP address displayed on the top screen of the 3DS (usually 5000)
#** If you don't see this option, instead type <code>(ip):(port)</code> into the host name/IP address box, e.g. <code>192.168.0.67:5000</code>
#* Username/password: If you see a checkbox for "Anonymous login", then enable it; otherwise, just leave it blank
# Click "Login" or "Connect"
#* If prompted to enter a username or password, press ENTER to leave it blank

{{success|Your computer is now connected to your 3DS via FTP!}}

[[Category:Nintendo 3DS guides]]

3DS:Editing the HOME Menu

2022-11-04T18:30:49Z

ZCJ: minor spelling and grammar fixes

{{Critical|text=HOME Menu edits are ''not'' the same thing as custom themes; they require significantly more setup/knowledge to create. If you just want to install or create a theme, see [[3DS:Custom themes]].}}

This page will cover how to edit the 3DS HOME Menu. By following this guide, you will be able to:

*Replace text and words on your HOME Menu
*Customize the positions of things like the wireless indicator bar and the time/date display
*Edit your Sleep Mode screen completely
*Change the color of applets and the words that appear when you open them

== Using LayeredFS to customize your HOME Menu ==

{{Info|text=Some things in this guide will require [https://www.color-hex.com/ hexadecimal colors] and [https://en.wikipedia.org/wiki/Coordinate_system knowledge of coordinates.]}}
=== What You Need ===
*[https://mega.nz/#!BhkWnI6a!QA_2cVB9kQKGpQnUlbJ7Llnn4Nm8nu5ucr5Gx_jXh4k Home Menu Rebuilding Tool]
*[https://cdn.discordapp.com/attachments/441119928334942218/988539384225726504/HME_Positions_By_DeKay.CT HME Positions]
*The latest version of [https://mh-nexus.de/en/downloads.php?product=HxD HxD]
*The latest version of [https://github.com/IcySon55/3DLandMSBTeditor/releases/latest MSBT Editor Reloaded]
*The latest version of [https://www.cheatengine.org/download.php Cheat Engine]

===Section I: Prep Work===
{{Info|text=If you can't extract the <code>.7z</code> or <code>.rar</code> filetypes, download and install [https://www.7-zip.org/ 7-Zip] before continuing.}}
#Download and extract the contents of <code>HMRT_Dev_Build_v0.7.7z</code>
#Download and install HxD, or alternatively download and extract the portable version
#Download and extract the contents of the latest <code>MSBT.Editor.Reloaded.rar</code> file
#Download and install the latest version of Cheat Engine
#Download the HME Positions file

===Section II: Obtaining and Decompressing your HomeMenu.cia File===
#Insert your SD Card into your console if you do not already have it in
#Power on your console while holding the START button to open GodMode9
#*Navigate to <code>[1:] SYSNAND CTRNAND</code>
#*Navigate to <code>title</code>
#*Navigate to <code>00040030</code>
#*Navigate to the folder corresponding to your region:
#**USA: <code>00008F02</code>
#**EUR: <code>00009802</code>
#**JPN: <code>00008202</code>
#* Navigate to <code>content</code>
#* Press (A) on the .tmd file → TMD file options... → Build CIA (standard)
#Turn off your system and insert your SD card into your computer
#Navigate to <code>/gm9/out</code> on your SD card
#Rename your dumped .cia file to <code>HomeMenu.cia</code> and place in the same folder as the Home Menu Rebuilding Tool
#*The name of this file will include the name of the folder corresponding to your region above
#Launch the <code>Home Menu Rebuilding Tool.bat</code> file from where you extracted it
# In the newly opened window, press <code>1</code>, let it complete the action, and then press <code>5</code>
===Section III: Editing the HOME Menu and Sleep Mode Screen Text===
#Launch the <code>MsbtEditor.exe</code> file from where you extracted it
#Open <code>/ExtractedRomFS/message/<Region of your console>_<Language of your console>/menu_msbt.LZ</code> in MSBT Editor
#*You may now edit any of the text by selecting a string from the list on the left and editing the text in the top left box
#**Depending on what you edit, your changes may not appear in the places you want them to
#*If you're only wanting to edit the sleep menu text, the strings to edit are as follows:
#**<code>lau_b_shutdown</code>
#**<code>lau_press_pow_u0</code>
#**<code>lau_press_pow_u1</code>
#**<code>lau_press_pow0</code>
#**<code>lau_press_pow1</code>
#**<code>lau_press_pow2</code>
#**<code>lau_press_pow3</code>
#**<code>lau_press_pow4</code>
#**<code>lau_press_pow5</code>
#**<code>lau_press_pow5_flw</code>
#*When you are done, click <code>File</code> in the very top left corner and click <code>Save</code>
===Section IV: Editing the Sleep Mode Screens Colors===
#Launch HxD from wherever you installed or downloaded it
#Open the <code>/ExtractedRomFS/sleep.LZ</code> file in HxD
#*These are the values you can modify:
{| class="wikitable"
!Description
!Bottom Screen
!Top Screen
|-
|Background
|0x00001260
|0x00001CD4
|-
|Background Glow
|0x00001264
|0x00001CD8
|-
|Background Stripes
|0x0000125C
|0x00001CD0
|-
|Header Color
| -
|0x00001D70
|-
|Text Color
|0x000012FC
|0x00001DA4
|-
|Footer Color
|0x0000122C
|0x00001EA8
|-
|Line Color
|0x00001554
|0x00001E24
|-
|Button Text Color
|0x000014D4
| -
|-
|Button Text Mask
|0x000014A0
| -
|-
|Button Color
|0x0000132C 0x000013E4
| -
|-
|Button Glow
|0x00001330 0x000013E8
| -
|}
*To jump to a value, press <code>Ctrl+G</code> and enter everything from the offset value excluding <code>0x</code>
*Each of these values are 3 size offsets, so only edit the next 3 pairs of hex for each offset
*After you are done replacing the hex values with the colors you desire, click <code>File</code> in the top left corner and click <code>Save</code>
===Section V: Editing Applet Colors===
#Open the <code>/ExtractedRomFS/launcher.LZ</code> file in HxD
#*These are the values you can modify;
{| class="wikitable"
!Icon
!Color 1
!Color 2
|-
|Miiverse
|0x00031DA8
|0x00031DAC
|-
|Internet Browser
|0x00031E84
|0x00031E88
|-
|Notifications
|0x00031F60
|0x00031F64
|-
|Friend List
|0x0003203C
|0x00032040
|-
|Game Notes
|0x00032118
|0x0003211C
|}
*To jump to a value, press <code>Ctrl+G</code> and enter everything from the offset value excluding <code>0x</code>
*Each of these values are 3 size offsets, so only edit the next 3 pairs of hex for each offset
*After you are done replacing the hex values with the colors you desire, click <code>File</code> in the top left corner and click <code>Save</code>
*You will need to edit banner colors separately in their own unique files;
**<code>/ExtractedRomFS/3D/BannerAppletFriend.LZ (Friends)</code>
**<code>/ExtractedRomFS/3D/BannerAppletMemo.LZ (Game Notes)</code>
**<code>/ExtractedRomFS/3D/BannerAppletMvs.LZ (Miiverse)</code>
**<code>/ExtractedRomFS/3D/BannerAppletNews.LZ (Notifications)</code>
**<code>/ExtractedRomFS/3D/BannerAppletWeb.LZ (Internet Browser)</code>
*Color offsets for these files are different, they are the same for each file;
{| class="wikitable"
!Color 1
!Color 2
|-
|0x00001D7C
|0x00001D80
|}
*After editing all of your files and replacing all the colors, close HxD
===Section VI: Editing the HUD===
#Launch Cheat Engine from wherever you downloaded or installed it
#Open the file <code>/ExtractedRomFS/hud.LZ</code> in Cheat Engine
#*If an error occurs, just press Okay and continue
#Drag and drop the HME Positions <code>.CT</code> file into the Cheat Engine window
#*You may now edit the color and position values of elements as you please
#*Colors here are not in hexadecimal format, they are in RGB format
#*Refer to the below image for coordinates;
#:[[File:Coordinates.png]]
#*If you want to remove an element, you can edit the position values of the corresponding element to a very high number
#*This does not work for the connection status bar. If you want to remove it, open hud.LZ in HxD and change the following offsets to 00:
#*<code>0x000097E2</code>
#*<code>0x000098A2</code>
#*<code>0x00009962</code>
#*The above are 1 size offsets, so only edit the pair your cursor jumps to when entering the offset value
#*When you are done editing the values, check the box of each one you edited and close Cheat Engine

===Section VII: Using LayeredFS to Apply your Changes===
#Launch the <code>Home Menu Rebuilding Tool.bat</code> file from where you extracted it if it is not already open and press <code>6</code>
#Navigate to the <code>luma</code> folder on your SD card
#Create a folder named <code>titles</code> if it doesn't already exist
#Go into your newly created folder and create another folder with the name corresponding to your region;
#*USA: <code>0004003000008F02</code>
#*EUR: <code>0004003000009802</code>
#*JPN: <code>0004003000008202</code>
#Copy your <code>ExtractedRomFS</code> folder from where you extracted the Home Menu Rebuilding Tool to the <code>/luma/titles/<name according to region above></code> folder
#Rename the <code>ExtractedRomFS</code> folder you just copied to <code>romfs</code>
#Put your SD card into your console
#Power on your console while holding SELECT to bring up the Luma Configuration menu
#Use the D-Pad to scroll down to <code>Enable game patching</code> and press A to enable it if it is not already enabled
#Press START
{{Info|text=You should now see your changes when your console boots. Keep all the files in the Home Menu Rebuilding Tool folder in case you want to make more edits later. If you do want to make edits later, start this guide from Section II step 7 and only press 5.}}

== Credits ==
Thank you to anyone who has helped improve or perfect this guide.

Thank you to whoever made [https://axities.github.io this page.]

[[Category:Nintendo 3DS guides]]

Hacks Guide Wiki - User contributions [en]

3DS:FTP

3DS:Editing the HOME Menu