Droxul -- Dropbox Uploader is a **BASH** script which can be used to upload, download, delete, list files (and more!) from **Dropbox**, an online file sharing, synchronization and backup service.
A Command-line tool to access Dropbox for linux and GitBash
# Install
npm i droxul --g
droxul
# You should be asked/being forwarded for your API key generator on the Dropbox site
## Or go to: https://www.dropbox.com/developers/apps
# Access token:
#upload
droxul upload mybackup.tar.gz /backups/mybackup.tar.gz
droxul list /
droxul download /backups/mybackup.tar.gz
# ... Type only droxul on the prompt
Dropbox Uploader v1.0
Andrea Fabrizi - andrea.fabrizi@gmail.com
Packaged and distributed by: Guillaume Descoteaux-Isabelle,2018-2020
Usage: droxul [PARAMETERS] COMMAND...
Commands:
upload <LOCAL_FILE/DIR ...> <REMOTE_FILE/DIR>
download <REMOTE_FILE/DIR> [LOCAL_FILE/DIR]
delete <REMOTE_FILE/DIR>
move <REMOTE_FILE/DIR> <REMOTE_FILE/DIR>
copy <REMOTE_FILE/DIR> <REMOTE_FILE/DIR>
mkdir <REMOTE_DIR>
list [REMOTE_DIR]
monitor [REMOTE_DIR] [TIMEOUT]
share <REMOTE_FILE>
saveurl <URL> <REMOTE_DIR>
search <QUERY>
info
space
unlink
Optional parameters:
-f <FILENAME> Load the configuration file from a specific file
-s Skip already existing files when download/upload. Default: Overwrite
-d Enable DEBUG mode
-q Quiet mode. Don't show messages
-h Show file sizes in human readable format
-p Show cURL progress meter
-k Doesn't check for SSL certificates (insecure)
-x Ignores/excludes directories or files from syncing. -x filename -x directoryname. example: -x .git
For more info and examples, please see the README file.
Dropbox Uploader is a BASH script which can be used to upload, download, delete, list files (and more!) from Dropbox, an online file sharing, synchronization and backup service.
It's written in BASH scripting language and only needs cURL.
You can take a look to the GiHub project page.
Why use this script?
cURL (curl is a tool to transfer data from or to a server, available for all operating systems and installed by default in many linux distributions).Please refer to the Wiki for tips and additional information about this project. The Wiki is also the place where you can share your scripts and examples related to Dropbox Uploader.
First, clone the repository using git (recommended):
git clone https://github.com/andreafabrizi/Dropbox-Uploader.git
or download the script manually using this command:
curl "https://raw.githubusercontent.com/andreafabrizi/Dropbox-Uploader/master/dropbox_uploader.sh" -o dropbox_uploader.sh
Then give the execution permission to the script and run it:
$chmod +x dropbox_uploader.sh
$./dropbox_uploader.sh
The first time you run dropbox_uploader, you'll be guided through a wizard in order to configure access to your Dropbox. This configuration will be stored in ~/.dropbox_uploader.
The syntax is quite simple:
./dropbox_uploader.sh [PARAMETERS] COMMAND...
[%%]: Optional param
<%%>: Required param
Available commands:
upload <LOCAL_FILE/DIR ...> <REMOTE_FILE/DIR>
Upload a local file or directory to a remote Dropbox folder.
If the file is bigger than 150Mb the file is uploaded using small chunks (default 50Mb);
in this case a . (dot) is printed for every chunk successfully uploaded and a * (star) if an error
occurs (the upload is retried for a maximum of three times).
Only if the file is smaller than 150Mb, the standard upload API is used, and if the -p option is specified
the default curl progress bar is displayed during the upload process.
The local file/dir parameter supports wildcards expansion.
download <REMOTE_FILE/DIR> [LOCAL_FILE/DIR]
Download file or directory from Dropbox to a local folder
delete <REMOTE_FILE/DIR>
Remove a remote file or directory from Dropbox
move <REMOTE_FILE/DIR> <REMOTE_FILE/DIR>
Move or rename a remote file or directory
copy <REMOTE_FILE/DIR> <REMOTE_FILE/DIR>
Copy a remote file or directory
mkdir <REMOTE_DIR>
Create a remote directory on Dropbox
list [REMOTE_DIR]
List the contents of the remote Dropbox folder
monitor [REMOTE_DIR] [TIMEOUT]
Monitor the remote Dropbox folder for changes. If timeout is specified, at the first change event the function will return.
share <REMOTE_FILE>
Get a public share link for the specified file or directory
saveurl <URL> <REMOTE_DIR>
Download a file from an URL to a Dropbox folder directly (the file is NOT downloaded locally)
search <QUERY> Search for a specific pattern on Dropbox and returns the list of matching files or directories
info
Print some info about your Dropbox account
space Print some info about the space usage on your Dropbox account
unlink
Unlink the script from your Dropbox account
Optional parameters:
-f <FILENAME>
Load the configuration file from a specific file
-s
Skip already existing files when download/upload. Default: Overwrite
-d
Enable DEBUG mode
-q
Quiet mode. Don't show progress meter or messages
-h
Show file sizes in human readable format
-p
Show cURL progress meter
-k
Doesn't check for SSL certificates (insecure)
-x <FILENAME>
Ignores/excludes directories or files from syncing.
-x filename -x directoryname.
Examples:
./dropbox_uploader.sh upload /etc/passwd /myfiles/passwd.old
./dropbox_uploader.sh upload *.zip /
./dropbox_uploader.sh -x .git upload ./project /
./dropbox_uploader.sh download /backup.zip
./dropbox_uploader.sh delete /backup.zip
./dropbox_uploader.sh mkdir /myDir/
./dropbox_uploader.sh upload "My File.txt" "My File 2.txt"
./dropbox_uploader.sh share "My File.txt"
./dropbox_uploader.sh list
If you have successfully tested this script on others systems or platforms please let me know!
Dropbox Uploader relies on a different configuration file for each system user. The default configuration file location is $HOME/.dropbox_uploader. This means that if you setup the script with your user and then you try to run a cron job as root, it won't work.
So, when running this script using cron, please keep in mind the following:
To use a proxy server, just set the https_proxy environment variable:
Linux:
export HTTP_PROXY_USER=XXXX
export HTTP_PROXY_PASSWORD=YYYY
export https_proxy=http://192.168.0.1:8080
BSD:
setenv HTTP_PROXY_USER XXXX
setenv HTTP_PROXY_PASSWORD YYYY
setenv https_proxy http://192.168.0.1:8080
Debian & Ubuntu Linux:
sudo apt-get install bash (Probably BASH is already installed on your system)
sudo apt-get install curl
BSD:
cd /usr/ports/shells/bash && make install clean
cd /usr/ports/ftp/curl && make install clean
Cygwin:
You need to install these packages:
Before running the script, you need to convert it using the dos2unix command.
Build cURL from source:
DropShell is an interactive DropBox shell, based on DropBox Uploader:
DropShell v0.2
The Intractive Dropbox SHELL
Andrea Fabrizi - andrea.fabrizi@gmail.com
Type help for the list of the available commands.
andrea@Dropbox:/$ ls
[D] 0 Apps
[D] 0 Camera Uploads
[D] 0 Public
[D] 0 scripts
[D] 0 Security
[F] 105843 notes.txt
andrea@DropBox:/ServerBackup$ get notes.txt
First build the docker image:
docker build https://github.com/sircuri/Dropbox-Uploader.git -f Dockerfile -t <TAG>
or for RaspBerry:
docker build https://github.com/sircuri/Dropbox-Uploader.git -f Dockerfile.pi -t <TAG>
then, you can run it as following:
docker run -i --rm --user=$(id -u):$(id -g) -v <LOCAL_CONFIG_PATH>:/config -v <YOUR_DATA_DIR_MOUNT>:/workdir <TAG> <Arguments>
This will store the auth token information in the given local directory in <LOCAL_CONFIG_PATH>. To ensure access to your mounted directories it can be important to pass a UID and GID to the docker deamon (as stated in the example by the --user argument)
Using the script with docker makes it also possible to run the script even on windows machines.
To use a proxy, just set the mentioned environment variables via the docker -e parameter.
thunar-dropbox: A simple extension to Dropbox Uploader that provides a convenient method to share your Dropbox files with one click!
If you want to support this project, please consider donating:
FAQs
Droxul -- Dropbox Uploader is a **BASH** script which can be used to upload, download, delete, list files (and more!) from **Dropbox**, an online file sharing, synchronization and backup service.
We found that droxul demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
/Research
Malicious npm package impersonates Nodemailer and drains wallets by hijacking crypto transactions across multiple blockchains.
Security News
This episode explores the hard problem of reachability analysis, from static analysis limits to handling dynamic languages and massive dependency trees.
Security News
/Research
Malicious Nx npm versions stole secrets and wallet info using AI CLI tools; Socket’s AI scanner detected the supply chain attack and flagged the malware.