How to: Access Dropbox from the command line in Linux

Cloud storage is everywhere in today's multi-device environment where people want to access content across multiple devices wherever they go. Dropbox is the most widely used cloud storage service due to its elegant UI and flawless multi-platform compatibility. There are numerous official or unofficial Dropbox clients available on multiple platforms.

Linux has its own share of Dropbox clients; CLI clients as well as GUI-based clients. Dropbox Uploader is an easy-to-use Dropbox CLI client written in BASH scripting language.

Install and Configure Dropbox Uploader on Linux

To use Dropbox Uploader, download the script and make it executable.

$ wget
$ chmod  x

Make sure that you have installed curl on your system, since Dropbox Uploader runs Dropbox APIs via curl.

To configure Dropbox Uploader, simply run When you run the script for the first time, it will ask you to grant the script access to your Dropbox account.


As instructed above, go to on your web browser, and create a new Dropbox app. Fill in the information of the new app as shown below, and enter the app name as generated by Dropbox Uploader.

After you have created a new app, you will see app key/secret on the next page. Make a note of them.

Enter the app key and secret in the terminal window where is running. will then generate an oAUTH URL (e.g.,

Go to the oAUTH URL generated above on your web browser, and allow access to your Dropbox account.

This completes Dropbox Uploader configuration.

Dropbox Uploader Examples

To list all contents in the top-level directory:

$ ./ list

To list all contents in a specific folder:

$ ./ list Documents/manuals

To upload a local file to a remote Dropbox folder:

$ ./ upload snort.pdf Documents/manuals

To download a remote file from Dropbox to a local file:

$ ./ download Documents/manuals/mysql.pdf ./mysql.pdf

To download an entire remote folder from Dropbox to a local folder:

$ ./ download Documents/manuals ./manuals

To create a new remote folder on Dropbox:

$ ./ mkdir Documents/whitepapers

To delete an entire remote folder (including all its contents) on Dropbox:

$ ./ delete Documents/manuals

Leave a Reply

Your email address will not be published. Required fields are marked *