Skip to content
WarpDL

Environment Variables

WarpDL can be configured using environment variables. These take precedence over default values.

Connection Settings

Section titled “Connection Settings”
VariableDescriptionDefault
WARPDL_SOCKET_PATHUnix socket path for daemon communication/tmp/warpdl.sock
WARPDL_TCP_PORTTCP port for daemon (1-65535)3849
WARPDL_FORCE_TCPForce TCP instead of Unix socket (set to “1”)false
WARPDL_PIPE_NAMEWindows named pipe namewarpdl

Debug & Logging

Section titled “Debug & Logging”
VariableDescriptionDefault
WARPDL_DEBUGEnable debug logging (set to “1”)false
WARPDL_SUPPRESS_VERSION_CHECKSuppress version check warnings (set to “1”)false

Download Settings

Section titled “Download Settings”
VariableDescriptionDefault
WARPDL_PROXYDefault proxy URL for downloadsnone
WARPDL_TIMEOUTPer-request timeout in seconds30
WARPDL_MAX_RETRIESMaximum retry attempts5
WARPDL_RETRY_DELAYBase retry delay in milliseconds500
WARPDL_DEFAULT_DL_DIRDefault download directorycurrent directory
WARPDL_SPEED_LIMITDefault speed limit (e.g., 1MB, 512KB)unlimited
WARPDL_NO_WORK_STEALDisable work stealing (set to “1”)false
WARP_MAX_PARTSMaximum file segments200
WARP_MAX_CONNMaximum parallel connections24
WARP_FORCE_SEGMENTSForce file segmentation (set to “1”)true

Daemon Connection

Section titled “Daemon Connection”
VariableDescriptionDefault
WARPDL_DAEMON_URIDaemon URI (unix:///path, tcp://host:port, pipe://name)auto-detected

Storage & Security

Section titled “Storage & Security”
VariableDescriptionDefault
WARPDL_CONFIG_DIRConfiguration directory path~/.config/warpdl
WARPDL_COOKIE_KEYCredential encryption key (hex format)auto-generated

Platform-Specific Notes

Section titled “Platform-Specific Notes”

Linux/macOS

Section titled “Linux/macOS”
  • WARPDL_SOCKET_PATH is used for IPC by default
  • Set WARPDL_FORCE_TCP=1 to use TCP instead

Windows

Section titled “Windows”
  • WARPDL_PIPE_NAME is used for named pipe IPC
  • Falls back to TCP if named pipes fail