MegaClient 1.0.0

MegaClient

MegaClient is a C# .NET library to access mega.nz cloud storage and file hosting service.

This is an actively maintained fork of MegaApiClient by Gregoire Pailler, updated for modern .NET (6, 7, 8) and netstandard2.0/2.1.

Installation

dotnet add package MegaClient

Or via NuGet Package Manager:

Install-Package MegaClient

Quick Start

using CG.Web.MegaApiClient;

var client = new MegaApiClient();

// Login with email and password
client.Login("email@example.com", "password");

// Login anonymously
client.LoginAnonymous();

// Logout
client.Logout();

Features

• ✅ Authentication: Email/password, anonymous, MFA support, session tokens
• ✅ File Management: Upload, download, rename, move, delete
• ✅ Folder Management: Create, navigate, share
• ✅ Sharing: Generate public download links
• ✅ Streaming: Stream-based download/upload with progress reporting
• ✅ Async API: Full async/await support
• ✅ Cancellation: CancellationToken support on all operations
• ✅ Modern .NET: Targets net6.0, net7.0, net8.0, netstandard2.0, netstandard2.1

Usage Examples

List files

var nodes = client.GetNodes();
var root = nodes.Single(n => n.Type == NodeType.Root);
var children = client.GetNodes(root);
foreach (var node in children)
{
    Console.WriteLine($"{node.Name} - {node.Size} bytes");
}

Upload a file

var nodes = client.GetNodes();
var root = nodes.Single(n => n.Type == NodeType.Root);

INode uploadedNode = client.UploadFile("myfile.txt", root);
Console.WriteLine($"Uploaded: {uploadedNode.Id}");

Upload with progress (async)

var progress = new Progress<double>(p => Console.WriteLine($"{p:P0}"));
var node = await client.UploadFileAsync("myfile.zip", root, progress);

Download a file

client.DownloadFile(node, "downloaded.txt");

// Or as stream
using var stream = client.Download(node);

Download from public link

var uri = new Uri("https://mega.nz/file/XXXXXX#YYYYYY");
client.DownloadFile(uri, "output.zip");

Create a folder

var folder = client.CreateFolder("MyFolder", root);

Get a public sharing link

var link = client.GetDownloadLink(node);
Console.WriteLine(link);

Session persistence

// Save session
var token = client.Login("email@example.com", "password");
var savedSession = JsonConvert.SerializeObject(token);

// Restore session later
var restoredToken = JsonConvert.DeserializeObject<MegaApiClient.LogonSessionToken>(savedSession);
client.Login(restoredToken);

Configuration

var options = new Options
{
    BufferSize = Options.DefaultBufferSize,        // 8192 bytes
    ChunksPackSize = 1 * 1024 * 1024,              // 1 MB chunk packs
    ReportProgressChunkSize = 20 * 1024,           // 20 KB progress reporting
    SynchronizeApiRequests = false,                // Parallel API requests
    ApplicationKey = "your_app_key"                // Optional custom app key
};

var client = new MegaApiClient(options);

Target Frameworks

License

MIT License — see LICENSE for details.

Original library by Gregoire Pailler.