Skip to content

R-YaTian/ftpd

 
 

Repository files navigation

ftpd

FTP Server for 3DS/Switch/Linux.

Features

  • Appears to work well with a variety of clients.

  • Supports multiple simultaneous clients. The 3DS itself only appears to support enough sockets to perform 4-5 simultaneous data transfers, so it will help if you limit your FTP client to this many parallel requests.

  • Cutting-edge graphics.

  • MODE Z

  • Exit on NDS/3DS with START button

  • Exit on Switch with PLUS button

  • Toggle backlight on NDS/3DS with SELECT button

  • Toggle backlight on Switch with MINUS button

  • Emulation of a /dev/zero (/devZero) device for network performance testing

    • Example retrieve curl ftp://192.168.1.115:5000/devZero -o /dev/zero
    • Example send curl -T /dev/zero ftp://192.168.1.115:5000/devZero

Dear ImGui

ftpd uses Dear ImGui as its graphical backend.

Standard Dear ImGui controller inputs are supported.

  • A
    • Activate/Open/Toggle
    • Tweak value with D-Pad (+ L/R to tweak slower/faster)
  • B
    • Cancel/Close/Exit
  • X
    • Edit text / on-screen keyboard
  • Y
    • Tap: Toggle menu
    • Hold + L/R: Focus windows
  • Left Stick
    • Scroll
    • Move window (when holding Y)
  • D-Pad
    • Move
    • Tweak values (when activated with A)
    • Resize window (when holding Y)

Latest Builds

NDS: https://mtheall.com/~mtheall/ftpd.nds

CIA: https://mtheall.com/~mtheall/ftpd.cia

3DSX: https://mtheall.com/~mtheall/ftpd.3dsx

NRO: https://mtheall.com/~mtheall/ftpd.nro

CIA QR Code

ftpd.cia

Classic Builds

Classic builds use a console instead of Dear ImGui.

CIA: https://mtheall.com/~mtheall/ftpd-classic.cia

3DSX: https://mtheall.com/~mtheall/ftpd-classic.3dsx

NRO: https://mtheall.com/~mtheall/ftpd-classic.nro

CIA QR Code

ftpd-classic.cia

Build and install

You must set up the development environment.

NDS

The following pacman packages are required to build nds/ftpd.nds:

devkitARM
dswifi
libfat-nds
libnds

They are available as part of the nds-dev meta-package.

3DSX

The following pacman packages are required to build 3ds/ftpd.3dsx:

3dstools
devkitARM
libctru

They are available as part of the 3ds-dev meta-package.

Build 3ds/ftpd.3dsx:

make 3dsx

NRO

The following pacman packages are required to build switch/ftpd.nro:

devkitA64
libnx
switch-tools
switch-libzstd

The first three are available as part of the switch-dev meta-package. Additionally, ImageMagick is required for converting assets.

Build switch/ftpd.nro:

make nro

Supported Commands

  • ABOR
  • ALLO (no-op)
  • APPE
  • CDUP
  • CWD
  • DELE
  • FEAT
  • HELP
  • LIST
  • MDTM
  • MKD
  • MLSD
  • MLST
  • MODE
  • NLST
  • NOOP
  • OPTS
  • PASS (no-op)
  • PASV
  • PORT
  • PWD
  • QUIT
  • REST
  • RETR
  • RMD
  • RNFR
  • RNTO
  • SITE
  • SIZE
  • STAT
  • STOR
  • STRU (no-op)
  • SYST
  • TYPE (no-op)
  • USER (no-op)
  • XCUP
  • XCWD
  • XMKD
  • XPWD
  • XRMD

Planned Commands

  • STOU

SITE commands

Command
SITE HELP Show help
SITE USER Set username
SITE PASS Set password
SITE PORT Set port
SITE HOST Set hostname1
SITE DEFLATE [0-9] Set deflate level
SITE MTIME [0|1] Set getMTime2
SITE SAVE Save config

1mDNS hostname not available on NDS

2getMTime only on 3DS. Enabling will give timestamps at the expense of slow listings.

About

FTP Server for 3DS/Switch

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 90.0%
  • C 7.2%
  • CMake 2.0%
  • GLSL 0.8%