Skip to main content
Back to plugins
@capgo/capacitor-device-info
Tutorial
@capgo/capacitor-device-info

Device Info

Read CPU, memory, GPU, storage, thermal state, and onboard sensor metrics from Capacitor apps

Guide

Tutorial on Device Info

Test on device

Download the Capgo app, then scan the QR code.

Device Info plugin preview QR code

Using @capgo/capacitor-device-info

Read CPU, memory, GPU, storage, thermal, low-power, and onboard sensor metrics from a Capacitor app.

Install

bun add @capgo/capacitor-device-info
bunx cap sync

What This Plugin Exposes

  • getInfo - Read one snapshot with CPU, memory, GPU, storage, thermal state, low-power mode, and onboard sensors.
  • startMonitoring - Start periodic snapshots for charts and diagnostics dashboards.
  • stopMonitoring - Stop the active stream.
  • isMonitoring - Check stream status and emitted sample count.
  • deviceInfoUpdate - Listener event emitted for each periodic sample.

Example Usage

import { DeviceInfo } from '@capgo/capacitor-device-info';

const snapshot = await DeviceInfo.getInfo();

console.log(snapshot.cpu.cores);
console.log(snapshot.memory.usedPercent);
console.log(snapshot.gpu?.renderer);
console.log(snapshot.sensors?.pressureHpa);

Stream Metrics Into A Chart

import { DeviceInfo } from '@capgo/capacitor-device-info';

const samples: number[] = [];

const handle = await DeviceInfo.addListener('deviceInfoUpdate', (sample) => {
  if (typeof sample.cpu.usagePercent === 'number') {
    samples.push(sample.cpu.usagePercent);
  }
});

await DeviceInfo.startMonitoring({
  intervalMs: 1000,
  emitImmediately: true,
});

// Later:
await DeviceInfo.stopMonitoring();
await handle.remove();

Onboard Sensor Notes

Sensor readings are optional because devices expose different hardware. Android can report battery temperature, ambient temperature, humidity, barometric pressure, light, proximity, and best-effort CPU/GPU thermal-zone values when available. iOS reports CoreMotion sensor availability, thermal state, and low-power state, but public iOS APIs do not expose raw CPU or GPU temperature.

The plugin does not fetch weather data. Outside temperature and humidity require a separate location and weather API integration.

Full Reference

Keep Going

If you are using @capgo/capacitor-device-info to build diagnostics or monitoring screens, connect it with @capgo/capacitor-device-info for the overview, Getting Started for install and API examples, Using @capgo/capacitor-barometer for dedicated pressure streaming, and Using @capgo/capacitor-light-sensor for dedicated light readings.