It's beast I can tell you, once tamed,…
run
icsd --help
ics was intended to react on HTTP parameters only; allowing the base-URL to be independent of the query parameters.
For debug purposes a couple of locations sneaked in:
| Location | parameters | Description |
|---|---|---|
| /stream | (A),(B),[D] | request rendered video data |
| /status | none | display server, decoder & cache status in xHTML |
| /info | (A),[F] | return txt or JSON information about the given file/decoder/frame. |
| /index/.* | none | (special) lists directories/files under doc-root |
| .* | (A),(B),[C] | query frame as image |
Parameter can be appended as raw URL encodeded query arguments or specified via HTTP POST header.
file=<filename> - path relative to /ics/ document-root.frame=<framenumber 0..N> - frame to display or frame to start streaming.w=<int> and/or h=<int>. Negative numbers imply auto-scaling to aspect-ratio and -1,-1 (the default) mean original size. format=(jpeg,jpg,png,ppm,raw,rgb,rgba) - default is 'jpeg'only affecting streaming/export
container=(avi,flv,ogg,mpeg,mpg,rm,vob) - default is 'avi' nosound=1 - default is 0 (with sound)duration=<video-frame-count> - how long -1: until end of session; default: 100 frames.save_as=<filename> - override HTTP Content-Type to application/octet-stream.only affecting info
format=jsonExamples
http://localhost:1554/?frame=800&file=test.avi&format=png&h=200 http://localhost:1554/stream?frame=2350&file=1%2FJoe_Wright%2FAtonement_%282007%29%2FAtonement.avi&duration=1500&container=ogg&.ogg