code: fix docs, add in appearance warping (I think)

  * note this is pretty untested.  I can't test the appearance warp
    until we have all the clips getting run through the pipeline
  * I also added a gif write function, which I also can't test for the
    same reason... just turn those 2 flags off and lmk when ready