upload uploads files to the internet and generates a download link.
Use the following command to download and run upload using the nix package manager.
nix run github:zebreus/uploadA static binary is available in the latest github release.
# Download the static binary into /usr/bin. This should work on any distribution.
sudo wget https://github.com/zebreus/upload/releases/download/v0.2/upload.binary -O /usr/bin/upload
sudo chmod +x /usr/bin/uploadupload is also packaged on the AUR.
Upload a file named file.txt
$ upload file.txt
http://somefilehost.tld/file.txtUpload multiple files as an archive
$ upload file1.txt file2.txt
http://somefilehost.tld/upload.zipUpload multiple files individually
$ upload -i file1.txt file2.txt
http://somefilehost.tld/file1.txt
http://somefilehost.tld/file2.txtFind all cpp files and upload them as an archive
$ find . -name "*.cpp" | upload -a
http://somefilehost.tld/sources.zipupload [options...] file
upload [options...] file...
upload [backend-selection-options...] -l|--list
upload -h|--help
upload uploads files to the internet and prints a http(s) url, where you can download them.
In its default mode, upload uploads the files at path to a random site on the internet. upload guarantees to print the url of the file to stdout or to exit with a nonzero code, unless '-v' is set. If no upload mode is specified and there is no or one file individual mode will be used, if there are more than one files archive mode will be used.
The entries of file can be files, directories, character special files, FIFO devices/pipes or - for standart input.
Regular files and directories will be processed according to the upload mode(individual or archive).
Character special files and FIFO files will be read for additional filenames. These can only be regular files or directories and they have to be seperated by newlines. Empty lines will be ignored.
If file is empty and the standart input is a FIFO file/pipe, - will be added implicitly.
Symlinks in file will be followed.
In individual mode:
When uploading a file, the file will be uploaded raw.
When uploading a directory, an archive with the name of the directory will be created and uploaded. The files/directories contained in the directory will be placed at root-level of the archive.
If reading character special or FIFO files, each file will uploaded as soon as it is read.
If one file fails to upload, upload will exit with errorcode 3, unless -c/--continue is set, than it will continue and exit with 0, after there has been an attempt to upload each file.
In archive mode:
All specified files and directories are combined into an archive, that will be uploaded. If you specified a directory it will be create as a directory in the archive.
If reading character special or FIFO files, all read files and all files will be packed and uploaded afterwards.
In list mode:
Backends are selected based on the backend selection options and printed.
No files are checked, loaded or uploaded.
Most of the options that only affect individual or archive mode are ignored.
time in options is formatted in milliseconds by default. You can suffix your value to change the unit of time. Valid suffixes are
s for seconds,
m for minutes,
h for hours and
d for days.
All letters are converted to lowercase before evaluation.
size in options is formatted in bytes by default. You can suffix your value to change the unit of size. Valid suffixes are
KB for Kilobyte(10^3),
KiB/K for Kibibyte(2^10),
MB for Megabyte(10^6),
MiB/M for Mebibyte(2^20),
GB for Gigabyte(10^9) and
GiB/G for Gibibyte(2^30).
All letters are converted to lowercase before evaluation.
-
-h,--help: Displays the help screen. -
--version: Displays version information. -
-v: Increase the verbosity of the output. -
-a,--archive: Pack all files and directories into an archive. Mutually exclusive with-i/--individual. -
-i,--individual: Upload all files or directory individually. For directories an archive with the name of the directory will be created and uploaded. Mutually exclusive with-a/--archive. -
-l,--list: List all available upload backends for the current request, ordered by preference and exit without uploading anything.
-
--archive-type=zip : Sets the archive type. -
-r,--root-archive: When archiving a directory, files inside that directory will be put in a directory with the same name in the archive. This is the default setting in archive mode. Mutually exclusive with-d/`--directory-archive. -
-d,--directory-archive: When archiving a directory, files inside that directory will be put on the root level of the archive. This is the default setting in individual mode. Mutually exclusive with-r/`--root-archive.
-
-bbackend,--backend=backend : Select a specific backend. If used multiple times, the backends will be selected in their order. If this option is used, the default order is discarded. -
-p,--preserve-name: Ensure, that the selected backend preserves the filename. Some backends replace the filenames with random strings, this option excludes them. -
--no-preserve-name: Ensure, that the selected backend randomizes the filename. -
-s,--ssl: Ensure, that each file will be upload using https and generates a https url -
--no-ssl: Ensure, that each file will be upload using http and generates a http url -
--min-retention=time : Ensure, that each file is available to download for at least time. -
--max-retention=time : Ensure, that each file gets deleted after time passes (or earlier). -
--min-size=size : Ensure, that the every choosen backend supports uploading files bigger than size bytes. -
--max-downloads=downloads : Ensure, that each file gets deleted after downloads downloads. -
--min-random-part=characters : Ensure, that each url has a random part of at least characters characters. -
--max-random-part=characters : Ensure, that each url has a random part not bigger than characters characters. -
--max-url-length=characters : Ensure, that each url is shorter than characters.
-c,--continue: Do not abort if the upload of a file failed.
-n,--name: The name of the created archive. By default the name will be randomly generated.
First a ordered list of possible backends is generated, by default this includes all known backends and is ordered randomly. You can also set the list manually by using -b/--backend.
Then backends that do not meet the requirements are discarded. You can set the requirements with the backend selection options.
Then an attempt is made to upload the files to the first backend, if the upload finished and an url was generated, the url is printed and upload exits 0. If uploading the file failed, the next backend is used. When no backends remain the program exits 1.
Upload a file named file.txt
$ upload file.txt
http://somefilehost.tld/file.txt
Upload multiple files as an archive
$ upload file1.txt file2.txt
http://somefilehost.tld/upload.zip
Upload multiple files individually
$ upload -i file1.txt file2.txt
http://somefilehost.tld/file1.txt
http://somefilehost.tld/file2.txt
Find all cpp files and upload them as an archive
$ find . -name "*.cpp" | upload -a
http://somefilehost.tld/sources.zip
Your files are uploaded to a random server of some random internet person.
There is no guarantee, that your files will be unmodified.
There is no guarantee, that your files are in any way private.
There is no guarantee for anything, btw.
0
Success.
3
Failed to upload the file(s) to any backend.
4
There is no backend matching the backend selectiong options.
5
There is no reachable backend matching the backend selectiong options.
64
Command line usage error.
66
Unable to read one or more input files/directories.
Yes, probably a lot.
If you find one, it would be nice, if you could open an issue on github https://github.com/Zebreus/upload/issues.
Upload is copyright (C) 2022 . License GPLv3. GNU GPL version 3 https://gnu.org/licenses/gpl.html. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
man(1)