October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk7 min

How to Extract DVR Clips with the Wowza Streaming Engine API

Convert an existing Wowza nDVR store into an MP4 clip using the REST converter or Java example, and avoid common timestamp and cache mistakes.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To export part of an existing Wowza nDVR recording as an MP4, identify the correct nDVR store and run Wowza Streaming Engine’s converter. The REST API accepts UTC Unix timestamps for start and end by default, or a duration in milliseconds; its optional DVR time mode changes the time basis. Wowza’s Java API example uses different parameters: offsets in milliseconds from the store’s beginning and end. Choose the route and clock deliberately—conversion exports footage already recorded in a store; it cannot recover footage that was never recorded.

Before converting: confirm the nDVR recording exists

Wowza nDVR records a live stream as it is ingested. The conversion API works on a recorded store, so first confirm the intended stream was recorded and that its store covers the period you need. Wowza’s setup documentation notes that a disconnected live source may prevent recording. Engine must be licensed and configured for nDVR. See Wowza’s nDVR store guide and nDVR setup documentation.

As an Amazon Associate I earn from qualifying purchases.

DVR playback and file extraction are separate operations: playback with DVR controls is supported over HLS and MPEG-DASH, while exporting a shorter MP4 uses the converter. The setup guide describes using ?DVR in a playback URL for DVR controls; that is not the converter endpoint.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose the API route that matches your integration

Route Clip boundaries Version and operational notes
REST converter action UTC Unix start/end timestamps by default, or duration in milliseconds; can select DVR time instead of UTC. Wowza’s guide says Engine 4.3.0 or later; the API reference lists the converter action for builds 15942 or later. Supports a single store and documented grouped ABR conversion.
Java API converter example startoffset and endoffset in milliseconds, measured from the store’s beginning and end respectively. Wowza’s example says Engine 4.4.0 or later. It uses a custom Engine-side HTTP provider and caches conversion settings for up to 30 minutes.

The REST workflow below is the direct documented operation when you want to invoke conversion through the Engine REST API. Use the Java example when its custom provider and offset model suit your integration; its endpoint and parameter names are not interchangeable with REST. Sources: Wowza’s REST conversion guide, Java API converter example, and REST API reference.

#1 Best Overall
Upgraded PowerPlay DVR Video Recorder, 60fps Video Capture & Recording for FPV, Camcorder, VHS, 8mm, Hi8, Mini DV Player, Analog AV/RCA to Digital Converter
  • Upgraded High-Efficiency Recording – Capture smooth, high-quality video with advanced compression and 60fps frame rate, preserving detail while reducing file size. Perfect for FPV recording or archiving vintage footage
  • Analog to Digital Converter for Camcorders & VCRs – Digitize VHS, VHS-C, 8mm, MiniDV, and Digital8 tapes directly to micro SD card (up to 512GB Class 10). Ideal for home video preservation, retro content creators, and video archivists
  • Resolutions – Build-in 2.4 inch 640 × 480 RGB LCD screen. Records video at AV 720x576 (PAL) 50fps, 720x480 (NTSC) 60fps
  • Portable DVR with Clip Mount – Compact, lightweight design includes a clip mount for hands-free use and easy portability. Great for field recording, on-the-spot transfers, and mobile video capture
  • Complete Kit – Ready to Use – Includes PowerPlay DVR, clip mount, and AV cable. Features built-in rechargeable battery support (battery not included) and a power indicator for uninterrupted recording. Suggest use 2X 18500 LI-ION CELLS as the power section

Extract a clip with the REST API

  1. Set the deployment-specific path values. The route uses your server name, vhost, application, instance, and nDVR store name. In the API reference, the instance defaults to _definst_; use the actual instance configured on your Engine. Wowza’s guide shows local examples at http://127.0.0.1:8087 as templates, not universal endpoint details. The REST API reference specifies basic authentication; keep credentials private and use the authentication and network protections appropriate to your deployment.
  2. List stores for the application instance. Send a GET request to /v2/servers/{serverName}/vhosts/{vhostName}/applications/{appName}/instances/{instanceName}/dvrstores. Select the store corresponding to the recording you intend to export.
  3. Inspect the selected store. Send a GET request to that same path with /{dvrStoreName} appended. Check the returned audio/video availability, live status, DVR time boundaries, duration, UTC boundaries, and conversion status. Confirm the store spans the desired clip before requesting conversion.
  4. Send a conversion request. Use PUT on /v2/servers/{serverName}/vhosts/{vhostName}/applications/{appName}/instances/{instanceName}/dvrstores/{dvrStoreName}/actions/convert. A successful response indicates that conversion started; it is not itself confirmation that a finished MP4 is available.
  5. Supply the clip selection and output options. Add the documented converter query parameters for the desired time range, output filename, or other conversion settings. Check the status through the store endpoint and the conversion status information before treating the export as complete.

