Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

3DS:FTP: Difference between revisions

From Hacks Guide Wiki
(add ftp client for macOS, revise ftp client for Linux, grammar/wording/info fixes. as a result of these, page WIP removed.)
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''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 local network. 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.
 
Luckily, with custom firmware, we can instead use FTP to transfer files wirelessly on both New 3DS ''and'' Old 3DS.


== What You Need ==
== What You Need ==
'''On your computer''':
'''On your computer''':
<ul>
* A working FTP client
<li>A working FTP client
** Windows: Use [https://winscp.net/eng/download.php WinSCP]
{{FTP clients}}</li>
** macOS: Use [https://cyberduck.io/download/ Cyberduck]
</ul>
** Linux: Nautilus or Dolphin, the file explorers for GNOME and KDE respectively - if not usable, use [https://github.com/masneyb/gftp/releases/latest gFTP] instead


'''On your 3DS''':
'''On your 3DS''':
* The latest release of {{GitHub|mtheall/ftpd/releases|ftpd}} (any <code>.3dsx</code> or <code>.cia</code>)
* 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
** 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 ===
# 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 ===
=== Section I - Prep Work ===
# Turn the 3DS off
# Insert your SD card into your computer
# Insert your SD card into your computer
# Download one of the four ftpd/ftpd-classic files and move it into the correct place on your SD card
# Copy <code>ftpd.cia</code> to the <code>cias</code> folder on your SD card
#* 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
#* Create the folder if it does not exist, as it is useful for organization purposes
#* 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
# Turn the 3DS on
# Open FBI
Did you choose a <code>.cia</code> or a <code>.3dsx</code> version of ftpd?
# Navigate to <code>SD</code> -> <code>cias</code>
{{#tag:tabber|
# Press (A) while <code>ftpd.cia</code> is selected, then select <code>Install and delete CIA(s)</code>
.cia=
# Allow FBI to install the CIA
<ol start="6">
# Exit FBI
<li>Open FBI and navigate to <code>SD</code> -> <code>cias</code></li>
# Ensure your 3DS is connected to the same Internet connection as your computer
<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>
# Open ftpd
<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 ===
Line 85: Line 46:
#* 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


<big>{{success|Your computer is now connected to your 3DS via FTP!}}</big>
{{success|Your computer is now connected to your 3DS via FTP!}}
 
[[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.

Revision as of 04:12, 11 November 2022

FTP (File Transfer Protocol) is a way to transfer files wirelessly through a local network. 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.

Luckily, with custom firmware, we can instead use FTP to transfer files wirelessly on both New 3DS and Old 3DS.

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 (ftpd.cia)
    • The normal (unlabelled) version has a GUI while the classic version is entirely text-based
    • Download the .3dsx file and place it in the 3ds folder if you want to run it from Homebrew Launcher

Instructions

Section I - Prep Work

  1. Insert your SD card into your computer
  2. Copy ftpd.cia to the cias folder on your SD card
    • Create the folder if it does not exist, as it is useful for organization purposes
  3. Insert your SD card into your 3DS
  4. Open FBI
  5. Navigate to SD -> cias
  6. Press (A) while ftpd.cia is selected, then select Install and delete CIA(s)
  7. Allow FBI to install the CIA
  8. Exit FBI
  9. Ensure your 3DS is connected to the same Internet connection as your computer
  10. 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!