ByteFlow.Net is a zero-dependency .NET library for converting raw byte values to and from human-readable formats. Features: - Supports both IEC (KiB, MiB, GiB) and SI (KB, MB, GB) unit standards - Culture-aware parsing and formatting (e.g., 1.5 MB vs 1,5 MB) - Customizable suffix sets for non-standard or domain-specific units - Alignment/padding helpers for clean console and tabular output - Fully tested with 100% code coverage Ideal for developers needing clear, reliable byte size conversions in .NET applications — with no external dependencies.
Get Started
$ dotnet add package ByteFlow.NetReadme
ByteFlow.Net
A lightweight .NET library for converting bytes into human-readable formats (KB, MB, GB, etc.) and back again.
✨ Features
- Convert bytes into human-readable strings (
1234567 → "1.18 MB"). - Parse strings back into bytes (
"2.5 GB" → 2684354560). - Safe parsing with
TryParseHumanBytes. - Zero dependencies, just clean C#.
- Works on .NET Framework (4.6.1+) and all modern .NET versions (Core, 5/6/7/8).
📦 Installation
Install from NuGet:
dotnet add package ByteFlow.Net
🚀 Usage
using ByteFlowNet;
// Convert bytes to human-readable string
long size = 1234567;
Console.WriteLine(size.ToHumanBytes()); // "1.18 MB"
Console.WriteLine(size.ToHumanBytes(3)); // "1.177 MB"
// Parse string back into bytes
long bytes = "2.5 GB".ToBytes(); // 2684354560
Console.WriteLine(bytes);
// Safe parsing
if ("10 MB".TryParseHumanBytes(out var val))
{
Console.WriteLine(val); // 10485760
}