tus-client

tus-client

A command-line tus client.

See https://tus.io for more information.

Command Line Options

• --chunksize: Chunks size for uploads (can be specified in bytes or with "Ki", "Mi", "Gi", "Ti", "Pi" or "Ei" suffix)
• --disable-resume: Disable the resumption of uploads (disables the use of the store)
• -H, --header: Extra HTTP header(s) to add to request (eg "Authorization: Bearer TOKEN"). Specify more than once to add multiple headers.
• -h, --help: help for tus-client
• -i, --input: File to upload
• --no-progress: Disable progress bar
• -q, --quiet: Disable all output except for errors
• --storepath: Path of database or JSON file to allow resumable uploads (defaults to using SQLite store in a user specific OS dependent location)
• --url: tus upload URL

Resumption of Uploads

The tus protocol supports resuming uploads, which is implemented using the tus.Store interface.

This repo includes two implementations of this interface, one supporting SQLite and the the other writing to a JSON file.

Depending on the extension provided for the --storepath option, either the SQLite or JSON store type will be used.

The default is to use the sqlitestore.Store implemention below, with the default path to the database dependent on the OS in question:

sqlitestore

This package is used to implement a SQLite version of the tus.Store interface.

jsonstore

This package is used to implement a JSON file-based version of the tus.Store interface.

Due to the simplisitic nature of this implementation, it is not safe to have multiple users of the same JSON file as a tus.Store.

Authentication

The tus protocol does not specify any Authentication/Authorization scheme, so this is up to the server implementation in question.

This client supports the addition of arbritrary HTTP headers to the request which allows various authentication options, as follows:

tus-client -H "Remote-User-Name: user" -H "Remote-User-Secret: SECRET-API-TOKEN" --input upload.mp4 --url https://some.tus.server/url

Or using "bearer" authentication:

tus-client -H "Authorization: Bearer SECRET-API-TOKEN" --input upload.mp4 --url https://some.tus.server/url