Skip to content

dbxcli_get.md

Latest commit

 

History

History
63 lines (45 loc) · 1.81 KB

dbxcli_get.md

File metadata and controls

63 lines (45 loc) · 1.81 KB
Raw

dbxcli get

Download a file or folder

Synopsis

Download a file or folder from Dropbox.

  • Use --recursive (-r) to download entire directories.
  • Use - as target to write file bytes to stdout. Stdout is byte-clean: all progress and errors go to stderr.
dbxcli get [flags] <source> [<target>]

Examples

  dbxcli get /remote/file.txt ./local-file.txt
  dbxcli get -r /remote/folder ./local-folder
  dbxcli get /backups/src.tgz - | tar tz
  dbxcli get /file.txt - > local-copy.txt

Options

  -h, --help        help for get
  -r, --recursive   Recursively download a folder

Options inherited from parent commands

      --as-member string   Member ID to perform action as
      --output string      Output format: text, json (default "text")
      --timeout duration   Timeout for Dropbox network operations (0 disables; examples: 30s, 2m, 1h)
  -v, --verbose            Enable verbose logging

Command metadata

  • Structured JSON output: yes
  • JSON help manifest: yes
  • Manifest version: 1
  • Auth modes: personal, team-access
  • Dropbox scopes: files.content.read, files.metadata.read
  • Arguments: source (required, dropbox_path), target (optional, local_path, - stream operand)
  • Flag metadata: --output (values: json, text)
  • Stdin/stdout behavior: Use - as the local target to write downloaded file bytes to stdout; diagnostics go to stderr.
  • Result statuses: created, downloaded, existing
  • Result kinds: file, folder
  • JSON contract: docs/json-schema/v1/commands.json#/commands/get
  • JSON success schema: docs/json-schema/v1/commands.schema.json#/$defs/command_get

SEE ALSO

  • dbxcli - Scriptable Dropbox CLI for files, shared links, teams, and automation