These are route templates: substitute values from your own Engine configuration. Do not expose a publicly reachable unauthenticated endpoint or credentials in scripts, logs, or shared examples. Wowza documents additional converter options, including the default output directory based on the application’s StorageDir, audio/video synchronization options, and store lists in the REST API reference.

Selecting the time range

  • Start and end: dvrConverterStartTime and dvrConverterEndTime use UTC Unix timestamps by default. Supply the intended absolute UTC boundaries, not offsets from the store’s beginning.
  • Duration: dvrConverterDuration is in milliseconds. It cannot be combined with either start or end, so choose duration-based selection or boundary-based selection rather than mixing them.
  • DVR time: Set dvrConverterTimeType=DVR when selecting by DVR time rather than the default UTC basis. Verify that the timestamps you provide match the selected time type.

For an ABR group, Wowza’s guide uses the collection route /dvrstores/actions/convert with a comma-separated dvrConverterStoreList query parameter. Follow the guide’s grouped-store syntax for your deployment rather than assuming the single-store action automatically converts every rendition.

Rank #2
Sale
Portta VHS to Digital Converter, Video to Digital Recorder with Remote, Compatible with VHS, VCR, DVR, DVD, Hi8, Mini DV, Gaming Consoles (VCR, VHS/DVD Player, Camcorder Required)
  • 【Video to Digital Converter】Effortlessly convert and store analog video and audio signals into digital formats, Recording resolution up to 1080P 30Hz. Supports AV/RCA (CVBS+R/L), S-Video, and AUX inputs. Plug and play, No PC, Software, Driver Needed. NOTE: This is a Converter/Recorder/Capture box only, can NOT play with any tapes and DVDs independently.
  • 【USB/SD Card for Storage】Equipped with a 3.0" preview LCD and built-in speaker. No capacity limitation for the USB drive or TF card (not included). Enables direct playback of recorded videos and audios, as well as preview snapshots on the capture box. For high-capacity USB storage devices, please ensure using its own power supply.
  • 【Video & Audio Format】Store video in MP4 format or audio in MP3 format. Supports NTSC-M/J 3.58, NTSC 4.43, PAL B/G/H/I/D (PAL/N) standard TV formats input. Audio sampling rate up to 48KHz with uncompressed 2-channel LPCM digital audio output. Setup Reminders: Ensure either CVBS R/L (AV input) or AUX-IN (3.5mm) is properly connected. In settings (HOME -> Settings), verify Video-IN-Volume and AUX-IN-Volume are unmuted for the selected input.
  • 【Broad Compatibility】Supports recording and digitizing video for VHS, VCR, DVR, DVD, Hi8, camcorders, Mini DV, Cassette Tape Player, and retro gaming consoles.
  • 【What You Get】Video Recorder x1(Players Not included, Such as VHS, VCR, Camcorder, VHS, VCR, DVR, DVD, Cassette, Hi8, Mini DV Players, Camcorder, Gaming Consoles ), Power Adapter with USB type A to C Cable x1, Remote Control (2*AAA Batteries Not Included) x1, AV Cable x1, 3.5mm Audio Cable x1, User Manual x1 with a hassle-free 2-year warranty and lifetime technical support. Reach out to our friendly customer service for any questions.

Conversion tolerances and interleave delay

Wowza documents dvrConverterTolerance in Engine 4.7.5 and later. Its default is 1,000 milliseconds, allowing conversion to run past the specified duration while applying the last nDVR GOP; do not assume this produces an exact frame-level boundary. The guide also documents an interleave-delay setting from Engine 4.7.0.01: it is enabled by default at 100 milliseconds and can be adjusted from 0 to 2,000 milliseconds. Higher values increase conversion time while reducing storage I/O saturation. Consult the REST guide for the exact option name and syntax supported by your build.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Understand the time basis before choosing clip boundaries

