Meziantou.Framework.Bencode 2.0.6

Prefix Reserved
dotnet add package Meziantou.Framework.Bencode --version 2.0.6
                    
NuGet\Install-Package Meziantou.Framework.Bencode -Version 2.0.6
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Meziantou.Framework.Bencode" Version="2.0.6" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Meziantou.Framework.Bencode" Version="2.0.6" />
                    
Directory.Packages.props
<PackageReference Include="Meziantou.Framework.Bencode" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Meziantou.Framework.Bencode --version 2.0.6
                    
#r "nuget: Meziantou.Framework.Bencode, 2.0.6"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Meziantou.Framework.Bencode@2.0.6
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Meziantou.Framework.Bencode&version=2.0.6
                    
Install as a Cake Addin
#tool nuget:?package=Meziantou.Framework.Bencode&version=2.0.6
                    
Install as a Cake Tool

Meziantou.Framework.Bencode

Meziantou.Framework.Bencode provides:

  • A low-level bencode DOM (BencodeDocument, BencodeValue, BencodeDictionary, BencodeList, ...)
  • A high-level torrent metainfo model (TorrentFile, TorrentInfo, TorrentInfoFile)

Parse and write bencode data

The types are in the Meziantou.Framework.Bencode namespace, and PipeReader in System.IO.Pipelines.

var data = "d3:cow3:moo4:spam4:eggse"u8.ToArray();
var document = BencodeDocument.Parse(data);

// Parse from a stream, such as File.OpenRead("input.bencode")
await using var input = new MemoryStream(data);
var pipeReader = PipeReader.Create(input);
var streamedDocument = await BencodeDocument.ParseAsync(pipeReader);
await pipeReader.CompleteAsync();
Assert.IsType<BencodeDictionary>(streamedDocument.Root);

var dictionary = (BencodeDictionary)document.Root;
var cow = (BencodeString)dictionary[new BencodeString("cow"u8.ToArray())];
Assert.Equal("moo", cow.ToUtf8String());

var encoded = dictionary.ToUtf8ByteArray();
Assert.Equal("d3:cow3:moo4:spam4:eggse"u8.ToArray(), encoded);

// Write to a stream, such as File.Create("output.bencode")
await using var stream = new MemoryStream();
await dictionary.WriteToAsync(stream);

You can also write bencode directly (ArrayBufferWriter<T> is in the System.Buffers namespace):

var buffer = new ArrayBufferWriter<byte>();
var writer = new BencodeWriter(buffer);

writer.WriteStartDictionary();
writer.WriteUtf8Key("cow");
writer.WriteUtf8String("moo");
writer.WriteEndDictionary();
writer.Complete();

var data = buffer.WrittenSpan.ToArray();
Assert.Equal("d3:cow3:mooe"u8.ToArray(), data);

Parse and write torrent files

The torrent types are in the Meziantou.Framework.Bencode.Torrent namespace.

var content = "d8:announce14:https://t.test4:infod6:lengthi123e4:name8:file.txt12:piece lengthi16384e6:pieces20:01234567890123456789ee"u8.ToArray();

// Parse from a stream, such as File.OpenRead("file.torrent")
await using var input = new MemoryStream(content);
var torrent = await TorrentFile.ParseAsync(input);

Assert.Equal("https://t.test", torrent.Announce);
Assert.Equal("file.txt", torrent.Info.Name);
Assert.Equal("5A47092756A964C26715F69510A7B35B63B3B01C", Convert.ToHexString(torrent.GetInfoHashSha1()));

// Write to a stream, such as File.Create("copy.torrent")
await using var output = new MemoryStream();
await torrent.WriteToAsync(output, canonical: true);
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed.  net11.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net10.0

    • No dependencies.
  • net11.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.6 89 11/13/2026
2.0.5 102 11/8/2026
2.0.4 194 10/21/2026
2.0.3 199 9/6/2026
2.0.2 133 8/29/2026
2.0.1 220 7/8/2026
2.0.0 145 7/5/2026
1.0.5 160 6/28/2026
1.0.4 151 6/13/2026
1.0.3 160 5/24/2026
1.0.2 132 5/24/2026
1.0.1 130 5/24/2026
1.0.0 144 5/24/2026