Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including worker-generate-stills with all npm packages installed. Try it out:

var workerGenerateStills = require("worker-generate-stills")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

worker-generate-stills v0.3.5

CouchDB worker which generates stills from videos.

Worker Generate Stills

This worker generates stills from videos for video types supported by imagemagick.


This worker depends on ffmpeg. Make shure the ffmpeg program is in the path.


git clone git://
cd worker-generate-stills
npm install


Configuration is done in a worker configuration document inside the target database. The worker only process if there exists such a configuration file.

A Worker Configuration File might look like this:

  "_id": "worker-config/generate-thumbnails",
  "_rev": "9-a653b27246b01cf9204fa9f5dee7cc64",
  "versions": {
    "medium": {
      "ratio": "1/25"

You can update the config live so that all future processings will take the new configuration.

Note that attachment names which starts with a version name, followed by a '/' are ignored.

ratio is the framerate of the stills.

Worker Status Document

The worker stores a status document inside the target database. The worker stores its last update seq here and can resume at the point it stopped.

  "_id": "worker-status/attachments",
  "_rev": "1-1922b5623d07453a753ab6ab2c634d04",
  "last_update_seq": 34176

Document Status Object

The worker updates a status object inside the document. This makes it supereasy to monitor worker status as well as it keeps an atomic lock when many workers listen to the same database. Images are prozessed only once by comparing the attachments revpos property with the revpos property of the status object.

The status object of the worker looks like this:

"worker_status": {
  "generate-stills": {
    "status": "completed",
    "revpos": 160

The status field can be triggered, completed or error.

The worker status is scoped by the worker name in order to have many workers processing the same document. The worker status is also per attachment to process only attachments which had changed.

Running the Worker

To start, this needs the following environment variables set:

COUCH_SERVER= COUCH_DB=mydb npm start

License & Copyright

(c) 2012 Johannes J. Schmidt, null2 GmbH, Berlin

Licensed under the Apache License 2.0.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free