Installation is super-easy, there's no need to install anything, just download the self-contained binary from the github releases page (builds are available for Linux, Mac or Windows and 32-bit or 64-bit): https://github.com/barnybug/s3/releases/

Rename and make the download executable:

$ mv s3-my-platform s3; chmod +x s3

And you're ready to go:

$ ./s3 -h

Alternatively you can instead build from source, you'll need go 1.2 installed, then:

go get github.com/barnybug/s3

Setup

Set the environment variables:

export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...

Usage

List buckets:

s3 ls

List keys in a bucket under a prefix:

s3 ls s3://bucket/prefix

Download all the contents (recursively) under the path to local:

s3 get s3://bucket/path

Cat (stream to stdout) all the contents under the path:

s3 cat s3://bucket/path | grep needle

Synchronise localpath to an s3 bucket:

s3 sync localpath s3://bucket/path

Synchronise an s3 bucket to localpath:

s3 sync s3://bucket/path localpath

Synchronise an s3 bucket to another s3 bucket:

s3 sync s3://bucket1/path s3://bucket2/otherpath

Recursively remove all keys under a path:

s3 rm s3://bucket/path

Create a bucket:

s3 mb bucket

Delete a bucket:

s3 rb bucket