Commands¶

The list of available dropme commands:

cp¶

Copies a file or folder to a different location in the user’s Dropbox.

If the source path is a folder all its content will be copied. If destination path doesn’t exist it will be created.

dropme cp
    [--allow-shared-folder]
    [-r]
    [--allow-ownership-transfer]
    from_path
    to_path

--allow-shared-folder¶: Whether or not allow to copy to a shared folder.

-r, --auto-rename¶: Whether the file should be renamed if there is a name conflict.

--allow-ownership-transfer¶: Allow moves by owner even if it would result in an ownership transfer for the content being moved. This does not apply to copies.

from_path¶: Path to a file or folder in the user’s Dropbox to copy.

to_path¶: Destination path in the users’s Dropbox. Will be createdif does not exist.

This command is provided by the dropme plugin.

df¶

Shows information about space usage of the current user’s account.

dropme df
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--prefix PREFIX]

-f <FORMATTER>, --format <FORMATTER>¶: the output format, defaults to table

-c COLUMN, --column COLUMN¶: specify the column(s) to include, can be repeated

--noindent¶: whether to disable indenting the JSON

--max-width <integer>¶: Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width¶: Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty¶: Print empty table if there is no data to show.

--prefix <PREFIX>¶: add a prefix to all variable names

This command is provided by the dropme plugin.

find¶

Searches for files and folders.

Note: Recent changes may not immediately be reflected in search results due to a short delay in indexing.

dropme find
    [-f {csv,json,table,value,yaml}]
    [-c COLUMN]
    [--quote {all,minimal,none,nonnumeric}]
    [--noindent]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--sort-column SORT_COLUMN]
    [--start START]
    [--max-results MAX_RESULTS]
    [-m {filename,filename_and_content,deleted_filename}]
    [path]
    query

-f <FORMATTER>, --format <FORMATTER>¶: the output format, defaults to table

-c COLUMN, --column COLUMN¶: specify the column(s) to include, can be repeated

--quote <QUOTE_MODE>¶: when to include quotes, defaults to nonnumeric

--noindent¶: whether to disable indenting the JSON

--max-width <integer>¶: Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width¶: Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty¶: Print empty table if there is no data to show.

--sort-column SORT_COLUMN¶: specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--start <START>¶: The starting index within the search results (used for paging). Defaults to 0.

--max-results <MAX_RESULTS>¶: The maximum number of search results to return. Defaults to 100.

-m <MODE>, --mode <MODE>¶: The search mode. Note that searching file content is only available for Dropbox Business accounts.

path¶: The path of the directory to make search in, defaults to the root.

query¶: The string to search for. The search string is split on spaces into multiple tokens. For file name searching, the last token is used for prefix matching (i.e. ‘bat c’ matches ‘bat cave’ but not ‘batman car’).

This command is provided by the dropme plugin.

get¶

Downloads a file at a given local path.

dropme get [--revision REVISION] DROPBOX_FILE [LOCAL_FILE]

--revision <REVISION>¶: The revision of a file.

DROPBOX_FILE¶: The path of the file to download.

LOCAL_FILE¶: The path of the file to save data, defaults to current working directory.

This command is provided by the dropme plugin.

ls¶

Lists directory content.

dropme ls
    [-f {csv,json,table,value,yaml}]
    [-c COLUMN]
    [--quote {all,minimal,none,nonnumeric}]
    [--noindent]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--sort-column SORT_COLUMN]
    [-l]
    [path]

-f <FORMATTER>, --format <FORMATTER>¶: the output format, defaults to table

-c COLUMN, --column COLUMN¶: specify the column(s) to include, can be repeated

--quote <QUOTE_MODE>¶: when to include quotes, defaults to nonnumeric

--noindent¶: whether to disable indenting the JSON

--max-width <integer>¶: Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width¶: Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty¶: Print empty table if there is no data to show.

--sort-column SORT_COLUMN¶: specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

-l, --long-listing¶: Use a long listing format.

path¶: The path of the directory for printing its content. Defaults to the root.

This command is provided by the dropme plugin.

mkdir¶

Creates a folder at a given path.

dropme mkdir [-r] path

-r, --auto-rename¶: Whether the folder should be renamed if there is a name conflict.

path¶: The path of the folder to create.

This command is provided by the dropme plugin.

mv¶

Moves a file or folder to a different location in the user’s Dropbox.

