Owl Browser
DocsDownload Managementftp_download

ftp_download

Ftp Download

Download a file from an FTP server. Supports authenticated FTP, FTPS (FTP over SSL/TLS), proxy configuration, and Tor anonymization. If no output path is specified, saves to /tmp/owl_downloads/. Returns file path, size, and download timing.

Usage Example

1234567891011
import asyncio
from owl_browser import OwlBrowser, RemoteConfig
# Async usage
async with OwlBrowser(config) as browser:
context = await browser.create_context()
context_id = context["context_id"]
await browser.ftp_download(
url="https://example.com"
)

Parameters

Required

urlstringrequired

FTP URL of the file to download (e.g., 'ftp://ftp.example.com/pub/file.tar.gz').

Optional

output_pathstring

Full path where the file should be saved. If not specified, saves to /tmp/owl_downloads/.

usernamestring

FTP username. Default: anonymous

passwordstring

FTP password. Default: empty

proxy_typeenum
httphttpssocks4socks5+1 more

Type of proxy server.

proxy_hoststring

Proxy server hostname or IP address.

proxy_portstring

Proxy server port number.

proxy_usernamestring

Username for proxy authentication.

proxy_passwordstring

Password for proxy authentication.

use_torboolean

Use built-in Tor proxy. Default: false

timeoutstring

Timeout in milliseconds. Default: 30000

use_sslboolean

Use FTPS (FTP over SSL/TLS). Default: false

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}