ilabs-flir (Modular Thermal Camera Plugin)

A professional, high-fidelity React Native wrapper for the FLIR Thermal SDK (iOS & Android). This package is designed as a standalone, "Lego-like" module that can be dropped into any React Native project to add professional-grade thermal imaging capabilities.

🚀 Installation

npm install ilabs-flir

Automatic Native Configuration

This package includes a sync script that automatically patches your iOS Info.plist and Android AndroidManifest.xml with required FLIR permissions and hardware protocols.

node node_modules/ilabs-flir/scripts/sync-native.js

📺 Usage

1. The Thermal Preview Component

The most efficient way to display a live thermal stream. This component renders directly from the native buffer, bypassing the React Native bridge for maximum performance.

import { ThermalPreview } from 'ilabs-flir';

const MyCameraApp = () => {
  return (
    <ThermalPreview 
      style={{ flex: 1 }} 
      onFrameUpdate={(event) => {
        // Optional: track frame metadata
        console.log("Frame size:", event.nativeEvent.width, event.nativeEvent.height);
      }}
    />
  );
}

2. Controlling the Camera

The FlirModule provides a robust API for managing the thermal lifecycle.

import { FlirModule } from 'ilabs-flir';

// 1. Start discovery (finds USB-C, Lightning, and Edge/Wireless devices)
await FlirModule.startDiscovery();

// 2. Connect once a device is found
await FlirModule.connectToDevice(deviceId);

// 3. Change Palette
// Supported: "WhiteHot", "Iron", "Rainbow", "Arctic", "Lava", "Coldest", "Hottest", "Wheel"
await FlirModule.setPalette("Iron");

// 4. Get Spot Temperature
const temp = await FlirModule.getTemperatureAt(320, 240);
console.log(`Surface Temp: ${temp.toFixed(1)}°C`);

3. Accessing the Stream (Bitmap)

If you need to process thermal frames manually (e.g., for AI/ML or custom overlays), you can access the latest frame as a bitmap.

// Get the latest frame as a temporary file path
const path = await FlirModule.getLatestFramePath();

// Get the latest frame as a Base64 string
const { base64 } = await FlirModule.getLatestFrameBitmap();

🏗 Modular Architecture (Zero-Entanglement)

ilabs-flir is built to be "Toggleable". In your main app, you can use Reflection-based bridges (Java/Objective-C) to interact with this module. This allows your main application to compile and run perfectly even if the ilabs-flir module is physically removed from the project.

Why this matters:

• Build Speed: Disable thermal features in dev builds to speed up compilation.
• App Store Compliance: Toggle thermal permissions on/off based on build targets.
• Modular Maintenance: Update the FLIR SDK within this package without touching your core application logic.

📋 Requirements

• iOS: 13.0+, Physical device required (FLIR ONE/Edge).
• Android: SDK 24+, Kotlin 1.9+, Java 21+.
• Hardware: FLIR ONE Gen 3, FLIR ONE Pro, or FLIR ONE Edge Pro.

📄 License

Plugin Wrapper: MIT. FLIR SDK: Proprietary. You must comply with FLIR's Developer Terms.

Made with ❤️ by Praveen Ojha