A jQuery plugin for direct upload to an Amazon S3 bucket.
Haxe JavaScript Ruby
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



A jQuery plugin for direct upload to an Amazon S3 bucket.

It works by replacing a file input with a html element overlaid with a transparent SWF. The same way Flickr does it.

By signing the request server side we also avoid the security issue of showing the Amazon AWS Access Id Key and Secure Key in plain text. A library for signing the request in Ruby is included, but the logic should be very easy to replicate in other languages like PHP or Python.

The Javascript API also allows these callback functions:

  • onselect(info) - Called when a user has selected a file.
  • oncancel(info) - Called if the user decides to abort the file browsing.
  • onstart(info) - Called after the request has been signed and the file upload to S3 is starting.
  • onprogress(progress,info) - Called while uploading, "progress" being a float between 0 and 1 of the current upload progress.
  • oncomplete(info) - Called when the upload has finished successfully.
  • onerror(msg,info) - Called if there's been a problem with a message saying what failed.
  • onenabled() - Called when the SWF has been enabled. Usually when swf.enable() has been called. Called first thing when the SWF is finished initializing.
  • ondisabled() - Called when the SWF has been disabled. Usually when swf.disable() has been called.

info is an object containing "name", "size" and "type" of the selected file.

And these mouse callbacks:

  • onmouseover(x,y)
  • onmouseout(x,y)
  • onmousedown(x,y)
  • onmouseup(x,y)
  • onmousemove(x,y)
  • onclick(x,y)
  • onrollover(x,y)
  • onrollout(x,y)
  • ondoubleclick(x,y)

The mouse events are also triggered as regular jQuery events (i.e. $('#input_replaced').rollover(function(){alert('over!')}); should work just fine as well).

Every callback is scoped to the DOM element which has replaced the previous input (i.e. "this" in the callbacks points to the html element). Also by returning true in a callback function the default callback will be used.

Which file types that can be selected may be defined with the file_types option, see the "Usage Example" below for more info. If none is defined all files are acceptable.


  • jQuery 1.3+
  • SWFObject 2.1+

Both available from Google AJAX APIs (recommended as it likely speeds things up).

Example Usage

The HTML/JS part:

<script type="text/javascript" charset="utf-8" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>
<script type="text/javascript" charset="utf-8" src="http://ajax.googleapis.com/ajax/libs/swfobject/2.2/swfobject.js"></script>
<script type="text/javascript" charset="utf-8" src="jquery.s3upload.js"></script>

<script type="text/javascript" charset="utf-8">
		var max_file_size = 2 * 1024 * 1024; // = 2Mb
			prefix: "s3upload/",
			required: true,
			onselect: function(info) {
				if( parseInt( info.size ) < max_file_size )
					return true; // Default is to show the filename in the element.
					$(this).html("Too big file! Must be smaller than " + max_file_size + " (was "+info.size+")");
			file_types: [ 
				[ "Images" , "*.png;*.jpg;*.bmp"], 
				[ "Documents" , "*.pdf;*.doc;*.txt"]

<form action="/media/new" method="post" accept-charset="utf-8" enctype="multipart/form-data">
	<label for="media_title">Title</label>
	<input type="text" name="media[title]" value="" id="media_title" />
	<label for="media_video">Video</label>
	<input type="file" name="media[video]" value="" id="media_video" />
	<label for="media_thumbnail">Thumbnail</label>
	<input type="file" name="media[thumbnail]" value="" id="media_thumbnail" />
	<input type="submit" value="Upload" />

The Sinatra part (assumes the s3upload gem is installed):

require "s3upload"
get "/s3upload" do
  up = S3::Upload.new( options.s3_upload_access_key_id , options.s3_upload_secret_key , options.s3_upload_bucket )
  up.to_xml( params[:key] , params[:contentType] )