Skip to main content

FTP

Syntax​

FTP                 url
FTP User            username
FTP Password        password
FTP CD              directory
FTP Put             filename
FTP Loop            seconds
FTP Close

Parameters​

  • url: The URL or IP address of the FTP server to connect to (e.g., runscore.com).
  • username: The user ID for the FTP account.
  • password: The password for the FTP account.
  • directory: The directory to change to on the FTP server.
  • filename: The name of the file to upload. Supports wildcards (e.g., Result*.txt). Multiple FTP Put commands are allowed.
  • seconds: The interval in seconds between repeated uploads when using FTP Loop.

Description​

Uploads files to a remote FTP server. Use these commands together in a listing file to configure the connection and transfer files.

Remarks​

  • The uploading is done in a separate thread, so other parts of RunScore continue to work during the transfer.
  • FTP Put supports wildcards and can appear multiple times to upload multiple files.
  • It is assumed that files to upload are in the RunScore directory (the output of a Destination command). To upload from the race directory, prefix the filename with ~ (e.g., FTP Put ~results.txt).
  • FTP Loop keeps the FTP process running, re-uploading files at the specified interval. A countdown appears in the status line at the bottom of the screen.
  • FTP Close is only needed when using FTP Loop. Without it, FTP remains open until the race is closed. To close it manually, create a separate listing file with just FTP Close and run it.
  • In a single @ file, only one listing file can use FTP to avoid thread conflicts.
  1. Create one listing file that produces the output file (e.g., results.txt via Destination).
  2. Create a second listing file with the FTP commands to upload it.
  3. Test by running both manually.
  4. For continuous uploading, use Auto Run on the first file to regenerate results, and FTP Loop on the second to keep uploading.

Examples​

Upload a file to an FTP server:

FTP                 runscore.com
FTP User            runscore
FTP Password        MyPassword
FTP CD              public_html
FTP Put             results.txt

Upload a file from the race directory with repeated uploads every 2 minutes:

FTP                 runscore.com
FTP User            runscore
FTP Password        MyPassword
FTP CD              public_html
FTP Put             ~results.txt
FTP Loop            120

Close an active FTP loop (in a separate listing file):

FTP Close