An Android app for USB-C thermal cameras of the InfiRay family, made for the T2S+ and also supporting the P2 Pro, Topdon TC001 and related models. It works without the vendor apps. It shows real temperatures, takes photos, videos and temperature logs, and streams a live view with remote control to any browser in your Wi-Fi.
- Live thermal view with centre, hottest and coldest spot, a colour scale and a timestamp in the picture
- Measurement points: long-press to add, drag to move, drag onto the bin to delete (up to 8)
- Real temperatures from the camera's factory calibration; no manual calibration needed. Readings agree with the vendor app to within about 2 °C.
- Automatic shutter correction, repeated on its own while the camera warms up
- Lens shading correction against warmer edges and a cooler centre
- Photo and video (H.264) into the gallery album thermaLab, including all markers
- CSV temperature log of hottest, coldest, centre and every measurement point over time
- Live stream in the browser: a sharp view drawn in the browser itself, temperature under the mouse pointer, live table and line graph of the temperature log, photo and CSV download with your own file name patterns
- Remote control from the browser: set and move points, trigger the shutter, take photos, record video and CSV, change display settings. Files are always saved on the phone.
- Edit mode with live preview: show or hide clock, colour bar and each marker, drag clock and colour bar where you want them, rotate and mirror the image, choose the palette, turn the whole display for landscape use, set the label outline
- Fixed or automatic colour scale with a minimum span
The app recognises the camera on its own: first by its USB ID, otherwise by the shape of the video stream it offers.
| Camera | USB ID | Protocol | Status |
|---|---|---|---|
| InfiRay / Xinfrared T2S+ V2 ("T2S+_A2") | 04b4:0100 |
Xtherm | tested |
| T2S+ V2, other IDs seen in the wild | 1514:0001, 3474:6002 |
Xtherm | should work, untested |
| InfiRay P2 Pro | 0bda:5830 |
Tiny1-C | tested |
| Topdon TC001 (same module and USB ID as the P2 Pro) | 0bda:5830 |
Tiny1-C | should work, untested |
| Other Xtherm cameras: T2S+ V1, T2L, T3S, T3Pro, HT-301 (256, 384 or 640 px wide) | various | Xtherm | detected by stream size, untested |
| Other Tiny1-C modules (picture and temperatures in one double-height stream) | various | Tiny1-C | detected by stream size, untested |
Reports from owners of the untested cameras are very welcome: Settings → Diagnostics → Export produces a file with everything needed.
Any Android phone with USB-C host support and Android 7.0 or newer should do. Development and testing happened on a Xiaomi phone with Android 16.
Download the APK from the releases page and install it. Android asks you to allow installing apps from this source.
Or build it yourself, see Building.
- Plug in the camera. Android offers to open thermaLab; tick "always" if you like.
- Allow camera access (Android only grants USB access to video devices to apps with this permission) and USB access to the camera.
- The app recognises the camera and connects on its own. A T2S+ first runs a shutter correction; a loading screen shows until the image is clean.
- On the very first start the app offers to set up the lens shading correction (see below). You can also do it later.
The camera needs one to two minutes to warm up. During that time it drifts quickly; the app re-calibrates more often, so expect a few shutter clicks.
| Control | Action |
|---|---|
| PHOTO / VIDEO | Chooses what the release button does. |
| Release button | White: takes a photo (a short flash confirms it). Red dot: starts a video; a red square stops it, the elapsed time shows above. Photos and videos include all markers and go to the gallery album thermaLab. |
| Shutter | Closes the shutter and re-calibrates the image. Use it if the picture gets streaky or after big temperature changes. Greyed out for cameras that calibrate on their own (P2 Pro). |
| Settings | Scale, shutter, temperature log, live stream and diagnostics. |
| Gear with pencil (top right) | Edit mode, see below. |
In the picture:
- + centre temperature
- ▲ (red) hottest and ▽ (blue) coldest spot. They follow the scene smoothly and ignore changes below 0.2 °C, so they do not jump around on evenly warm surfaces.
- Numbered yellow discs are your measurement points.
The gear with the pencil at the top right opens a panel above the image. Every change shows live:
- Show: clock, colour bar, centre, max and min marker on or off
- Image: rotate in 90° steps, mirror, colour palette
- View: turn the whole display (image, colour bar, clock and markers together) for holding the phone in landscape. Photos, videos and the browser get the picture in this reading direction.
- Label outline: shadow, normal or thick outline around marker labels
While the panel is open, drag the clock or the colour bar in the image to move it; both snap to the edges and the centre. Done saves the layout, Reset layout restores the default.
- Long-press anywhere in the image to add a point. Keep your finger down to place it precisely.
- Drag a point to move it.
- Drag a point onto the bin that appears at the bottom to delete it.
Enable it in Settings → Temperature log and choose the interval (0.5 to 10 s). A second row of buttons appears:
- CSV starts, pauses and resumes the recording.
- Save CSV closes the file and opens the share sheet, so you can save it to your files, cloud storage or send it.
Each file starts with comment lines (#) describing the log. Whenever
measurement points are added or moved, a line lists their positions, followed
by a fresh column header:
# points: P1=(120,80) P2=(40,150)
time,elapsed_s,hottest_C,coldest_C,centre_C,P1_C,P2_C
2026-11-06 09:40:01,3.0,26.14,23.71,24.95,24.80,25.10
Point positions are sensor pixels (x 0–255, y 0–191) in the camera's own, unrotated orientation.
Settings → Live stream → Stream to browsers starts a web server on the phone.
The address (for example http://192.168.178.31:8080/) is shown with copy and
share buttons. Open it in any browser in the same Wi-Fi.
The browser view offers:
- the live image, drawn sharply at any size, with Fit / 75 % / 50 % size and Fullscreen
- the temperature under the mouse pointer
- Table: the temperature log beside the image, newest row on top, with an optional line graph below
- ⤓ Download: photo and CSV download with a file name pattern (see below)
With Allow remote control switched on, the browser can also trigger the shutter, take photos, record video, start, pause and close CSV logs, change display settings and work with measurement points (long-press or double-click to add, drag to move, drag onto the bin to delete). Everything is saved on the phone.
Stream frame rate (5 to 25 fps) limits the network load.
Privacy: the stream has no password. Anyone in the same network who knows the address can watch, and with remote control enabled also control the camera. Switch the stream off on networks you do not trust.
In the browser's download panel you can enter a pattern such as
Measurement_with_fan_. With Append date and time on, the current date and
time are added, for example Measurement_with_fan_2026-11-06_14-30-05.png. A
preview line shows the resulting name. The ? button lists all placeholders:
| Placeholder | Example |
|---|---|
{date} {time} {datetime} |
2026-11-06, 14-30-05, 2026-11-06_14-30-05 |
{yyyy} {yy} {MM} {dd} {HH} {mm} {ss} |
date and time parts |
{n}, {n:3} |
running number, optionally zero-padded (007) |
{max} {min} {centre} |
temperatures, e.g. 41.2C |
{p1} {p2} … |
temperature of a measurement point |
{palette} |
colour palette name |
- Display: fixed temperature scale (min/max) and minimum colour span (keeps evenly warm scenes calm instead of showing sensor noise). Everything else about the look is in the edit mode.
- Shutter: automatic shutter, lens shading correction, Measure lens shading
- Temperature log: CSV logging and interval
- Live stream: stream on/off, remote control, frame rate, address
- Advanced → Diagnostics: raw sensor data, model options, manual calibration against a known temperature, log and raw frame export
The lens and its housing make the edges of the picture read warmer than the centre (typically 2–3 °C). To correct this once per camera:
- Point the camera at a surface that has the same temperature everywhere: a plain wall, a closed door, or a sheet of paper a few centimetres in front of the lens (blurry is fine).
- Settings → Measure lens shading, hold still for about three seconds.
The centre readings stay as they are; the rest of the image is evened out to match. The size of the effect depends a little on how warm the camera is compared to the scene, so very hot or cold scenes are corrected approximately.
- Temperatures assume an emissivity of 0.95, which suits most matte, painted or organic surfaces. Bare and polished metal reads far too cold.
- Readings matched the vendor app within about 2 °C on a mug of hot water and within about 1.5 °C on a room-temperature wall.
- Give the camera a few minutes after plugging in before taking measurements that matter.
| Problem | Fix |
|---|---|
| "Plug in the camera" although it is plugged in | Tap Connect; check that camera and USB access were allowed. Close the vendor app; only one app can use the camera. |
| Image striped or noisy | Tap Shutter. |
| Readings drift after plugging in | Normal during warm-up; the automatic shutter catches up. |
| Browser shows "Connection lost" | Phone and computer must be in the same Wi-Fi; keep the app in the foreground. |
All supported cameras are USB Video Class devices. The app talks to them with its own copy of libuvc, not through Android's camera API. There are two protocol families.
-
Raw frames: after the command
0x8004the camera streams 256×196 YUY2 frames whose bytes are really little-endian 16-bit words: 192 rows of 14-bit sensor counts plus 4 rows of metadata (factory calibration constantscal00…cal05, focal-plane and shutter temperature, emissivity, distance, humidity, …). Converting the stream to RGB, as every webcam viewer does, destroys this data. -
Commands go through the standard UVC "Zoom, Absolute" control (camera terminal selector
0x0B), which the firmware uses as a register channel:Value Meaning 0x8000close the shutter (sent repeatedly it stays closed) 0x8004raw 16-bit mode 0x8020/0x8021range −20…120 °C / 120…450 °C 0x80FFcommit radiometric parameters (offset + i) << 8 | bytewrite parameter bytes (emissivity, distance, …) -
Temperatures come from a radiometric model: the metadata feed a Planck-style inversion with atmospheric transmission, evaluated into a 16384-entry table that maps every count to °C.
-
V2 units stream uncorrected counts. The app closes the shutter, averages a reference frame and subtracts it. The closed-shutter level is anchored at the count where the model returns the shutter temperature, and that temperature is taken from the focal-plane sensor, because the V2 shutter register does not track the real shutter.
-
V1 or V2: known USB IDs decide; otherwise the app measures the pixel-to-pixel noise of the first frames. Uncorrected V2 frames show strong stripes, frames a V1 camera has corrected itself do not.
- The camera offers a 256×384 YUY2 stream: the upper half is a ready-coloured picture, the lower half holds 16-bit temperatures, T(°C) = raw / 64 − 273.15.
- The module runs its own shutter calibration; the app has no command to trigger it, so the Shutter button is disabled.
- Commands are vendor control transfers (request
0x45out,0x44in, value0x78, the command address in wIndex), followed by polling until the module reports ready. The app uses them to set emissivity and to switch the gain (high gain = normal range, low gain = high-temperature range).
- Lens shading is a degree-4 polynomial surface fitted to a uniform scene and subtracted relative to the image centre.
- Inside the app, temperatures from Tiny1-C cameras are stored as counts on a linear scale (0.05 °C steps) so the same pipeline serves both families.
lib/
t2s/ frame decoding, commands, temperature model, shutter and
lens shading correction (pure Dart, unit tested)
probe/ camera controller (connection, frame loop, settings, markers)
and the diagnostics screen
render/ palettes, geometry (rotation, mirror) and the scene painter
shared by screen, photo, video and stream
app/ main viewer, settings and scene assembly
capture/ photo, video, CSV logger, live stream server and remote control
overlay/ phone camera overlay (hidden, see below)
assets/web/ the browser viewer (one HTML file, no external resources)
android/ app module, H.264 encoder (VideoEncoder.kt)
packages/flutter_ffi_uvc/ vendored libuvc plugin with raw frame access
test/ unit tests
Requirements: Flutter 3.35 or newer, Android SDK 36, NDK 27.0.12077973.
flutter pub get
flutter test
flutter build apk --release --target-platform android-arm64The app icon is generated by tools/make_icon.py (Python with numpy and
Pillow) and turned into launcher icons with
dart run flutter_launcher_icons.
The APK is in build/app/outputs/flutter-apk/app-release.apk.
Without a keystore, release builds are signed with the debug key, which is
fine for testing. For releases, create a key once (keytool comes with
the JDK) and keep it, together with its passwords, safe and outside the
repository: Android only installs updates signed with the same key.
keytool -genkeypair -v -keystore ~/keys/thermalab-release.jks -alias thermalab -keyalg RSA -keysize 4096 -validity 10000Then create android/key.properties (ignored by git):
storeFile=C:/Users/you/keys/thermalab-release.jks
storePassword=...
keyAlias=thermalab
keyPassword=...flutter build apk --release picks it up automatically.
The phone's USB port is taken by the camera, so use wireless debugging (Android 11+): enable Developer options → Wireless debugging, then
adb pair PHONE_IP:PAIRING_PORTadb connect PHONE_IP:PORTThe app logs to logcat with the prefixes [probe], [capture] and
[overlay]; every 75 frames it prints a line with frame rate, sensor and
shutter temperatures and the centre reading. Diagnostics → Export shares a
raw frame, the shutter reference and a JSON report with all metadata.
The phone serves assets/web/index.html and a WebSocket at /ws.
- Phone → browser: one binary message per frame:
[uint32 LE header length][header JSON][pad to even][int16 LE grid]. The grid holds temperatures in 0.1 °C in sensor orientation, row-delta coded so that WebSocket compression shrinks it well. The header carries scale, markers, timestamp, settings, recording and CSV state, and the palette as a colour table whenever it changes. - Browser → phone: JSON commands,
{"c": "ack"}after each frame (flow control, at most two frames in flight) and remote-control commands such asshutter,photo,record,csv,csvNew,add,move,removeandset(key/value display settings). - HTTP:
/csvreturns the current or last CSV log,/csvdata?from=Nthe log rows from index N as JSON for the live table.
Camera overlay (hidden)
An overlay of the phone's own camera (edges or blend, with automatic
alignment) is implemented in lib/overlay/ but switched off in
lib/overlay/overlay_feature.dart: it costs too much performance, and one
calibration only fits one distance, because the two cameras are about 10 cm
apart and there is no depth information.
- Frame layout, commands and the radiometric model are ported from IR-Py-Thermal (GPL-3.0).
- The Tiny1-C stream layout and vendor commands follow P2Pro-Viewer and PyThermalCamera.
- V2 findings from t2s-thermal-macos and Dmytro Engineering.
- USB access through a modified copy of
flutter_ffi_uvc (BSD-3-Clause),
see
packages/flutter_ffi_uvc/FORK.md.
GNU General Public License v3.0, see LICENSE. The vendored flutter_ffi_uvc plugin keeps its BSD-3-Clause licence.
InfiRay, Xinfrared and Xtherm are trademarks of their respective owners. This project is not affiliated with them.