Downloader 2.1.1

Downloader

🚀 Fast and reliable multipart downloader with .Net Core 3.1+ supporting 🚀

Downloader is a modern, fluent, asynchronous, testable and portable library for .NET. This is a multipart downloader with asynchronous progress events. This library written in .Net Standard 2 and you can add that in your .Net Core or .Net Framework projects.

Sample Console Application

How to use

Get it on NuGet:

PM> Install-Package Downloader

Or via the .NET Core command line interface:

dotnet add package Downloader

Create your custom configuration:

var downloadOpt = new DownloadConfiguration()
{
    BufferBlockSize = 10240, // usually, hosts support max to 8000 bytes, default values is 8000
    ChunkCount = 8, // file parts to download, default value is 1
    MaximumBytesPerSecond = 1024 * 1024, // download speed limited to 1MB/s, default values is zero or unlimited
    MaxTryAgainOnFailover = int.MaxValue, // the maximum number of times to fail
    OnTheFlyDownload = false, // caching in-memory or not? default values is true
    ParallelDownload = true, // download parts of file as parallel or not. Default value is false
    TempDirectory = "C:\\temp", // Set the temp path for buffering chunk files, the default path is Path.GetTempPath()
    Timeout = 1000, // timeout (millisecond) per stream block reader, default values is 1000
    RequestConfiguration = // config and customize request headers
    {
        Accept = "*/*",
        AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate,
        CookieContainer =  new CookieContainer(), // Add your cookies
        Headers = new WebHeaderCollection(), // Add your custom headers
        KeepAlive = false,
        ProtocolVersion = HttpVersion.Version11, // Default value is HTTP 1.1
        UseDefaultCredentials = false,
        UserAgent = $"DownloaderSample/{Assembly.GetExecutingAssembly().GetName().Version.ToString(3)}"
    }
};

So, declare download service instance per download and pass config:

var downloader = new DownloadService(downloadOpt);

Then handle download progress and completed events:

downloader.DownloadProgressChanged += OnDownloadProgressChanged;
downloader.ChunkDownloadProgressChanged += OnChunkDownloadProgressChanged;
downloader.DownloadFileCompleted += OnDownloadFileCompleted;    

The ‍DownloadService class has a property called Package that stores each step of the download. You must call the CancelAsync method to stop or pause the download, and if you continue again, you must call the same DownloadFileAsync function with the Package parameter to continue your download! For example:

Start the download asynchronously and keep package file:

string file = @"Your_Path\fileName.zip";
string url = @"https://file-examples.com/fileName.zip";
// To resume from last download, keep downloader.Package object
DownloadPackage pack = downloader.Package; 
await downloader.DownloadFileAsync(url, file);

Download on MemoryStream

Stream destinationStream = await downloader.DownloadFileAsync(url);

Stop or Pause Download:

downloader.CancelAsync(); 

Resume Download:

await downloader.DownloadFileAsync(pack); 

So that you can even save your large downloads with a very small amount in the Package and after restarting the program, restore it again and start continuing your download. In fact, the packages are your instant download snapshots. If your download config has OnTheFlyDownload, the downloaded bytes ​​will be stored in the package itself, but otherwise, only the address of the downloaded files will be included and you can resume it whenever you like. For more detail see StopResumeOnTheFlyDownloadTest method

Note: for complete sample see Downloader.Sample project from this repository.

Features at a glance

• Download files async and non-blocking.
• Cross-platform library to download any files with any size.
• Get real-time progress info of each block.
• Download file multipart as parallel.
• Handle any client-side or server-side exception none-stopping the downloads.
• Config your ChunkCount to define the parts count of the download file.
• Download file multipart as in-memory or in-temp files cache mode.
• Store download package object to resume the download when you want.
• Get download speed or progress percentage in each progress event.
• Get download progress events per chunk downloads.
• Stop and Resume your downloads with package object.
• Set a speed limit on downloads.
• Live streaming support, suitable for playing music at the same time as downloading.
• Download files without storing on disk and get a memory stream for each downloaded file.