• image: An image named for later use.
• animation: A group of frames to be played in sequence.
• frame: An image and some display properties, as part of an animation.

!anim add image <name> [url]

!anim edit image <name> <url>

!anim rename image <name> <newname>

!anim remove image <name>

!anim list image [name]

• name: Name of image to affect.
• url: URL of image to give specified name (if no URL is provided, the image for the selected token will be used).
• newname: New name of renamed image.

!anim add animation <name> [cycles]

!anim edit animation <name> <cycles>

!anim rename animation <name> <newname>

!anim copy animation <name> <newname>

!anim remove animation <name>

!anim list animation [name]

• name: Name of animation to affect.
• cycles: How many times to run through the animation's frames when it is played (default: 1).
• newname: New name of renamed or copied animation.

!anim add frame <animation> <image> <duration> [options]

!anim edit frame <animation> <frame index> [options]

!anim copy frame <src animation> <src index> <dest animation> [dest index]

!anim remove frame <animation> <frame index>

!anim list frame <animation> [frame index]

• animation: Name of animation containing affected frame.
• image: Name or URL of image for new frame.
• duration: Amount of time (in milliseconds) to display the new frame when the animation is played.
• frame index: 0-based index of frame to affect.
• src animation: Name of animation from which to copy frame.
• src index: 0-based index of frame to copy.
• dest animation: Name of animation into which to copy frame.
• dest index: 0-based index at which to insert copied frame (after last frame if not provided).

!anim run <name> [options]

• name: Name of animation to play.

!anim export <name> [handout]

• name: Name of animation to export.
• handout: Name of new handout into which to write commands to generate animation (commands will be whispered to user if handout not provided).

• -x X, -y Y: Frame offset (in pixels) from the animation origin (default: 0)
• -w W, --width W: Frame width in pixels (default: 70)
• -h H, --height H: Frame height in pixels (default: 70)
• -r A, --rotation A: Angle of frame rotation in degrees, relative to animation (default: 0)
• -a R, --aura R: Radius (in page units) of frame's aura (default: no aura)
• --auracolor C: Color of frame's aura (default: #FFFF99)
• --aurasquare: Make frame's aura square (default: circular aura)
• -t C, --tint C: Color tint to be applied to frame (default: none)
• -l R, --light R: Radius (in page units) of light emitted by frame (default: none)
• -d R, --dim R: Radius (in page units) at which frame's light begins to dim (default: none)
• --lightangle A: Angle (in degrees) of light emitted by frame (default: 360)
• -I IMG, --image IMG: Name or URL of frame image (as image parameter, for use with --copy and !anim edit)
• -D T, --duration T: Amount of time (in milliseconds) to display the frame (as duration parameter, for use with --copy and !anim edit)
• -i I, --insert I: (!anim add only). 0-based index at which to insert new frame (default: after last frame)
• -C I, --copy I: (!anim add only). 0-based index of existing frame to copy. Any properties set by this command will override those of the frame being copied. If I is negative, it is relative to the insertion index (so -C -1 will copy the frame just before the new frame). In this form of the command, the image and duration parameters are optional.

!anim run accepts the following options:

• -x X, -y Y: Coordinates (in pixels) at which to display the specified animation. If either is not specified, the corresponding coordinate of the currently selected token will be used. If no token is used, the midpoint of the page will be used.
• -r A, --rotation A: Rotation (in degrees) at which to display the animation (default: 0)
• -f F, --timefactor F: Scale factor for frame durations (default: 1)
• --xscale F: Size scale factor in the X direction, affecting frame sizes, offsets, aura radii, and light radii (default: 1)
• --yscale F: Size scale factor in the Y direction, affecting frame sizes, offsets, aura radii, and light radii (default: 1)

Aura and light radii use the average of the X and Y scale factors.

• --cycles N: Number of times to run through animation frames. Overrides the animation's cycles setting.
• -p ID, --page ID: ID of the page on which to display the animation
• -P, --playerpage: Display animation on page with player ribbon.

If no page is specified, the page containing the currently selected token will be used. If no token is selected, the page with the player ribbon will be used.