OVERVIEW:

S3Cmd is a Python script and libraries which give you access to Amazon S3
from the Shell. It also provides support for CloudFront and S3 Websites.

Most of the online storage and backup services out there use proprietary
Windows/OSX clients or require using a browser to upload data.
As Amazon provide an API to connect directly to their servers I thought that
it would be nice if the Amiga too could have transparent access to their cloud
storage service.

After exploring the various solutions I settled for S3Cmd as it only needs
Python which comes pre-installed with OS4 and I wanted to keep it as simple to
install as possible so that anyone else could use it too.

With the included S3Cmd script you will be able to easily load/save, share and
backup/restore data on the cloud with your Amiga.
No more excuses for not having backups ;-)


REQUIREMENTS:

For S3Cmd to be of any use you'll need an Amazon Web Services (AWS) account.

Currently Amazon gives a whole year for free from the date you sign up and their
free offer includes a lot more than storage. For example you can create an M1
cloud server instance with 30GB of EBS storage, dedicated IP, root access and
the ability to install any Linux version and software you want.
See http://aws.amazon.com/free/ for details


INSTALLATION:

Copy the S3C drawer wherever you like
[see S3C.readme for configuration details]


USAGE:

After installing S3Cmd you will be able to access your S3 storage transparently
from the Shell with the S3Cmd command.

You can use S3Cmd as-is, for example:

'S3Cmd get s3://amigarulez/newdrawer/myfile RAM:myfile' (download file to RAM:)
'S3Cmd sync DH1:MyPrecious/ s3://amigarulez/MyPrecious/' (incremental backup)

or you can create aliases and scripts to have more amiga-like commands 
for common tasks such as:

S3List, S3Put, S3Get, S3Delete, S3Info, etc.
[see S3C.readme for examples]


HINTS:

If you enable user read permission on drawers or files (setacl) you can share
your files by giving people links such as:
http://s3.amazonaws.com/amigarulez/photos/myphoto.jpg or
http://amigarulez.s3.amazonaws.com/photos/myphoto.jpg

With ARexx for Python and ProAction from Andy Broad you can quickly create some
ReAction GUIs to interact with S3. 

If someone has the time and patience to make an s3-handler to mount buckets as
volumes like FTPMount and NetFS, please do!


CREDITS:

All the hard work was done by Michal Ludvig (S3Cmd), I only added a few lines
of code to prevent infinite loops and crashes from the colon in volume names.


Enjoy!