BluetoothLE Hosting

Getting Started

GitHub
Downloads
Linux

Frameworks

.NET

.NET MAUI

Operating Systems

Android

iOS

macOS

Windows

Linux

BluetoothLE Hosting allows your device to act as a BLE peripheral (server). You can advertise services, create GATT services with characteristics, and communicate with central devices that connect to you.

Features

• Advertise as a BLE peripheral
• Create GATT services with read/write/notify characteristics via the imperative AddService builder
• iBeacon broadcasting
• L2CAP CoC channel listeners for high-throughput streaming, including a directory-backed file server centrals can upload to and download from
• Cross-platform: iOS, macOS, Android, Linux (Windows hosting is currently stubbed)

Platform Notes

Feature	iOS	macOS	Android	Windows	Linux
Advertising	Foreground + limited background	Full	Full	—	WIP
GATT Server	Full	Full	Full	—	WIP
L2CAP CoC	Full	Full	API 29+	—	Full (BlueZ socket)

iOS

On iOS, advertising is limited when the app is in the background. The local name is not included and only service UUIDs are advertised.

Blazor WebAssembly

BLE peripheral / GATT server hosting is not possible in the browser. The Web Bluetooth API only exposes the central role — there is no spec or browser implementation for advertising as a peripheral. This isn’t a Shiny limitation; it cannot be worked around with JS interop.

Setup

Changed files

• MyApp/
  • ▸Delegates
    • MyBleGattCharacteristic.cs
  • ▸Platforms
    • ▸Android
      • AndroidManifest.xml
    • ▸iOS
      • Info.plist
  • MauiProgram.cs
  • MyApp.csproj

Delegates/MyBleGattCharacteristic.cs

MyBleGattCharacteristic.csCopy

1using Shiny.BluetoothLE.Hosting.Managed;2​3namespace MyApp.Delegates;4​5[BleGattCharacteristic("SERVICE UUID", "CHARCATERISTIC UUID")]6public class MyBleGattCharacteristic : BleGattCharacteristic7{8    public MyBleGattCharacteristic()9    {10    }11​12    // public override Task OnStart() => base.OnStart();13    // public override void OnStop() => base.OnStop();14​15    // public override Task<GattResult> OnRead(ReadRequest request) => base.OnRead(request);16    // public override Task OnWrite(WriteRequest request) => base.OnWrite(request);17    // public override Task OnSubscriptionChanged(IPeripheral peripheral, bool subscribed) => base.OnSubscriptionChanged(peripheral, subscribed);18}

Requesting Access

IBleHostingManager hostingManager; // injected

var access = await hostingManager.RequestAccess(advertise: true, connect: true);

Advertising

// Start advertising with a local name and service UUIDs
await hostingManager.StartAdvertising(new AdvertisementOptions(
    LocalName: "MyDevice",
    ServiceUuids: new[] { "Your-Service-UUID" }
));

// Check advertising state
var isAdvertising = hostingManager.IsAdvertising;

// Stop advertising
hostingManager.StopAdvertising();

AI Coding Assistant

Claude CodeGitHub Copilot

Step 1 — Add the marketplace:

claude plugin marketplace add shinyorg/skills

Step 2 — Install the plugin:

claude plugin install shiny@shiny

One plugin installs all 35 Shiny skills. Your agent loads only the skill relevant to what you're building, so there's no cost to having them all available.

Step 1 — Add the marketplace:

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

Step 2 — Install the plugin:

copilot plugin install shiny@shiny

One plugin installs all 35 Shiny skills. Your agent loads only the skill relevant to what you're building, so there's no cost to having them all available.

View shiny-ble-hosting Skill

Samples

• MAUI Sample