Wowza describes three relevant clocks: DVR time, packet time, and UTC. They do not mean the same thing. DVR time begins at zero and advances in milliseconds, but does not include gaps when a source stops sending or when append mode is used. Packet time preserves encoder timestamps. UTC is assigned as packets enter the nDVR module; it is only a rough indication of when Wowza received them, not an exact timestamp for when they left the encoder. See Wowza’s nDVR setup documentation.

Rank #3
Sale
ZOSI H.265+ 16 Channel 3K Lite Security DVR Recorder, Hybrid 4-in-1, NO HDD
  • (1). [ Smart AI Motion Detection & Alerts push ] __ Powered by AI-based detection technology, this DVR identifies human and vehicle movement to help reduce false alerts caused by animals or other objects. Customize motion detection zones for each camera and receive instant push notifications and email alerts with snapshots when motion events occur.
  • (2). [ 4-in-1 1080P 16CH DVR ] __ This hybrid 16-channel 1080p DVR supports 960H Analog, 720P/1080P AHD, 720P/1080P TVI, and CVI cameras with self-adaptive technology. No hard drive included; external hard drives are not supported. For better compatibility and performance, pairing with ZOSI cameras is recommended.
  • (3). [ Local or Remote Access Anytime & Anywhere ] __ View and control your security system locally by connecting the DVR to a monitor, or remotely access it through ZOSI Client software on Windows/Mac or the ZOSI Smart App on iOS and Android devices.
  • (4). [ Customize Each Camera with Different Record Modes ] __ Choose from four recording modes to match different monitoring needs: continuous recording, scheduled recording, motion detection recording, and recycle recording. Each camera channel can be configured separately, and recording files can be exported through USB backup.
  • (5). [ Advanced H.265+ High Video Compression ] __ ZOSI H.265+ video compression technology optimizes storage efficiency while maintaining image quality. Compared with H.264, it helps reduce storage usage and provides smoother playback. This DVR does not support IPC or PoE cameras, wireless cameras, or analog cameras above 2MP.

If you need a clip around a real-world wall-clock event, UTC may help locate the approximate period, but it does not prove the encoder-origin time exactly. Check store boundaries and preview the resulting file in your workflow. Do not assume the REST timestamp inputs and Java offsets refer to the same clock.

Use Wowza’s Java converter example when offsets fit better

Wowza’s Java API example provides a converter HTTP provider that a developer compiles with the Wowza IDE and enables in the Engine virtual-host configuration. Its sample endpoint is http://[wowza-ip-address]:1935/converter; this is the example’s custom provider, not the REST action route. Follow the Java converter instructions for compiling, enabling, and issuing the example’s convert, status, and expire commands.

Rank #4
Sale
ZOSI 1080P H.265+ 8CH Hybrid 4-in-1 CCTV DVR Recorder, No Hard Drive
  • 8CH 1080P DVR recorder: This 8CH 1080P 4-in-1 wired DVR is designed for professional-grade surveillance, offering support for analog, HD-TVI, CVI, and AHD cameras. With its 8 channels, it allows you to connect up to 8pcs 720P or 1080P CCTV cameras(support up 1080p), providing comprehensive coverage for your home or business. NOTE: This DVR is Not compatible with WiFi camera, IP Camera and PoE camera.
  • Advanced Person & Vehicle Detection: ZOSI DVR goes beyond traditional motion detection, thanks to its built-in AI technology. When paired with ZOSI CCTV cameras, it can accurately detect and identify humans and vehicles, ensuring that you receive timely alerts for any potential security threats. This intelligent feature gives you peace of mind and enhances the overall effectiveness of your surveillance system.
  • Easy Setup & Remote Access: This wired DVR offers simple installation and supports family sharing. Multiple family members can remotely view live footage anytime, anywhere via the ZOSI Smart App. For remote access, ensure the DVR is connected to your router. We recommend updating both the DVR firmware and ZOSI Smart App to the latest versions and watching the product installation and operation videos before setup.
  • Versatile recording modes and Customizable Detection Zone: ZOSI DVR supports four different recording modes, including continuous recording, scheduled recording, motion-triggered recording, and recycle recording (Note: A hard drive is required for recording, not included). This flexibility allows you to tailor your surveillance system to your specific needs and optimize storage usage. Furthermore, you can customize the motion detection area, focusing on important locations and minimizing false alarms.
  • Hard Drive Not included: Please note that this DVR system does not include cameras or a hard drive; for recording, you must install a 3.5-inch SATA surveillance-grade hard drive (Recommended: 500GB-2TB), as standard desktop hard drives are not compatible. To ensure perfect compatibility and access to all features, it is recommended to use this DVR with ZOSI 1080p analog CCTV cameras.

