Skip to content
WarpDL

Daemon

WarpDL uses a daemon architecture where a background process manages all downloads.

How It Works

Section titled “How It Works”
CLI Command → Unix Socket/Named Pipe → Daemon → Download Engine

The daemon:

  • Runs in the background
  • Manages multiple concurrent downloads
  • Persists state across CLI sessions
  • Handles retry and resume logic

Starting the Daemon

Section titled “Starting the Daemon”

The daemon starts automatically when you run any download command. To start it manually:

Terminal window
warpdl daemon

Stopping the Daemon

Section titled “Stopping the Daemon”
Terminal window
warpdl stop-daemon

Communication

Section titled “Communication”
PlatformDefault IPC
Linux/macOSUnix socket at $TMPDIR/warpdl.sock (defaults to /tmp/warpdl.sock)
WindowsNamed pipe \\.\pipe\warpdl

To customize the socket path:

Terminal window
export WARPDL_SOCKET_PATH=/custom/path.sock

To force TCP connection:

Terminal window
export WARPDL_FORCE_TCP=1
export WARPDL_TCP_PORT=3849

Daemon as a Service

Section titled “Daemon as a Service”

See Service Setup for running the daemon as a system service.