How to take timed thumbnail snapshots of a Wowza Transcoder stream (TranscoderTimedSnapshot)

The ModuleTranscoderTimedSnapshot module for Wowza Streaming Engine™ media server software can be used to take a thumbnail snapshot of a Wowza Transcoder stream at regular intervals. It can be configured to save a sequence of time-stamped images or a single image that is continuously overwritten.


For developers


Wowza Streaming Engine 4.0.0 or later is required.

Wowza Transcoder must be enabled in the Wowza Streaming Engine application.


  1. Download
  2. Extract the contents from the downloaded (zipped) package, and then copy the lib/wse-plugin-transcodertimedsnapshot.jar file from the package to the lib folder in your Wowza Streaming Engine installation ([install-dir]/lib).
  3. Restart Wowza Streaming Engine.


To enable this module, add the following module definition to your application configuration. See Configure modules for details.

Fully Qualified Class Name
TranscoderTimedSnapshot Takes snapshots of transcoder streams. com.wowza.wms.plugin.TranscoderTimedSnapshot


After enabling the module, you can adjust the default settings by adding the following properties to your application. See Configure properties for details.

/Root/Application transcoderTimedSnapshotStreamNames String myStream Comma-separated list of streams from which to save snapshots. (default: myStream)
/Root/Application transcoderTimedSnapshotHeight Integer 480 Height of snapshot images. If set to 0, the source stream height will be used. (default: 0)
/Root/Application transcoderTimedSnapshotWidth Integer 640 Width of snapshot images. If set to 0, the source stream width will be used. (default: 0)
/Root/Application transcoderTimedSnapshotInterval Integer 1000 Number of milliseconds between each snapshot. Minimum=1000 (1 second). (default: 1000)
/Root/Application transcoderTimedSnapshotImagePrefix String thumbnail_ Prefix that will be added to each image. (default: thumbnail_)
/Root/Application transcoderTimedSnapshotFormat String png File format of the snapshot images. Can be .png, .jpg, or .bmp. (default: .png)
/Root/Application transcoderTimedSnapshotTimestampImages Boolean true Add a time-stamp string to the saved image names. This will create a sequence of images. If set to false, the same image will be overwritten each time. (default: true)

For Developers

Source code is available on GitHub.

Wowza Media Systems™ provides developers with a platform to create streaming applications and solutions. See Wowza Developer Tools to learn more about our APIs and SDK.
Wowza media server software and all components, including modules, source code, and other related items offered on this page, are copyrighted (c) 2006-2016 by Wowza Media Systems, LLC, all rights reserved, and are licensed pursuant to the Wowza Media Software End User License Agreement.
Originally Published: For Wowza Streaming Engine 4.0.6 on 08-11-2014.
Updated: 09-28-2016.

If you're having problems or want to discuss this article, post in our forum.