Getting Started

Installation

Using Tauri CLI (Recommended)

yarn tauri add device-info

Manual Installation

1. Add the Rust dependency:

# src-tauri/Cargo.toml
[dependencies]
tauri-plugin-device-info = "1.0"  # See https://crates.io/crates/tauri-plugin-device-info for latest

2. Add the JavaScript package:

yarn add tauri-plugin-device-info-api

Setup

Register the plugin in your Tauri app:

// src-tauri/src/lib.rs (Tauri v2)
fn main() {
    tauri::Builder::default()
        .plugin(tauri_plugin_device_info::init())
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

Permissions

Add the required permissions to your capabilities:

// src-tauri/capabilities/default.json
{
  "permissions": ["device-info:default"]
}

Or add individual permissions:

• device-info:allow-get-device-info
• device-info:allow-get-battery-info
• device-info:allow-get-network-info
• device-info:allow-get-storage-info
• device-info:allow-get-display-info

Basic Usage

import {
  getDeviceInfo,
  getBatteryInfo,
  getNetworkInfo,
  getStorageInfo,
  getDisplayInfo,
} from "tauri-plugin-device-info-api";

async function loadDeviceInfo() {
  // Device information
  const device = await getDeviceInfo();
  console.log(`Device: ${device.model}`);
  console.log(`Manufacturer: ${device.manufacturer}`);

  // Battery status
  const battery = await getBatteryInfo();
  console.log(`Battery: ${battery.level}%`);
  console.log(`Charging: ${battery.isCharging}`);

  // Network information
  const network = await getNetworkInfo();
  console.log(`IP: ${network.ipAddress}`);
  console.log(`Type: ${network.networkType}`);

  // Storage information
  const storage = await getStorageInfo();
  console.log(`Total: ${storage.totalSpace} bytes`);
  console.log(`Free: ${storage.freeSpace} bytes`);

  // Display information
  const display = await getDisplayInfo();
  console.log(`Resolution: ${display.width}x${display.height}`);
  console.log(`Refresh Rate: ${display.refreshRate}Hz`);
}

TypeScript Types

All types are exported and can be imported:

import type {
  DeviceInfoResponse,
  BatteryInfo,
  NetworkInfo,
  StorageInfo,
  DisplayInfo,
} from "tauri-plugin-device-info-api";

Next Steps

• Check out the API Reference for detailed documentation
• See Platform-specific notes for each operating system
• View Examples for real-world usage patterns