The multi-purpose utility command-line tool for web services including Dropbox, Dropbox Business, Google, GitHub, etc.
watermint toolbox is licensed under the MIT license. Please see LICENSE.md or LICENSE.txt for more detail.
Please carefully note:
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
Pre-compiled binaries can be found in Latest Release. If you are building directly from the source, please refer BUILD.md.
First, you need to install Homebrew. Please refer the instruction on the official site. Then run following commands to install watermint toolbox.
brew tap watermint/toolbox
brew install toolbox
The watermint toolbox does not collect any information to third-party servers.
The watermint toolbox is for interacting with the services like Dropbox with your account. There is no third-party account involved. The Commands stores API token, logs, files, or reports on your PC storage.
Most sensitive data, such as API token, are saved on your PC storage in obfuscated & made restricted access. However, it's your responsibility to keep those data secret.
Please do not share files, especially the secrets folder under toolbox work path (C:\Users\<your user name>\.toolbox, or $HOME/.toolbox by default).
tbx have various features. Run without an option for a list of supported commands and options.
You can see available commands and options by running executable without arguments like below.
% ./tbx
watermint toolbox xx.x.xxx
==========================
© 2016-2022 Takayuki Okazaki
Licensed under open source licenses. Use the `license` command for more detail.
Tools for Dropbox and Dropbox Business
Usage:
======
./tbx command
Available commands:
===================
| Command | Description | Notes |
|--------------|---------------------------------|-------|
| config | watermint toolbox configuration | |
| file | File operation | |
| filerequest | File request operation | |
| group | Group management | |
| license | Show license information | |
| member | Team member management | |
| sharedfolder | Shared folder | |
| sharedlink | Shared Link of Personal account | |
| team | Dropbox Business Team | |
| teamfolder | Team folder management | |
| version | Show version | |
| Command | Description |
|---|---|
| file compare account | Compare files of two accounts |
| file compare local | Compare local folders and Dropbox folders |
| file copy | Copy files |
| file delete | Delete file or folder |
| file export doc | Export document |
| file export url | Export a document from the URL |
| file import batch url | Batch import files from URL |
| file import url | Import file from the URL |
| file info | Resolve metadata of the path |
| file list | List files and folders |
| file lock acquire | Lock a file |
| file lock all release | Release all locks under the specified path |
| file lock batch acquire | Lock multiple files |
| file lock batch release | Release multiple locks |
| file lock list | List locks under the specified path |
| file lock release | Release a lock |
| file merge | Merge paths |
| file move | Move files |
| file paper append | Append the content to the end of the existing Paper doc |
| file paper create | Create new Paper in the path |
| file paper overwrite | Overwrite existing Paper document |
| file paper prepend | Append the content to the beginning of the existing Paper doc |
| file replication | Replicate file content to the other account |
| file restore all | Restore files under given path |
| file revision download | Download the file revision |
| file revision list | List file revisions |
| file revision restore | Restore the file revision |
| file search content | Search file content |
| file search name | Search file name |
| file share info | Retrieve sharing information of the file |
| file size | Storage usage |
| file sync down | Downstream sync with Dropbox |
| file sync online | Sync online files |
| file sync up | Upstream sync with Dropbox |
| file tag add | Add a tag to the file/folder |
| file tag delete | Delete a tag from the file/folder |
| file tag list | List tags of the path |
| file template apply remote | Apply file/folder structure template to the Dropbox path |
| file template capture remote | Capture file/folder structure as template from Dropbox path |
| file watch | Watch file activities |
| filerequest create | Create a file request |
| filerequest delete closed | Delete all closed file requests on this account. |
| filerequest delete url | Delete a file request by the file request URL |
| filerequest list | List file requests of the individual account |
| job history ship | Ship Job logs to Dropbox path |
| services dropbox user feature | List feature settings for current user |
| services dropbox user info | Retrieve current account info |
| sharedfolder leave | Leave from the shared folder |
| sharedfolder list | List shared folder(s) |
| sharedfolder member add | Add a member to the shared folder |
| sharedfolder member delete | Delete a member from the shared folder |
| sharedfolder member list | List shared folder member(s) |
| sharedfolder mount add | Add the shared folder to the current user's Dropbox |
| sharedfolder mount delete | The current user unmounts the designated folder. |
| sharedfolder mount list | List all shared folders the current user mounted |
| sharedfolder mount mountable | List all shared folders the current user can mount |
| sharedfolder share | Share a folder |
| sharedfolder unshare | Unshare a folder |
| sharedlink create | Create shared link |
| sharedlink delete | Remove shared links |
| sharedlink file list | List files for the shared link |
| sharedlink info | Get information about the shared link |
| sharedlink list | List of shared link(s) |
| teamspace file list | List files and folders in team space |
| util monitor client | Start device monitor client |
| util tidy pack remote | Package remote folder into the zip file |
| Command | Description |
|---|---|
| group add | Create new group |
| group batch add | Bulk adding groups |
| group batch delete | Delete groups |
| group clear externalid | Clear an external ID of a group |
| group delete | Delete group |
| group folder list | Find folders of each group |
| group list | List group(s) |
| group member add | Add a member to the group |
| group member batch add | Bulk add members into groups |
| group member batch delete | Delete members from groups |
| group member batch update | Add or delete members from groups |
| group member delete | Delete a member from the group |
| group member list | List members of groups |
| group rename | Rename the group |
| member batch suspend | Bulk suspend members |
| member batch unsuspend | Bulk unsuspend members |
| member clear externalid | Clear external_id of members |
| member delete | Delete members |
| member detach | Convert Dropbox Business accounts to a Basic account |
| member feature | List member feature settings |
| member file lock all release | Release all locks under the path of the member |
| member file lock list | List locks of the member under the path |
| member file lock release | Release the lock of the path as the member |
| member file permdelete | Permanently delete the file or folder at a given path of the team member. |
| member folder list | Find folders for each member |
| member folder replication | Replicate a folder to another member's personal folder |
| member invite | Invite member(s) |
| member list | List team member(s) |
| member quota list | List team member quota |
| member quota update | Update team member quota |
| member quota usage | List team member storage usage |
| member reinvite | Reinvite invited status members to the team |
| member replication | Replicate team member files |
| member suspend | Suspend a member |
| member unsuspend | Unsuspend a member |
| member update email | Member email operation |
| member update externalid | Update External ID of team members |
| member update invisible | Enable directory restriction to members |
| member update profile | Update member profile |
| member update visible | Disable directory restriction to members |
| team activity batch user | Scan activities for multiple users |
| team activity daily event | Report activities by day |
| team activity event | Event log |
| team activity user | Activities log per user |
| team admin group role add | Add the role to members of the group |
| team admin group role delete | Delete the role from all members except of members of the exception group |
| team admin list | List admin roles of members |
| team admin role add | Add a new role to the member |
| team admin role clear | Remove all admin roles from the member |
| team admin role delete | Remove a role from the member |
| team admin role list | List admin roles of the team |
| team content legacypaper count | Count number of Paper documents per member |
| team content legacypaper export | Export entire team member Paper documents into local path |
| team content legacypaper list | List team member Paper documents |
| team content member list | List team folder & shared folder members |
| team content member size | Count number of members of team folders and shared folders |
| team content mount list | List all mounted/unmounted shared folders of team members. |
| team content policy list | List policies of team folders and shared folders in the team |
| team device list | List all devices/sessions in the team |
| team device unlink | Unlink device sessions |
| team feature | Team feature |
| team filerequest list | List all file requests in the team |
| team info | Team information |
| team linkedapp list | List linked applications |
| team namespace file list | List all files and folders of the team namespaces |
| team namespace file size | List all files and folders of the team namespaces |
| team namespace list | List all namespaces of the team |
| team namespace member list | List members of shared folders and team folders in the team |
| team namespace summary | Report team namespace status summary. |
| team runas file batch copy | Batch copy files/folders as a member |
| team runas file list | List files and folders run as a member |
| team runas file sync batch up | Batch sync up that run as members |
| team runas sharedfolder batch leave | Batch leave from shared folders as a member |
| team runas sharedfolder batch share | Batch share folders for members |
| team runas sharedfolder batch unshare | Batch unshare folders for members |
| team runas sharedfolder isolate | Unshare owned shared folders and leave from external shared folders run as a member |
| team runas sharedfolder list | List shared folders run as the member |
| team runas sharedfolder member batch add | Batch add members to member's shared folders |
| team runas sharedfolder member batch delete | Batch delete members from member's shared folders |
| team runas sharedfolder mount add | Add the shared folder to the specified member's Dropbox |
| team runas sharedfolder mount delete | The specified user unmounts the designated folder. |
| team runas sharedfolder mount list | List all shared folders the specified member mounted |
| team runas sharedfolder mount mountable | List all shared folders the member can mount |
| team sharedlink cap expiry | Set expiry cap to shared links in the team |
| team sharedlink cap visibility | Set visibility cap to shared links in the team |
| team sharedlink delete links | Batch delete shared links |
| team sharedlink delete member | Delete all shared links of the member |
| team sharedlink list | List of shared links |
| team sharedlink update expiry | Update expiration date of public shared links within the team |
| team sharedlink update password | Set or update shared link passwords |
| team sharedlink update visibility | Update visibility of shared links |
| teamfolder add | Add team folder to the team |
| teamfolder archive | Archive team folder |
| teamfolder batch archive | Archiving team folders |
| teamfolder batch permdelete | Permanently delete team folders |
| teamfolder batch replication | Batch replication of team folders |
| teamfolder file list | List files in team folders |
| teamfolder file lock all release | Release all locks under the path of the team folder |
| teamfolder file lock list | List locks in the team folder |
| teamfolder file lock release | Release lock of the path in the team folder |
| teamfolder file size | Calculate size of team folders |
| teamfolder list | List team folder(s) |
| teamfolder member add | Batch adding users/groups to team folders |
| teamfolder member delete | Batch removing users/groups from team folders |
| teamfolder member list | List team folder members |
| teamfolder partial replication | Partial team folder replication to the other team |
| teamfolder permdelete | Permanently delete team folder |
| teamfolder policy list | List policies of team folders |
| teamfolder replication | Replicate a team folder to the other team |
| teamspace asadmin file list | List files and folders in team space run as admin |
| teamspace asadmin folder add | Create top level folder in the team space |
| teamspace asadmin folder delete | Delete top level folder of the team space |
| teamspace asadmin folder permdelete | Permanently delete top level folder of the team space |
| Command | Description |
|---|---|
| services github content get | Get content metadata of the repository |
| services github content put | Put small text content into the repository |
| services github issue list | List issues of the public/private GitHub repository |
| services github profile | Get the authenticated user |
| services github release asset download | Download assets |
| services github release asset list | List assets of GitHub Release |
| services github release asset upload | Upload assets file into the GitHub Release |
| services github release draft | Create release draft |
| services github release list | List releases |
| services github tag create | Create a tag on the repository |
| util release install | Download & install watermint toolbox to the path |
| Command | Description |
|---|---|
| services google calendar event list | List Google Calendar events |
| Command | Description |
|---|---|
| services google mail filter add | Add a filter. |
| services google mail filter batch add | Batch adding/deleting labels with query |
| services google mail filter delete | Delete a filter |
| services google mail filter list | List filters |
| services google mail label add | Add a label |
| services google mail label delete | Delete a label |
| services google mail label list | List email labels |
| services google mail label rename | Rename a label |
| services google mail message label add | Add labels to the message |
| services google mail message label delete | Remove labels from the message |
| services google mail message list | List messages |
| services google mail message processed list | List messages in processed format. |
| services google mail sendas add | Creates a custom "from" send-as alias |
| services google mail sendas delete | Deletes the specified send-as alias |
| services google mail sendas list | Lists the send-as aliases for the specified account |
| services google mail thread list | List threads |
| Command | Description |
|---|---|
| services google sheets sheet append | Append data to a spreadsheet |
| services google sheets sheet clear | Clears values from a spreadsheet |
| services google sheets sheet create | Create a new sheet |
| services google sheets sheet delete | Delete a sheet from the spreadsheet |
| services google sheets sheet export | Export sheet data |
| services google sheets sheet import | Import data into the spreadsheet |
| services google sheets sheet list | List sheets of the spreadsheet |
| services google sheets spreadsheet create | Create a new spreadsheet |
| Command | Description |
|---|---|
| config auth delete | Delete existing auth credential |
| config auth list | List all auth credentials |
| config disable | Disable a feature. |
| config enable | Enable a feature. |
| config features | List available optional features. |
| file template apply local | Apply file/folder structure template to the local path |
| file template capture local | Capture file/folder structure as template from local path |
| job history archive | Archive jobs |
| job history delete | Delete old job history |
| job history list | Show job history |
| job log jobid | Retrieve logs of specified Job ID |
| job log kind | Concatenate and print logs of specified log kind |
| job log last | Print the last job log files |
| license | Show license information |
| util archive unzip | Extract the zip archive file |
| util archive zip | Compress target files into the zip archive |
| util database exec | Execute query on SQLite3 database file |
| util database query | Query SQLite3 database |
| util date today | Display current date |
| util datetime now | Display current date/time |
| util decode base32 | Decode text from Base32 (RFC 4648) format |
| util decode base64 | Decode text from Base64 (RFC 4648) format |
| util encode base32 | Encode text into Base32 (RFC 4648) format |
| util encode base64 | Encode text into Base64 (RFC 4648) format |
| util file hash | Print file digest |
| util git clone | Clone git repository |
| util image exif | Print EXIF metadata of image file |
| util image placeholder | Create placeholder image |
| util net download | Download a file |
| util qrcode create | Create a QR code image file |
| util qrcode wifi | Generate QR code for WIFI configuration |
| util text case down | Print lower case text |
| util text case up | Print upper case text |
| util text encoding from | Convert text encoding to UTF-8 text file from specified encoding. |
| util text encoding to | Convert text encoding to specified encoding from UTF-8 text file. |
| util tidy move dispatch | Dispatch files |
| util tidy move simple | Archive local files |
| util time now | Display current time |
| util unixtime format | Time format to convert the unix time (epoch seconds from 1970-01-01) |
| util unixtime now | Display current time in unixtime |
| util xlsx create | Create an empty spreadsheet |
| util xlsx sheet export | Export data from the xlsx file |
| util xlsx sheet import | Import data into xlsx file |
| util xlsx sheet list | List sheets of the xlsx file |
| version | Show version |