send-cli 
Unofficial command line (Firefox) Send client
Warning, Sharp Edges!
- will overwrite the output file without warning, but does prompt for the output filename
- Uses temp files to avoid using large amount of memory, you will need at least 2GB of free disk space to upload a 2GB file
- Very limited error checking
- expect serious issues such as data loss if precautions are not taken (you are using a service where destroying your data is a feature, use common sense)
Issues for bugs/features/mistakes/comments on coding style are all very welcome, please also feel free to open pull requests for nits/petty changes.
Installation
You can install the package "sendclient" from the python package index
pip3 install sendclientor from a clone of this repository
pip3 install /path/to/cloned/send-cli/tip: use pip install -e to install in 'editable' mode if your intending to modify the client
Basic usage
$ send-cli -h
!!! Experimental/alpha quality suitable for testing at your own risk only !!!
usage: send-cli [-h]
[--service-local | --service-dev | --service-stage | --service-live | --service SERVICE]
[--file FILE | --stdin FILENAME | --delete URL TOKEN | --change-download-limit URL TOKEN LIMIT | --change-password URL TOKEN | --url URL]
[--ignore-version] [--download-limit LIMIT]
[--password | --password-unsafe PASSWORD_UNSAFE]
[input]
Unofficial (Firefox) Send client
positional arguments:
input Uploads or downloads a file specified by path or url,
no other options required
optional arguments:
-h, --help show this help message and exit
--ignore-version Disable server version checks (MAY CAUSE LOSS OF DATA)
--download-limit LIMIT
Download limit for the uploaded file. Should be <=20
Set the Send service to used:
--service-local Use a Send service at http://localhost:8080
--service-dev Use the Send development server for upload
--service-stage Use the Send staging server for upload
--service-live Use the Send production server for upload (Default)
--service SERVICE Specify the url of a Send service to use for upload,
can also be set with the environment variable
SEND_SERVICE
Action:
--file FILE Upload the specified file to Firefox Send
--stdin FILENAME Upload data read from standard input with this
filename
--delete URL TOKEN Delete a file hosted on a Send server
--change-download-limit URL TOKEN LIMIT
Change the download limit for a file hosted on a Send
server, LIMIT must be <=20
--change-password URL TOKEN
change the password for a file hosted on a Send server
--url URL Download a file with a Send link
Password:
--password Protect the uploaded file with a password
--password-unsafe PASSWORD_UNSAFE
Provide a password on the command-line (UNSAFE as
password visible in process list or shell history!)Miscellaneous
Reading command line arguments from a file
Filenames on the command line prefixed with '@' will be replaced by the arguments they contain. This is handled by argparse https://docs.python.org/3/library/argparse.html#fromfile-prefix-chars
Example formatting
--service
https://your-send.server/
--password
--file
path/to/file
or
--service=https://your-send.server/
--password
--file=path/to/file
Multiple files can be included in the same command
send-cli @file1 @file2 --file path/to/fileDon't put secrets on the command line!
You can avoid secrets (such as passwords or Send URLs) being recorded in your shell history or exposed via /proc/PID/cmdlineby either
- having send-cli prompt you for it (e.g.
--password) - reading it from a file (e.g.
--password-unsafe @password-file) if it has to be done non-interactively.
tip: Instead of a regular file, you can avoid writing the password to disk by using a named pipe (mkfifo)
Password Length
When uploading a file the Send UI prevents the uploading user from entering a password longer than 32 characters. send-cli does not enforce this limit but remains 'compatible' as Send does not currently limit password length when downloading a file.
