# Metadata
Platforms: desktop, server OS: mac, windows, linux Introduced: 2.0 Security: network
# Syntax
libURLSetFTPListCommand {"LIST" | "NLST"}
# Examples
libURLSetFTPListCommand "NLST"
libURLSetFTPListCommand (the listCommand of this card)
# Description
Use the libURLSetFTPListCommand command to get a simple list of files in an FTP folder.
A URL that ends with a slash (/) designates a directory (rather than a file). An ftp URL to a folder evaluates to a listing of the folder contents. The format of a directory listing depends on which FTP command LiveCode sends to the FTP server. You specify which command to use with the libURLSetFTPListCommand command.
If you specify LIST, directory listings are returned in the same format as the Unix "ls" command and include information such as permissions, owner, size, and last modification date as well as the name of each file or subdirectory. Use this format if you need the additional information about each item in the directory.
If you specify NLST, directory listings consists of a list of names of files and subdirectories, one per line, without the additional information provided in a LIST listing. Use this format if you need a simple list of files and don't want to parse the more complex LIST listing for the file names.
The list command is set to LIST when the application starts up.
>*Important:* FTP servers are not uniform in their response > to a request for a directory listing. Some servers may format > directory listings differently from these descriptions. These are the > most common formats, but they are not universal.
>*Important:* The libURLSetFTPListCommand command is part of the > Internet library. To ensure that the command works in a > standalone application, you must include this > LiveCode custom library when you create your > standalone application. In the Inclusions pane of the > Standalone Application Settings window, make sure the "Internet" > script library is selected.
# Tags
# See
- **keyword:** URL, ftp - **message:** startup, openBackground, preOpenStack, openStack, preOpenCard - **function:** libURLftpCommand, files - **glossary:** server, main stack, handler, message, Standalone Application Settings, standalone application, group, folder, command, application, LiveCode custom library - **library:** Internet library, library