3DS:FTP: Difference between revisions

From Hacks Guide Wiki
m (friendlier wording / link to article about smb1)
 
(12 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Page WIP}}
'''FTP''' (File Transfer Protocol) is a way to transfer files wirelessly through a local network.
'''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 ==
== What You Need ==
'''On your computer''':
'''On your computer''':
* A working FTP client
<ul>
** Windows: Use [https://winscp.net/eng/download.php WinSCP]
<li>A working FTP client
** macOS: ???
{{FTP clients}}</li>
** Linux: ???
</ul>


'''On your 3DS''':
'''On your 3DS''':
* The latest release of {{GitHub|mtheall/ftpd/releases|ftpd}} (<code>ftpd.cia</code>)
* The latest release of {{GitHub|mtheall/ftpd/releases|ftpd}} (any <code>.3dsx</code> or <code>.cia</code>)
** The normal (unlabelled) version has a GUI while the <code>classic</code> version is entirely text-based
** 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 ==
== Instructions ==
If your 3DS can use the internet, choose the Universal-Updater method.
{{info|1=You may already have this app because of finalizing setup. If so, open it and go to section II.}}


<tabber>
|-|Universal-Updater=
=== Section I - Prep Work ===
=== Section I - Prep Work ===
# Open Universal-Updater
# Tap the magnifying glass icon on the bottom screen, and search for '''ftpd'''
# Press A on the '''ftpd''' entry, and choose one of the four ftpd/ftpd-classic files
# Once it finishes downloading, exit Universal-Updater
Did you choose a <code>.cia</code> or a <code>.3dsx</code> version of ftpd?
{{#tag:tabber|
.cia=
<ol start="5">
<li>Open ftpd</li>
</ol>
{{!}}-{{!}}
.3dsx=
<ol start="5">
<li>Open the Homebrew Launcher</li>
<li>Open ftpd</li>
</ol>
}}


|-|Manual=
=== Section I - Prep Work ===
# Turn the 3DS off
# Insert your SD card into your computer
# Insert your SD card into your computer
# Copy <code>ftpd.cia</code> to the <code>cias</code> folder on your SD card
# Download one of the four ftpd/ftpd-classic files and move it into the correct place on your SD card
#* Create the folder if it does not exist; it is for organization purposes
#* If you chose one of the <code>.cia</code> files, its correct place is the <code>cias</code> folder - create this folder if it does not exist
#* If you chose one of the <code>.3dsx</code> files, its correct place is the <code>3ds</code> folder - create this folder if it does not exist
# Insert your SD card into your 3DS
# Insert your SD card into your 3DS
# Open FBI
# Turn the 3DS on
# Navigate to <code>SD</code> -> <code>cias</code>
Did you choose a <code>.cia</code> or a <code>.3dsx</code> version of ftpd?
# Press (A) while <code>ftpd.cia</code> is selected, then select <code>Install and delete CIA(s)</code>
{{#tag:tabber|
# Allow FBI to install the CIA
.cia=
# Exit FBI
<ol start="6">
# Ensure your 3DS is connected to the same Internet connection as your computer
<li>Open FBI and navigate to <code>SD</code> -> <code>cias</code></li>
# Open ftpd
<li>Press {{B|A}} while <code>ftpd.cia</code> or <code>ftpd-classic.cia</code> is selected, then select <code>Install and delete CIA(s)</code></li>
<li>Allow FBI to install the CIA</li>
<li>Exit FBI, then exit the Homebrew Launcher</li>
<li>Ensure your 3DS is connected to the same Internet connection as your computer</li>
<li>Open ftpd</li>
</ol>
{{!}}-{{!}}
.3dsx=
<ol start="6">
<li>Open the Homebrew Launcher</li>
<li>Open ftpd</li>
</ol>
}}
</tabber>


=== Section II - FTP Client ===
=== Section II - FTP Client ===
# If you haven't already, install the FTP client for your operating system
# If you haven't already, install the FTP client for your operating system
# Open the FTP client and fill in the information as follows:
# Open the FTP client and fill in the information as follows:
Line 49: Line 85:
#* If prompted to enter a username or password, press ENTER to leave it blank
#* 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!}}
<big>{{success|Your computer is now connected to your 3DS via FTP!}}</big>
[[Category:Nintendo 3DS guides]]


[[Category:Nintendo 3DS guides]]
== FAQ ==
 
=== Why not microSD Management? ===
 
While New 3DS models can do a similar method through microSD Management, said method has a number of downsides:
* microSD Management does not exist on Old 3DS models.
* microSD Management uses a protocol (SMBv1) that is only supported by Windows.
** Additionally, SMBv1 is heavily outdated, [https://techcommunity.microsoft.com/t5/storage-at-microsoft/stop-using-smb1/ba-p/425858 now a major security risk], and disabled by default on modern installations of Windows.
* microSD Management can cause random file corruption in use.

Latest revision as of 01:59, 1 December 2023

FTP (File Transfer Protocol) is a way to transfer files wirelessly through a local network.

What You Need

On your computer:

  • A working FTP client
    • Windows: Use WinSCP
    • macOS: Use Cyberduck
    • Linux: Nautilus or Dolphin, the file explorers for GNOME and KDE respectively - if not usable, use gFTP instead

On your 3DS:

  • The latest release of ftpd (any .3dsx or .cia)
    • The normal (unlabelled) version has a GUI while the classic version is entirely text-based

Instructions

If your 3DS can use the internet, choose the Universal-Updater method.

OOjs UI icon information-progressive.svg You may already have this app because of finalizing setup. If so, open it and go to section II.

Section I - Prep Work

  1. Open Universal-Updater
  2. Tap the magnifying glass icon on the bottom screen, and search for ftpd
  3. Press A on the ftpd entry, and choose one of the four ftpd/ftpd-classic files
  4. Once it finishes downloading, exit Universal-Updater

Did you choose a .cia or a .3dsx version of ftpd?

  1. Open ftpd
  1. Open the Homebrew Launcher
  2. Open ftpd

Section I - Prep Work

  1. Turn the 3DS off
  2. Insert your SD card into your computer
  3. Download one of the four ftpd/ftpd-classic files and move it into the correct place on your SD card
    • If you chose one of the .cia files, its correct place is the cias folder - create this folder if it does not exist
    • If you chose one of the .3dsx files, its correct place is the 3ds folder - create this folder if it does not exist
  4. Insert your SD card into your 3DS
  5. Turn the 3DS on

Did you choose a .cia or a .3dsx version of ftpd?

  1. Open FBI and navigate to SD -> cias
  2. Press A while ftpd.cia or ftpd-classic.cia is selected, then select Install and delete CIA(s)
  3. Allow FBI to install the CIA
  4. Exit FBI, then exit the Homebrew Launcher
  5. Ensure your 3DS is connected to the same Internet connection as your computer
  6. Open ftpd
  1. Open the Homebrew Launcher
  2. Open ftpd

Section II - FTP Client

  1. If you haven't already, install the FTP client for your operating system
  2. 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 (ip):(port) into the host name/IP address box, e.g. 192.168.0.67:5000
    • Username/password: If you see a checkbox for "Anonymous login", then enable it; otherwise, just leave it blank
  3. Click "Login" or "Connect"
    • If prompted to enter a username or password, press ENTER to leave it blank

OOjs UI icon information-constructive.svg Your computer is now connected to your 3DS via FTP!

FAQ

Why not microSD Management?

While New 3DS models can do a similar method through microSD Management, said method has a number of downsides:

  • microSD Management does not exist on Old 3DS models.
  • microSD Management uses a protocol (SMBv1) that is only supported by Windows.
    • Additionally, SMBv1 is heavily outdated, now a major security risk, and disabled by default on modern installations of Windows.
  • microSD Management can cause random file corruption in use.