D
DreamLake

CLI Reference

download

Download a file by path.

dreamlake download --episode <target> --from <path> [-o <output>]

Note: Currently only supports video downloads. Audio, label, and text track downloads are not yet implemented.

Flags

FlagTypeRequiredDescription
--episodestringYesTarget in [namespace@]space[:episode] format
--fromstringYesAsset path (e.g. /camera/front)
-ostringNoOutput file path (default: derived from asset filename)

What Happens

  1. CLI calls GET /assets/video/download on DreamLake Server with namespace, space, and path
  2. DreamLake Server looks up the video, fetches a presigned S3 URL from BSS (/videos/:id/raw)
  3. CLI streams the file from the presigned URL to the output path

Examples

# Download to current directory (filename from asset)
dreamlake download --episode alice@robotics:run-042 --from /camera/front
 
# Download to specific path
dreamlake download --episode alice@robotics:run-042 --from /camera/front -o ./video.mp4