Skip to main content
Use aspect download to save an ordinary local copy of an asset:
The optional final argument is a local directory, not a new filename. It defaults to your current directory. The CLI creates needed local directories and uses the asset’s filename.

​
Download a folder or project

Folder downloads preserve the directory tree under the selected folder’s name. For example, downloading Footage to ./downloads puts its files under ./downloads/Footage/. The completion message, or the JSON result’s path, reports the local destination. These are copies. Changes to downloaded files do not automatically synchronize with Aspect. Use upload to send a revision back, or mount the project for a live filesystem workflow.

​
Originals, proxies, and previews

The default variant is original. Select another representation with --variant:
See Retrieve proxies and previews for filenames and how missing variants are handled.

​
Existing local files

Skipping an existing path does not verify that its contents match the remote file. Use --replace when you need to refresh an existing copy. Do not combine the two conflict flags.

​
Completion and interruptions

Downloads write to temporary .part files and move them into place when complete. Cancelling a running download removes its in-flight temporary files; a completed filename is not left pointing to a partially downloaded file. Rerunning a download skips existing final files by default. It retries the missing files as a new download rather than continuing a partial file from its previous offset. For a large delivery, run in the background:
Then use transfer status or wait to confirm completion. With --json, the final result contains downloaded, skipped, failed, and the destination path. A directory with no files matching the requested variant can complete with zero downloads, so inspect the count if your workflow expects media.