In that example, startoffset is milliseconds from the beginning of the store, and endoffset is milliseconds from the end. A zero offset means use the beginning or end, respectively. Conversion settings are cached for up to 30 minutes; if you change parameters and repeat a conversion for the same store, use the example’s expire command to clear the cache before expecting the new settings to take effect. For version-archive storage, use the base stream name rather than a version-specific suffix so all versions are included.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot common extraction problems

  • No matching store or the desired period is missing: list and inspect stores before converting. Check store name, stream, status, duration, and time boundaries; conversion cannot create unrecorded footage.
  • The clip covers the wrong time: verify whether the REST request is using default UTC or explicitly selected DVR time. For the Java example, re-check that offsets are measured from opposite ends of the store, both in milliseconds.
  • Duration and boundary parameters conflict: remove dvrConverterDuration when using start or end; duration cannot be combined with either boundary parameter.
  • Changed Java parameters appear to have no effect: clear the converter cache with the example’s expire command. Its settings may remain cached for up to 30 minutes.
  • Conversion starts but the file is not where expected: check conversion status and the application’s StorageDir-based default output location, or verify the output filename and configured options in the REST reference.
  • The result differs slightly from the requested duration: review the applicable GOP tolerance behavior and Engine version. Wowza documents a default 1,000 ms tolerance for the relevant setting in Engine 4.7.5 and later; exact frame-level output is not established by these API descriptions.
  • Recording stopped or has a gap: investigate the ingest connection and nDVR recording setup. Wowza notes a disconnected live source may prevent recording; an export cannot bridge footage that was not stored.

Copyright and YouTube reuse considerations

Extracting a clip does not grant rights to the underlying audio or video. Before publishing or redistributing an MP4, confirm you have permission for the material and any music, performances, or third-party footage it contains. If you plan to loop a recorded video as a YouTube live stream, review the rights and platform requirements for that use; an API export is not a copyright clearance.

Best Value
Sale
ANNKE 8 Channel 3K Lite H.265+ Security DVR Recorder, Hybrid 5-in-1, NO HDD
  • Note: No hard drive included. This DVR supports max. 10TB storage.
  • 5-in-1 Hybrid DVR – The expandable DVR combines the features of DVR/NVR/HVR, supports up to 8 pcs TVI, AHD, CVI, CVBS & extra 2 IP cameras. Note: This DVR is recommended to be used in conjunction with ANNKE cameras for an enhanced user experience.
  • Advanced H.265+ Video Format – H.265+ coding offers longer recording time before having to overwrite the older recordings, saving up to 80% of storage space than H.264 systems. You'll enjoy fast & smooth streaming without latency when accessing the DVR.
  • Innovative Human & Vehicle Detection – By setting up the human & vehicle detection, you will get motion detection alerts only when people and vehicles are in the frame. Minimizing unwanted alerts triggered by bugs, animals, leaves and so on.
  • Remote Access with All Devices – Link the DVR to a router and download ANNKE Vision App to control it remotely. Access the DVR via 3G/4G/5G or smartphones, tablets, computers and browsers (Google Chrome, Firefox, Microsoft Edge, Internet Explorer, etc.)

Or let it run in the cloud

For the separate task of keeping uploaded videos live on YouTube, StreamNeo is a cloud option: upload a recording or build a playlist, add your YouTube stream key once, and go live. It loops uploaded videos rather than streaming from a camera, and it does not replace Wowza’s nDVR clip-extraction API.

  • Your computer and home connection do not have to stay on.
  • Each slot streams the uploaded quality as made, up to 4K 60fps, at one flat price per slot; there are no quality tiers or re-encoding.
  • Automatic recovery is included if YouTube drops the stream.
  • The first day is free with no card, one free day per account.
  • Monthly: $9.99 per month.

Start the free day at StreamNeo registration.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.