If the source path is a folder all its content will be moved. If destination path doesn’t exist it will be created.

dropme mv
    [--allow-shared-folder]
    [-r]
    [--allow-ownership-transfer]
    from_path
    to_path

--allow-shared-folder¶: Whether or not allow to move to a shared folder.

-r, --auto-rename¶: Whether the file should be renamed if there is a name conflict.

--allow-ownership-transfer¶: Allow moves by owner even if it would result in an ownership transfer for the content being moved. This does not apply to copies.

from_path¶: Path to a file or folder in the user’s Dropbox to move.

to_path¶: Destination path in the users’s Dropbox. Will be createdif does not exist.

This command is provided by the dropme plugin.

put¶

Uploads a file to a specified directory.

If destination directory path doesn’t exist it will be created.

dropme put [-r] [--chunk-size CHUNK_SIZE] file [path]

-r, --auto-rename¶: Whether the file should be renamed if there is a name conflict.

--chunk-size <CHUNK_SIZE>¶: Chunk size of a file content to be uploaded per request in megabytes. Defaults to 10 MB. Note: A single request should not upload more than 150 MB.

file¶: The path to the file to upload.

path¶: The path of the directory to upload file,defaults to the root.

This command is provided by the dropme plugin.

restore¶

Restores file to a specified revision.

dropme restore -r REVISION path

-r <REVISION>, --revision <REVISION>¶: File revision.

path¶: The path to the file to restore.

This command is provided by the dropme plugin.

revs¶

Lists file revisions.

dropme revs
    [-f {csv,json,table,value,yaml}]
    [-c COLUMN]
    [--quote {all,minimal,none,nonnumeric}]
    [--noindent]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--sort-column SORT_COLUMN]
    [-m {path,id}]
    [-l LIMIT]
    path

-f <FORMATTER>, --format <FORMATTER>¶: the output format, defaults to table

-c COLUMN, --column COLUMN¶: specify the column(s) to include, can be repeated

--quote <QUOTE_MODE>¶: when to include quotes, defaults to nonnumeric

--noindent¶: whether to disable indenting the JSON

--max-width <integer>¶: Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width¶: Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty¶: Print empty table if there is no data to show.

--sort-column SORT_COLUMN¶: specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

-m <MODE>, --mode <MODE>¶: The revisions for a given file path or id. Defaults to ‘path’. Note, that in the ‘path’ mode, all revisions at the same file path as the latest file entry are returned. If revisions with the same file id are desired, then mode must be set to ‘id’ (useful to retrieve revisions for a given file across moves or renames).

-l <LIMIT>, --limit <LIMIT>¶: The maximum number of revision entries returned. Defaults to 10.

path¶: The path to the file to get the revisions of.

This command is provided by the dropme plugin.

rm¶

Deletes a file or a folder at a given path.

If the path is a folder, all its content will be deleted too.

dropme rm path

path¶: The path of the file or folder to delete.

This command is provided by the dropme plugin.

status¶

Shows status of a specified file or folder.

dropme status
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--prefix PREFIX]
    [-i]
    [-d]
    [-m]
    path

-f <FORMATTER>, --format <FORMATTER>¶: the output format, defaults to table

-c COLUMN, --column COLUMN¶: specify the column(s) to include, can be repeated

--noindent¶: whether to disable indenting the JSON

--max-width <integer>¶: Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width¶: Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty¶: Print empty table if there is no data to show.

--prefix <PREFIX>¶: add a prefix to all variable names

-i, --include-media-info¶: Show media info for file with photo or video content.

-d, --include-deleted¶: Fetch data for deleted file or folder.

-m, --include-has-members¶: Indicate whether or not file has any explicit shared members

path¶: The path to the file to get metadata.

This command is provided by the dropme plugin.

whoami¶

Shows information about the current user’s account.

dropme whoami
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--prefix PREFIX]
    [-a]

-f <FORMATTER>, --format <FORMATTER>¶: the output format, defaults to table

-c COLUMN, --column COLUMN¶: specify the column(s) to include, can be repeated

--noindent¶: whether to disable indenting the JSON

--max-width <integer>¶: Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width¶: Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty¶: Print empty table if there is no data to show.

--prefix <PREFIX>¶: add a prefix to all variable names

-a, --all¶: Show information about account in more details.

This command is provided by the dropme plugin.