HTTP Transfers

Getting Started

GitHub
Downloads
Blazor

Operating Systems

Android

iOS

Windows

macOS

Linux

Web

Shiny HTTP Transfers enables background uploads and downloads that continue even when your app is suspended. On iOS, transfers are managed by the OS via NSURLSession background sessions and resume after app restarts. On Android, Windows, Linux, macOS, and plain .NET hosts a managed HttpClient loop drives transfers and supports resumable downloads via HTTP Range requests (on Android the loop runs inside a foreground service). On Blazor WebAssembly, transfers are queued to IndexedDB and drained by a Service Worker via the Background Sync API.

Caution

HTTP Transfers do not work on the iOS Simulator. You must test on a real device.

Features

• Background uploads and downloads
• Multipart and raw upload support
• Progress tracking with speed and ETA
• Automatic resume after app restart
• Resumable downloads on Android, Windows, Linux, macOS, and plain .NET via HTTP Range requests
• Metered/unmetered network control
• Managed transfer list for UI binding
• Cross-platform: iOS, Android, Windows, Linux, macOS, Blazor WebAssembly

Platform Notes

Platform	Package	Backing
iOS	Shiny.Net.Http	NSURLSession background session
Android	Shiny.Net.Http	Foreground service hosting a managed HttpClient + IConnectivity loop; resumable downloads via HTTP Range
Windows	Shiny.Net.Http	Managed HttpClient + IConnectivity loop; resumable downloads via HTTP Range
Linux / macOS / Plain .NET	Shiny.Net.Http	Managed HttpClient + IConnectivity loop; resumable downloads via HTTP Range
Blazor WebAssembly	Shiny.Net.Http.Blazor	Service Worker Background Sync + IndexedDB; downloads not resumable

Blazor WebAssembly limitations

• No resumable downloads — the Service Worker fetch() returns a whole Blob, and partial-body appending isn’t supported.
• Upload bodies are base64-bridged through JS interop and persisted as IndexedDB Blobs. Suitable for small/medium files; very large uploads should wait for a future streaming path.
• Background Sync support is Chromium-only (no Firefox, no Safari). On unsupported browsers the queue still drains while the tab is foreground, then sits in IndexedDB until the user returns.
• Use GetDownloadBytes(identifier) on the Blazor HttpTransferManager to read a completed download’s bytes back from IndexedDB.

Setup

CAUTION

You are using a component that uses an Android foreground service! You must have an application icon set or a drawable resource called notification in order for this background operation to work. For additional information, please read Android Foreground Services

• NuGet Packages
• Project File
• MauiProgram.cs
• AndroidManifest.xml
• Info.plist
• PrivacyInfo.xcprivacy
• Package.appxmanifest

Shiny.Net.Http

Shiny.Hosting.Maui

Background Delegate

Implement IHttpTransferDelegate to handle transfer completion and errors in the background.

public partial class MyTransferDelegate : IHttpTransferDelegate
{
    readonly ILogger<MyTransferDelegate> logger;

    public MyTransferDelegate(ILogger<MyTransferDelegate> logger)
    {
        this.logger = logger;
    }

    public Task OnCompleted(HttpTransferRequest request)
    {
        this.logger.LogInformation("Transfer completed: {Id}", request.Identifier);
        return Task.CompletedTask;
    }

    public Task OnError(HttpTransferRequest request, int statusCode, Exception ex)
    {
        this.logger.LogError(ex, "Transfer failed: {Id}, Status: {Status}", request.Identifier, statusCode);
        return Task.CompletedTask;
    }
}

Android Foreground Service

On Android, background transfers run as a foreground service. Customize the notification:

#if ANDROID
public partial class MyTransferDelegate : IAndroidForegroundServiceDelegate
{
    public void Configure(AndroidX.Core.App.NotificationCompat.Builder builder)
    {
        builder
            .SetContentTitle("My App")
            .SetContentText("Transferring files...")
            .SetSmallIcon(Resource.Mipmap.appicon);
    }
}
#endif

Note

You can also extend HttpTransferDelegate base class which combines IHttpTransferDelegate and IAndroidForegroundServiceDelegate with retry support.

Registration

// iOS / Android / Windows (platform-aware: native sessions where available)
services.AddHttpTransfers<MyTransferDelegate>();

// Linux / macOS / plain .NET (managed HttpClient loop)
services.AddHttpClientTransfers<MyTransferDelegate>();

// Blazor WebAssembly
services.AddBlazorHttpTransfers<MyTransferDelegate>(opts =>
{
    // Optional — defaults to the bundled Shiny service worker
    opts.ServiceWorkerPath = "./_content/Shiny.Net.Http.Blazor/http-transfer-sw.js";
});

On Blazor, ship the bundled SW at the configured path, or import its handlers from your own service worker:

my-sw.js

importScripts('./_content/Shiny.Net.Http.Blazor/http-transfer-sw.js');

AI Coding Assistant

Claude Code GitHub Copilot

Step 1 — Add the marketplace:

claude plugin marketplace add shinyorg/skills

Step 2 — Install the plugin:

claude plugin install shiny-client@shiny

Step 1 — Add the marketplace:

copilot plugin marketplace add https://github.com/shinyorg/skills

Step 2 — Install the plugin:

copilot plugin install shiny-client@shiny

View shiny-client Plugin

Samples

• MAUI Sample