Skip to main content

What is Reconstructed Video and how to use it?

Reconstructed Video overview, difference between Reconstructed vs Standard video, how to activate the feature, benefits and limitations.

This feature is only available on macOS.

Overview

The Reconstructed Video feature is a smarter way to gain visibility into user activity on Mac. While the Standard Video mode captures constant images of the desktop, the Reconstructed Video feature utilizes our new UI Scanning Engine. It intelligently rebuilds the user’s desktop view in real time using UI metadata, system events, and extracted text. This approach ensures uninterrupted visual monitoring on Mac systems where screen recording permission isn’t available.

How it Works

The technology captures textual content, control types, and bounding rectangles from all active windows. This data is then used to "reconstruct" a visual representation of the user’s desktop within the Session Player. The feature is available for both Live View and History View modes.

Here’s how a reconstructed video looks compared to the original desktop side by side:

Benefits of the Reconstructed Video

  • Simplified Permissions: Only the Accessibility permission is required, which can be enabled proactively via MDM software (e.g., JAMF) without requiring direct user consent. This eliminates the need for explicit Screen Recording permission.

  • Stealth Recording: Bypasses the standard macOS privacy indicator (the "Purple Dot") to maintain a discreet and invisible presence for the Agent.

  • Intelligent and Manual Fallback: The Session Player automatically defaults to the reconstructed video if screen recording permission is unavailable. When the permission is available, you can seamlessly switch between the reconstructed video and the normal video mode within the Session Player.

  • Optimized Performance: Features both lower CPU usage and high-speed screen scanning, with most captures completing within a few seconds.

Limitations of the Reconstructed Video

  • Visual Fidelity: The video output is currently limited to black and white.

  • App Compatibility: Application support is limited to those apps using the Accessibility API. Some Electron-based apps (e.g., Discord, Teams, VSCode) have limited support, while others like Slack are fully supported.

  • Text: Text in pictures, charts, PDFs, etc. aren’t captured.

  • Widget Integration: The feature is not yet available for widgets such as Screen Snapshots.

  • Export Capabilities: Video export is not yet supported.

How to Use the Feature

Enable Reconstructed Video

Step 1: Install the macOS Agent with the Correct Permission

If you haven't done so already, install the Teramind Agent with at least the Accessibility permission:

Step 2: Enable Reconstructed Video

1. Navigate to Configurations > Monitoring Profiles and select a profile:

2. If not already enabled, click the toggle button next the Reconstructed Video to enable it.

3. Optionally, you can click the Edit button to open the settings panel to configure the monitoring schedule. Note that the monitoring schedule is shared with Screen Recording. Changes here also apply to Screen Recording, and vice versa.

You can override the setting for an employee from their profile's Monitoring tab.

Step 3: Switch Between the Standard / Reconstructed Video Modes

Once the feature is enabled, you can toggle between the Reconstructed Video and Standard Video mode by toggling the Picture button in the Session Player:

Session Player Behavior Based on Monitoring Settings

Scenario

What's Available in Session Player

  • Screen Recording: Enabled

  • Reconstructed Video: Enabled

Both Standard & Reconstructed Video playback modes are available.

  • Screen Recording > Record only when behavior rule was violated: Enabled

  • Reconstructed Video: Enabled

Both Standard & Reconstructed Video playback modes are available for the duration of the rule violation events.

  • Screen Recording: Enabled

  • Reconstructed Video: Disabled

Standard Video playback only.

  • Screen Recording: Disabled

  • Reconstructed Video: Enabled

Reconstructed Video playback only.

  • Screen Recording: Disabled

  • Reconstructed Video: Disabled

No Playback. The Session Player will be empty.

Screen Recording (Standard Video) requires the macOS Screen Recordings and Accessibility permissions while the Reconstructed Video requires only the Accessibility permission. Check out this article to learn how to set up macOS permissions.

FAQ

1. Do I need to enable Screen Recording to use Reconstructed Video?

No. Reconstructed Video operates independently.

2. Will enabling Reconstructed Video trigger a macOS system notification?

No. macOS privacy notifications are only triggered by Screen Recording. Reconstructed Video relies strictly on Accessibility permissions, which do not prompt those specific system alerts.

3. If I change the Monitoring Schedule in Reconstructed Video, will it affect Screen Recording?

Yes. Both features share the same underlying schedule. Updating the time or rules in either settings modal will automatically apply the changes to both features.

4. Is OCR affected if I disable Reconstructed Video?

No. The OCR feature operates independently. Turning off Reconstructed Video will not impact OCR performance or functionality.


Did this answer your question?