Storage Monitor

A Flutter plugin to query disk space on Android — available and total — with built-in unit conversion and smart formatting.

Features

• Raw bytes via getAvailableDiscSpace() / getTotalDiscSpace()
• Explicit unit conversion via getAvailableDiscSpaceAs(StorageUnit.mb)
• Auto-picks the most readable unit via getAvailableDiscSpaceSmart()

Usage

import 'package:storage_monitor/storage_monitor.dart';

Raw bytes

final int? bytes = await StorageMonitor.getAvailableDiscSpace();

Explicit unit

final double? mb = await StorageMonitor.getAvailableDiscSpaceAs(StorageUnit.mb);
final double? gb = await StorageMonitor.getTotalDiscSpaceAs(StorageUnit.gb);

Smart formatting

The smart methods pick the largest unit where the value is ≥ 0.1.
For example, 85 MB (= 0.08 GB) is returned as 85.00 MB, not 0.08 GB.

final StorageSize? available = await StorageMonitor.getAvailableDiscSpaceSmart();
final StorageSize? total    = await StorageMonitor.getTotalDiscSpaceSmart();

print(available);        // e.g. "85.00 MB"
print(total);            // e.g. "128.00 GB"

// Access value and unit separately:
print(available?.value); // 85.0
print(available?.unit);  // StorageUnit.mb
print(available?.unit.label); // "MB"

StorageUnit

Value	Label
StorageUnit.bytes	B
StorageUnit.kb	KB
StorageUnit.mb	MB
StorageUnit.gb	GB

License

This project is licensed under the MIT license.