Skip to main content
Capgo logo
Back to plugins
@capgo/capacitor-device-info
Tutorial
by github.com/Cap-go

Device Info

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

Downloads/week

0

GitHub Stars

0

Guide

Tutorial on Device Info

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.