{"id":13563086,"url":"https://github.com/dropbox/dbxcli","last_synced_at":"2025-05-16T02:08:56.594Z","repository":{"id":5642810,"uuid":"50370370","full_name":"dropbox/dbxcli","owner":"dropbox","description":"A command line client for Dropbox built using the Go SDK","archived":false,"fork":false,"pushed_at":"2024-06-27T21:07:39.000Z","size":4239,"stargazers_count":1069,"open_issues_count":101,"forks_count":97,"subscribers_count":37,"default_branch":"master","last_synced_at":"2025-04-08T12:11:12.340Z","etag":null,"topics":["cli","dropbox","golang-application"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dropbox.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-01-25T18:11:34.000Z","updated_at":"2025-04-06T11:16:39.000Z","dependencies_parsed_at":"2024-01-14T03:47:12.443Z","dependency_job_id":"f933944a-95a0-44e6-9cb4-7df847104860","html_url":"https://github.com/dropbox/dbxcli","commit_stats":{"total_commits":219,"total_committers":23,"mean_commits":9.521739130434783,"dds":0.5022831050228311,"last_synced_commit":"dfcfa136ea5799206b4dfc02ef2dedd1b93914dc"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dropbox%2Fdbxcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dropbox%2Fdbxcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dropbox%2Fdbxcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dropbox%2Fdbxcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dropbox","download_url":"https://codeload.github.com/dropbox/dbxcli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254453655,"owners_count":22073617,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","dropbox","golang-application"],"created_at":"2024-08-01T13:01:15.022Z","updated_at":"2025-05-16T02:08:56.192Z","avatar_url":"https://github.com/dropbox.png","language":"Go","readme":"# `dbxcli`: A command line tool for Dropbox users and team admins [UNOFFICIAL]\n\n[![Build Status](https://travis-ci.org/dropbox/dbxcli.svg?branch=master)](https://travis-ci.org/dropbox/dbxcli)\n[![Go Report Card](https://goreportcard.com/badge/github.com/dropbox/dbxcli)](https://goreportcard.com/report/github.com/dropbox/dbxcli)\n\n:warning: WARNING: This project is **NOT official**. What does this mean?\n\n  * There is no formal Dropbox support for this project\n  * Bugs may or may not get fixed\n  * Not all SDK features may be implemented and implemented features may be buggy or incorrect\n\n## Features\n\n  * Supports basic file operations like ls, cp, mkdir, mv (via the Files API)\n  * Supports search\n  * Supports file revisions and file restore\n  * Chunked uploads for large files, paginated listing for large directories\n  * Supports a growing set of Team operations\n\n## Installation\n\nDownload pre-compiled binaries for Mac, Windows and Linux from the [releases](https://github.com/dropbox/dbxcli/releases) page.\n\n### Mac OSX Installation of pre-compiled binaries\nThese instructions aim to help both experts and novice `dbxcli` users. Please submit an issue if they don't work for you.  \n\n1. Make sure you download and place the binary in a folder that's on your `$PATH`.  If you are unsure what this means, go to *step 2*. Otherwise, skip to *step 3*\n2. Create a `bin` directory under your home directory.\n```\n$ mkdir ~/bin\n$ cd ~/bin\n```\n3. Add the following line at the end of your `~/.bash_profile` file.  [Link with instructions](https://natelandau.com/my-mac-osx-bash_profile/) on how to find this file\n```sh\nexport PATH=$PATH:$HOME/bin\n```\n4. Download the `dbxcli` binary for OSX and rename it.  *IMPORTANT:* Check that the tag `v2.1.1` on the URL below is the latest release tag on the [Releases](https://github.com/dropbox/dbxcli/releases) page.\n```sh\n$ wget https://github.com/dropbox/dbxcli/releases/download/v2.1.1/dbxcli-darwin-amd64 \n$ mv dbxcli-darwin-amd64 dbxcli\n```\n5. Finally, make the binary an executable file and you are good to go!\n```\n$ chmod +x dbxcli\n```\n\n### Instructions for building yourself\nFor newcomers the go build process can be a bit arcane, these steps can be followed to build `dbxcli` yourself.\n\n1. Make sure `git`, `go`, and `gox` are installed. \n2. Create a Go folder. For example, `mkdir $HOME/go` or `mkdir $HOME/.go`. Navigate to it.\n3. `go get github.com/dropbox/dbxcli`. That's right, you don't manually clone it, this does it for you.\n4. `cd ~/go/src/github.com/dropbox/dbxcli` (adapt accordingly based on step 2).\n\nNow we need to pause for a second to get development keys. \n\n5. Head to `https://www.dropbox.com/developers/apps` (sign in if necessary) and choose \"Create app\". Use the Dropbox API and give it Full Dropbox access. Name and create the app.\n6. You'll be presented with a dashboard with an \"App key\" and an \"App secret\".\n7. Replace the value for `personalAppKey` in  `root.go` with the key from the webpage.\n8. Replace the value for `personalAppSecret` with the secret from the webpage.\n\nFinally we're ready to build. Run `go build`, and you'll see a `dbxcli` binary has been created in the current directory. Congrats, we're done!\n\n## Usage\n\n`dbxcli` is largely self documenting. Run `dbxcli -h` for a list of supported commands:\n\n```sh\n$ dbxcli --help\nUse dbxcli to quickly interact with your Dropbox, upload/download files,\nmanage your team and more. It is easy, scriptable and works on all platforms!\n\nUsage:\n  dbxcli [command]\n\nAvailable Commands:\n  cp          Copy files\n  du          Display usage information\n  get         Download a file\n  ls          List files\n  mkdir       Create a new directory\n  mv          Move files\n  put         Upload files\n  restore     Restore files\n  revs        List file revisions\n  rm          Remove files\n  search      Search\n  team        Team management commands\n  version     Print version information\n\nFlags:\n      --as-member string   Member ID to perform action as\n  -v, --verbose            Enable verbose logging\n\nUse \"dbxcli [command] --help\" for more information about a command.\n\n$ dbxcli team --help\nTeam management commands\n\nUsage:\n  dbxcli team [command]\n\nAvailable Commands:\n  add-member    Add a new member to a team\n  info          Get team information\n  list-groups   List groups\n  list-members  List team members\n  remove-member Remove member from a team\n\nGlobal Flags:\n      --as-member string   Member ID to perform action as\n  -v, --verbose            Enable verbose logging\n\nUse \"dbxcli team [command] --help\" for more information about a command.\n```\n\nThe `--verbose` option will turn on verbose logging and is useful for debugging.\n\n## Contributing\n\n * Step 1: If you're submitting a non-trivial change, please fill out the [Dropbox Contributor License Agreement](https://opensource.dropbox.com/cla/) first.\n * Step 2: send a [pull request](https://help.github.com/articles/using-pull-requests/)\n * Step 3: Profit!\n \n## Useful Resources\n\n* [Go SDK documentation](https://godoc.org/github.com/dropbox/dropbox-sdk-go-unofficial)\n* [API documentation](https://www.dropbox.com/developers/documentation/http/documentation)\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdropbox%2Fdbxcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdropbox%2Fdbxcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdropbox%2Fdbxcli/lists"}