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.0"

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