Skip to content
whomperPublic

About

FTP for the Atari ST, STE, TT and Falcon: a two-pane GEM client with FTPS on the Falcon and SFTP through a Raspberry Pi.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

588 Commits

Folders and files

Repository files navigation

EFTP

EFTP icon: two folders, a gold one for this Atari and a blue one for the server, with a blue arrow going up to the server and a green one coming down

A two-pane FTP program for the Atari, written in C for GEM, that reaches FTPS and SFTP servers too.

Runs on any ST, STE, TT or Falcon with TOS 1.04 or newer, EmuTOS, MagiC or MiNT, in 640×200 or larger, with about 350 KB free (a 1 MB ST with STinG will do), and STinG, STiK, MiNTnet or MagiC-Net.

Highlights

  • Two panes: this Atari on the left, the server on the right, the transfers below.
  • Drag and drop across, double-click, or Upload and Download in the toolbar.
  • Whole folders both ways, listed in full before the first file goes.
  • A transfer queue with the speed and the time left, and why a file failed.
  • Resume: Stop and Retry go on where a file stopped; a dropped line reconnects.
  • Names TOS can take: long names come down as 8+3; dates kept; text by its extension.
  • FTPS and SFTP: through AERA-Gateway from any Atari, or FTPS by a TT or Falcon itself.
  • A Site Manager with encrypted passwords, and Quick connect for the others.
  • File management on both sides: new folder, rename, delete, permissions on the server.
  • Small: one program for every Atari, about 260 KB, that runs on a 1 MB ST with STinG.

EFTP on a Falcon in 640x480 with 256 colours: the Atari's files on the left, the server's on the right, the transfers below

Getting started

Download the latest release:

File What it is
EFTP.PRG the program, for every Atari
EFTP.HYP the guide, for EHypView or ST-Guide (the Help key)
TLS.OVL, CACERT.PEM, ROOTS.DAT FTPS on a TT or Falcon itself (a Direct connection)
TLSFB.OVL the same TLS for a FireBee (its ColdFire), loaded there instead of TLS.OVL
EFTP.RSC, EFTPNV.RSC, EFTP.ICN, EFTPMK.ICN the desktop icon (EFTPNV.RSC under NVDI's own palette)
  1. Copy EFTP.PRG and EFTP.HYP (and on a TT or Falcon the TLS files; on a FireBee TLSFB.OVL with the two certificate files) into a folder of their own.
  2. Load STinG, or run MiNT with MiNTnet.
  3. Start EFTP, choose Options > Sites (^K), make a site and press Connect.
  4. Press Help for the guide.

Under TOS use FOLDR100.PRG (why); set STinG's Delay for the machine (how).

How it reaches the servers

Plain FTP goes straight from the Atari to the server. For FTPS and SFTP, EFTP can go through AERA-Gateway, the family's gateway on a Raspberry Pi on your home network: the Atari speaks plain FTP to the Pi, and the Pi speaks FTPS or SFTP to the server. It is optional for FTPS on a TT or Falcon, which can make the connection itself (a Direct connection); an ST, and SFTP from any Atari, need it. How to set it up is in the Gateway's README.

Building

sudo apt install gcc-m68k-linux-gnu python3 zip   # no MiNTLib needed
make                         # binary/EFTP.PRG and its files
make help HCP=/path/to/hcp   # binary/EFTP.HYP
make dist                    # a release's files and the zip

More in docs/DEVELOPING.md.

Source

src/      the FTP core
ui/       the GEM program
common/   the family's shared code
tests/    the tests

The rest: docs/DEVELOPING.md.

Tests

make test (more, and the Hatari rigs, in docs/DEVELOPING.md).

Licence

GPL version 2 or later, without any warranty (COPYING). Copyright (C) 2026 AERA | Erez Yaary. It includes BearSSL (MIT) and Mozilla's root certificates (MPL 2.0); the gateway uses paramiko (LGPL 2.1) on the Pi.


Part of AERA for Atari: ECal · EContact · EMail · EFTP · EHypView · ClaudeST · EWeb · EUpdate · 8-bit: EDOS · EFTP_XL · Gateway: AERA-Gateway

About

FTP for the Atari ST, STE, TT and Falcon: a two-pane GEM client with FTPS on the Falcon and SFTP through a Raspberry Pi.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages