## Download

`$ beeper-desktop-cli assets download`

**post** `/v1/assets/download`

Download a Matrix asset using its mxc:// or localmxc:// URL to the device running Beeper Desktop and return the local file URL.

### Parameters

- `--url: string`

  Matrix content URL (mxc:// or localmxc://) for the asset to download.

### Returns

- `AssetDownloadResponse: object { error, srcURL }`

  - `error: optional string`

    Error message if the download failed.

  - `srcURL: optional string`

    Local file URL to the downloaded asset.

### Example

```cli
beeper-desktop-cli assets download \
  --url mxc://example.org/Q4x9CqGz1pB3Oa6XgJ
```