Reference server implementation in Go of tus: the open protocol for resumable file uploads
Go to file
Felix Geisendörfer 8b83de5a30 Mission 2013-03-17 12:44:58 +01:00
.gitignore Add .gitignore 2013-03-16 21:40:35 +01:00
LICENSE.txt Readme and license 2013-03-16 22:23:25 +01:00
README.md Mission 2013-03-17 12:44:58 +01:00

README.md

tusd

A dedicated server for resumable file uploads written in Go.

Sounds interesting? Get notified when it's ready: http://tus.io/

Mission

The tus mission is to make file uploading more reliable, faster and a better user experience. We are dedicated to providing an open solution for this to everybody.

Roadmap

The initial goal for this project to come up with a good and simple solution for resumable file uploads over http.

  • Defining a good http API (in progress)
  • Implementing a minimal / robust server for it
  • Creating an HTML5 client
  • Setting up an online demo
  • Integrating Amazon S3 for storage
  • Creating an iOS client

Future features will be based on your feedback. A few potential ideas:

  • Alternative transfer mechanisms: FTP, UDP, E-Mail, etc.
  • Security: Authentication Tokens, HTTPS, etc.
  • Support for running tusd instances in a geographically distributed cluster (reverse CDN)
  • Alternative storage backends: Cloud Files, Dropbox, etc.
  • More clients: Android, PhoneGap, etc.
  • Service integrations: Zencoder, Encoding.com, Youtube, Vimeo, Facebook, etc.
  • File meta data analysis
  • Thumbnail generation

Once the project matures, we plan to offer a hosted service and support contracts. However, all code will continue to be released as open source, and you'll always be able to run your own deployments easily. There will be no bait and switch.

HTTP API

Below is the proposed HTTP API for resumable file uploading.

Prior art:

POST /files

Used to create a resumable file upload. You may send parts or all of your file along with this request, but this is discouraged as you will not be able to resume the request if something goes wrong.

Request Example:

POST /files HTTP/1.1
Host: tus.example.com
Content-Length: 0
Content-Range: bytes */100
Content-Type: image/jpg
<empty body>

Response Example:

HTTP/1.1 201 Created
Location: http://tus.example.com/files/123d3ebc995732b2
Content-Length: 0

The Location header returns the <fileUrl> to use for interacting with the file upload.

PUT <fileUrl>

Request Example:

PUT /files/123d3ebc995732b2 HTTP/1.1
Host: tus.example.com
Content-Length: 100
Content-Range: bytes 0-99/100
<bytes 0-99>

Response Example:

HTTP/1.1 200 Ok

HEAD <fileUrl>

GET <fileUrl>

Used to download an uploaded file.

Request:

GET /files/123d3ebc995732b2 HTTP/1.1
Host: tus.example.com

Response:

HTTP/1.1 200 Ok
Content-Length: 100
Content-Type: image/jpg
[file data]

License

This project is licensed under the AGPL v3.

Copyright (C) 2013 Transloadit Limited
http://transloadit.com/

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.