Bucketlist
An Apache-like index for viewing the file and directory listing of an Amazon S3 bucket.
Demo: http://bucketlist-demo.s3-website-ap-southeast-2.amazonaws.com/
About
In this repo, the src directory contains the unminified source, and
the public directory contains the latest (minified) build. When using
Bucketlist, you can either go with the "drop-in" solution and use
public/index.html, which has all of it's references to static assets
pointing to a Cloudfront CDN containing the latest release, or you could
go with src just and host the whole kit and kaboodle yourself.
Prerequisites
- Edit your S3 bucket's permissions
- Enable "List" permissions for the grantee "Everyone"
- Add a rule to the CORS configuration to allow all origins ("*") to GET
Configuration
Bucketlist is flexible - it can be used with any S3 bucket in any region, with or without S3's static website hosting enabled. You can put the index within the bucket itself, in another S3 bucket, or anywhere else you'd like.
Hosted in the same S3 bucket
- Fetch either public/index.html, or the contents of src
- Update the
titleand thedescriptiontags at the top ofindex.html - Upload it to your bucket
Hosted in another S3 bucket, or anywhere else
- Fetch either public/index.html, or the contents of src
- Update the
titleand thedescriptiontags at the top ofindex.html - Uncomment the
urlkey in thewindow.bucketlistConfigobject at the top ofindex.html- Change it to the URL of your S3 bucket
- Upload it to wherever you'd like to host it
Options
Bucketlist takes 2 user configurable options in the form of the
window.bucketlistConfig object, which can be found in the top of
index.html. To modify an option, simply uncomment it and change
it's value.
- url
- The URL of the S3 bucket you'd like to generate a Bucketlist for
- Default: the current
window.location.host
- limit
- The number of results per page
- Default: 100
Credits
Bucketlist uses: