Using @capgo/capacitor-device-info

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

Compatibility

This plugin requires Capacitor 8 or later (@capacitor/core >=8.0.0).

Install

npm install @capgo/capacitor-device-info
npx 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.
removeAllListeners - Remove every listener registered on the plugin.
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();

Monitoring defaults to a 1000 ms interval, clamps intervals below 250 ms, and emits an immediate sample unless you set emitImmediately: false. Calling startMonitoring() again restarts the active session with the new options. Each event includes its sequence, startedAt, and elapsedMs.

Use durationMs or sampleCount to stop automatically. If you no longer need any listener, call await DeviceInfo.removeAllListeners().

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.

Device Info

Tutorial on Device Info