--- /dev/null
+## annotate
+
+Utility to split THREE.js model (exported from 3D Studio Max) with single animation into seperate parts based on frame ranges.
+
+## Description
+
+This utility refactors THREE.js JSON model files that were exported using `ThreeJSAnimationExporter.ms` plugin to maintain few animations instead of a single "Action" animation. List of resulting animation names and frame ranges has to be provided.
+
+## Supported Formats
+
+* THREE.js JSON (.js)
+
+## Usage
+
+```
+annotate.py [-h] [-u] -i FILE -o FILE range [range ...]
+
+Split THREE.js model animation into seperate parts.
+
+positional arguments:
+ range range in format "name=frame..frame"
+
+optional arguments:
+ -h, --help show this help message and exit
+ -u, --gui run in GUI
+ -i FILE input file name
+ -o FILE output file name
+
+example:
+ annotate.py -i model.js -o model.new.js idle=1..10 walk=11..20
+```
+
+## Current Limitations
+
+* No known limitations
+
+## Dependencies
+
+* Python 2.7 or 3.1
+* **Requires THREE.js >= r71 for output animation to work properly.**
+
+## Optional dependencies
+
+* PyQt4
+* argparseui
+
+## Example usage
+
+```
+./annotate.py -i model.js -o model.new.js idle=1..10 walk=1..20
+```
+
+## Contribution
+
+I highly encourage you to participate in the development of this utility.
+Author: Andrew Dunai