**muto** is a client/server system for cloud-based image manipulation in
[Django] projects. It uses [easy-thumbnails] for the manipulation part and
[boto] for accessing and storing images on [S3].
This is the server part. The client package is called [muto-client].
You can install the package from PyPI using pip or easy_install:
$ pip install muto-server
Or you can install from the latest source version:
$ git clone git://github.com/philippbosch/muto-server.git
$ cd muto-server/
$ python setup.py install
Add `mutoserver` to your `INSTALLED_APPS` in **settings.py**:
INSTALLED_APPS = (
You also need a [Redis] instance in place.
There are a few configuration settings you can set in your **settings.py**:
* `MUTO_REDIS_URL` – The URL to a Redis instance (defaults to `redis://:6379`)
* `MUTO_AWS_STORAGE_BUCKET_NAME` - The S3 bucket used to store and retrieve images (falls back to `AWS_STORAGE_BUCKET_NAME` if not defined)
* `MUTO_AWS_ACCESS_KEY_ID` and `MUTO_AWS_SECRET_ACCESS_KEY` – Your S3 credentials used to upload to S3 (fall back to `AWS_ACCESS_KEY_ID` or `AWS_SECRET_ACCESS_KEY` respectively if not defined)
**muto-server** is basically a management command that runs a worker process
and waits for incoming image transformation requests by watching a queue in
Redis. Start the worker like this:
$ python manage.py watchqueue
TODO: Brief introduction on what you do with files - including link to relevant help section.