Shard.DownloadAssistant 1.0.2

dotnet add package Shard.DownloadAssistant --version 1.0.2
NuGet\Install-Package Shard.DownloadAssistant -Version 1.0.2
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="Shard.DownloadAssistant" Version="1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Shard.DownloadAssistant --version 1.0.2
#r "nuget: Shard.DownloadAssistant, 1.0.2"
#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 Shard.DownloadAssistant as a Cake Addin
#addin nuget:?package=Shard.DownloadAssistant&version=1.0.2

// Install Shard.DownloadAssistant as a Cake Tool
#tool nuget:?package=Shard.DownloadAssistant&version=1.0.2

NuGet Downloads License Maintainability


Introducing the Download Assistant Library for .Net 6.0! 🚀

Looking for a powerful tool to effortlessly manage your download requests? Look no further! 🙌

🔗 Built on top of the Shard.Requests library, our Download Assistant Library is here to handle all your downloads with ease. 💪

With its intuitive classes, this library simplifies the process of downloading your desired files. Perfect for beginners, it offers a seamless user experience and great download capabilities. 💯

Simply create an object and let our assistant take care of the rest! ⚡️

⏳ Worried about failed downloads? Our assistant automatically retries downloads and tries to ensure a successful completion.

✨ Additionally, if the server throttles the connection, our assistant has the capability to download a file in parts, significantly speeding up the download time.

Get started with the Download Assistant Library today and experience the convenience and efficiency it brings to your download workflow. 🌟

Tested with more than 5000 simultaneously HTTP Requests and file sized over 80Gb

  • Easy to use! 🔓
  • Efficient ♾️
  • ✨ Resume able file downloader! ✨

Table of Contents


  • StatusRequest: Calls a HEAD request and returns a response message with the header information.🔎
  • SiteRequest: Is parsing a the HTML body of a website and list all references and files. 🔖
  • GetRequest: To download the response content into a file.
    • This is an HTTP file downloader with these functions:
    • Pause and Start a download ▶
    • Get the filename and extension from the server 📥
    • Timeout function ⌛
    • Monitor the progress of the download with IProgress<float>
    • Can set path and filename
    • Set download speed limit
    • Download a specified range of a file 🔛
  • LoadRequest Extends the GetRequest
    • Download a file into chunks ⛓️
    • Exclude extensions for safety (.exe; .bat; etc...) 🛡️


It is available on Github:

📦 Installation

You can install Shard.DownloadAssistant using NuGet Package Manager in Visual Studio.

Here are the steps:

  1. Open your project in Visual Studio.
  2. Navigate to Tools > NuGet Package Manager > Manage NuGet Packages for Solution....
  3. Search for Shard.DownloadAssistant.
  4. Click on Install.


Import the Library.

using DownloadAssistant.Requests;

Then create a new LoadRequest. This downloads a file into the download's folder of the PC with a ".part" file and uses the name that the server provides.

//To download a file and store it in "Downloads" folder
new LoadRequest("[Your URL]"); // e.g.

To set options on the Request create a RequestOption or for a LoadRequest a LoadRequestOption.

// Create an option for a LoadRequest
  LoadRequestOptions requestOptions = new LoadRequestOptions
    // Sets the filename of the download without the extension
    // The extension will be added automatically!
    FileName = "downloadfile.*",
    // If this download has priority (default is Normal)
    Priority = RequestPriority.High,
    // Specifies the destination path for the downloaded file
    // (default is the download folder)
    DestinationPath = @"C:\Users\[Your Username]\Desktop",
    // If this request contains a heavy workload, put it in a second thread (default is false)
    IsDownload = true,
    // Determines whether the downloader should override an existing file, create a new file, or append to an existing file (default is Append)
    // Resume function is only available with append mode!
    Mode = LoadMode.Create,
    // Chunk a file to download faster (3 chunks in this case)
    Chunks = 3,
    // Merge the chunked files faster while making progress
    MergeWhileProgress = true,
    // Notify when the request completes successfully
    RequestCompleated = (IRequest? req, string? url) => Console.WriteLine($"Finished successfully: {url}")

And use it in the request.

//To download a file and store it on the Desktop with a different name
new LoadRequest("",requestOptions);

To wait on the request, use await or Wait();.

await new LoadRequest("",requestOptions).Task;
//new LoadRequest("",requestOptions).Wait();

🌟 Contributing

If you'd like to contribute to this library, submit a pull request or open an issue. We appreciate your help!

📜 License

DownloadAssistant is licensed under the MIT license.

Free Code and Free to Use

Have fun!
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  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 (1)

Showing the top 1 NuGet packages that depend on Shard.DownloadAssistant:

Package Downloads

WebsiteScraper is a powerful tool that allows you to effortlessly download your favorite comics and manga from various websites. You can easily provide a JSON file containing the website links, and the scraper will do the rest. Using the advanced parsing capabilities of Angelsharp and Regex, the tool efficiently extracts the desired content from the website and saves it onto your device for offline reading. With WebsiteScraper, you can enjoy your favorite comics and manga anytime, anywhere, without any hassle.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.2 80 5/30/2024
1.0.0 98 5/6/2024
0.1.3 236 12/14/2023
0.1.1 162 11/20/2023
0.1.0 147 10/21/2023

Improved documentationt
Implements Shard.Requests 2.1.4
Fix Range and SecondRange End exception
Add MergedChunks re-Run
Add MinReloadSize to GetRequestOptions