csdl 1.1.0

Suggested Alternatives

csdl 1.1.5

There is a newer version of this package available.
See the version list below for details.
dotnet add package csdl --version 1.1.0                
NuGet\Install-Package csdl -Version 1.1.0                
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="csdl" Version="1.1.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add csdl --version 1.1.0                
#r "nuget: csdl, 1.1.0"                
#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.
// Install csdl as a Cake Addin
#addin nuget:?package=csdl&version=1.1.0

// Install csdl as a Cake Tool
#tool nuget:?package=csdl&version=1.1.0                

csdl

Providing libtorrent through a C++ library for use in .NET

Usage

Latest Nuget

Add csdl to the project via NuGet and create a single TorrentClient instance. This will usually be static (or singleton if using a dependency container), and a TorrentClientConfig can be passed in the constructor to configure the client.

// create a new TorrentClient instance, optionally passing in the configuration
var options = new TorrentClientConfig
{
    ForceEncryption = true,
    MaxConnections = 500
};

using var client = new TorrentClient(options);

// bonus: there is also an event handler that can be subscribed to if more information is wanted.
client.AlertRaised += (sender, args) =>
{
    // args can be checked against all classes in the csdl.Alerts namespace for more properties.
    Console.WriteLine(args.Message);
};

.torrent files can be parsed either by passing in a file path or a byte array containing the file contents to the TorrentInfo class, and the instance will be populated accordingly. Some metadata can be accessed from the TorrentInfo instance, such as the name of the torrent and a list of files contained within it.

var filePath = "path/to/torrent/file.torrent";
var torrentInfo = new TorrentInfo(filePath);

// get the name and list of files
Console.WriteLine($"Name: {torrentInfo.Name}");
Console.WriteLine("Files:");

foreach (var file in torrentInfo.Files)
{
    Console.WriteLine($"- {file.Path} ({file.Size} bytes)");
}

After parsing a torrent file, it can be "attached" to the client to start downloading the files. Note this method will not start a download, but will prepare the client to download the files when Start is called. This method also has an overload allowing a custom save path to be specified. If not, the default save path will be used (client.DefaultDownloadPath).

// this will be saved to DefaultDownloadPath.
var torrentManager = client.AttachTorrent(torrentInfo);

// the metadata can still be accessed but files have additional properties including their final destination and their download priority, which can be changed.
torrentManager.Files[0].Priority = TorrentFilePriority.DoNotDownload;

// after setting priorities, the download can begin (or resume if the torrent was previously started)
torrentManager.Start();

// if we want a progress update, we can request one
var progress = torrentManager.GetCurrentStatus();

if (progress.State == TorrentState.Finished)
{
    torrentManager.Stop();

    // when we want to "dispose" the manager, we can detach it from the client
    client.DetachTorrent(torrentManager);
}

If we want to wait for the download to complete, a timer and a TaskCompletionSource can be used to await the completion of the download.

void PerformDownload(TorrentClient client, TorrentInfo info, string savePath = null)
{
    var torrentTransfer = new TaskCompletionSource();
    var torrentManager = client.AttachTorrent(info, savePath);
    
    torrentManager.Start();
    
    using (new Timer(PerformProgressCheck, null, TimeSpan.Zero, TimeSpan.FromSeconds(1)))
    {
        await torrentTransfer.Task;
    }

    // at this point, the torrentManager has either finished downloading or seeding, and the poll has been stopped.

    client.DetachTorrent(torrentManager);
    return;

    // this function polls the progress (makes a call to libtorrent) every second to check if the torrent has finished downloading
    void PerformProgressCheck(object state)
    {
        if (torrentManager.GetCurrentStatus().State is TorrentState.Seeding or TorrentState.Finished)
        {
            torrentTransfer.SetResult();
        }
    }
}

Supported Systems

The native libraries, csdl.Native, are currently built for Windows, macOS and Linux for both x64 and arm64 architectures.

Additionally, libtorrent is not required to be installed, a copy is also redistributed for convenience.

[!IMPORTANT] musl Linux variants of the native libraries are not built but should work if built manually.

Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
1.2.1 107 9/21/2024
1.2.0.1-beta 95 9/11/2024
1.2.0-beta 82 9/10/2024
1.1.6 144 8/9/2024
1.1.5 158 5/1/2024
1.1.0 140 4/30/2024 1.1.0 is deprecated because it has critical bugs.
1.0.2 167 3/25/2024
1.0.1 114 3/25/2024
1.0.0 102 3/25/2024