Skip to content
The tus client for Java.
Java Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Add GitHub Issue Templates Dec 2, 2019
example Allow beginning an upload from URL without creation May 20, 2018
gradle/wrapper Update to Gradle 6.3 Apr 8, 2020
src Fix uploadChunk's javadoc (#31) Feb 8, 2020
.gitignore Add gradle-wrapper.jar Jul 17, 2015
.travis.yml Remove non-LTS Java versions Apr 8, 2020
LICENSE Initial commit Jul 15, 2015 Bump to 0.4.2 Jun 13, 2019
build.gradle Add feature to remove fingerpints after successful upload Jun 13, 2019 Use pomVersion for variable in Gradle Oct 6, 2015 Correct copying into gh-pages directory May 30, 2018
gradlew Update to Gradle 6.3 Apr 8, 2020
gradlew.bat Update to Gradle 6.3 Apr 8, 2020
settings.gradle Add example project Dec 27, 2015

tus-java-client Build Status

tus is a protocol based on HTTP for resumable file uploads. Resumable means that an upload can be interrupted at any moment and can be resumed without re-uploading the previous data again. An interruption may happen willingly, if the user wants to pause, or by accident in case of a network issue or server outage.

tus-java-client is a library for uploading files using the tus protocol to any remote server supporting it.

This library is also compatible with the Android platform and can be used without any modifications using the API. The tus-android-client provides additional classes which can be used in addition the Java library.


// Create a new TusClient instance
TusClient client = new TusClient();

// Configure tus HTTP endpoint. This URL will be used for creating new uploads
// using the Creation extension
client.setUploadCreationURL(new URL(""));

// Enable resumable uploads by storing the upload URL in memory
client.enableResuming(new TusURLMemoryStore());

// Open a file using which we will then create a TusUpload. If you do not have
// a File object, you can manually construct a TusUpload using an InputStream.
// See the documentation for more information.
File file = new File("./cute_kitten.png");
final TusUpload upload = new TusUpload(file);

System.out.println("Starting upload...");

// We wrap our uploading code in the TusExecutor class which will automatically catch
// exceptions and issue retries with small delays between them and take fully
// advantage of tus' resumability to offer more reliability.
// This step is optional but highly recommended.
TusExecutor executor = new TusExecutor() {
    protected void makeAttempt() throws ProtocolException, IOException {
        // First try to resume an upload. If that's not possible we will create a new
        // upload and get a TusUploader in return. This class is responsible for opening
        // a connection to the remote server and doing the uploading.
        TusUploader uploader = client.resumeOrCreateUpload(upload);
        // Alternatively, if your tus server does not support the Creation extension
        // and you obtained an upload URL from another service, you can instruct
        // tus-java-client to upload to a specific URL. Please note that this is usually
        // _not_ necessary and only if the tus server does not support the Creation
        // extension. The Vimeo API would be an example where this method is needed.
        // TusUploader uploader = client.beginOrResumeUploadFromURL(upload, new URL(""));

        // Upload the file in chunks of 1KB sizes.

        // Upload the file as long as data is available. Once the
        // file has been fully uploaded the method will return -1
        do {
            // Calculate the progress using the total size of the uploading file and
            // the current offset.
            long totalBytes = upload.getSize();
            long bytesUploaded = uploader.getOffset();
            double progress = (double) bytesUploaded / totalBytes * 100;

            System.out.printf("Upload at %06.2f%%.\n", progress);
        } while(uploader.uploadChunk() > -1);

        // Allow the HTTP connection to be closed and cleaned up

        System.out.println("Upload finished.");
        System.out.format("Upload available at: %s", uploader.getUploadURL().toString());


The JARs can be downloaded manually from our Bintray project. tus-java-client is also available in JCenter (Maven Central is coming soon).


compile ''




The documentation of the latest version (master branch of git repository) can be found online at


Can I use my own custom SSLSocketFactory?

Yes, you can! Create a subclass of TusClient and override the prepareConnection method to attach your SSLSocketFactory. After this use your custom TusClient subclass as you would normally use it. Here is an example:

public void prepareConnection(@NotNull HttpURLConnection connection) {
    if(connection instanceof HttpsURLConnection) {
        HttpsURLConnection secureConnection = (HttpsURLConnection) connection;



You can’t perform that action at this time.