rusty_dlna

A Flutter plugin for DLNA/UPnP device discovery and media casting, powered by Rust.

Features

🔍 Device Discovery - Scan for DLNA/UPnP devices on your local network
📺 Media Casting - Cast video URLs to smart TVs and projectors
▶️ Playback Control - Play, pause, stop, and seek
🔊 Volume Control - Get/set volume and mute
📊 Status Monitoring - Get playback position and transport state
🌐 Wake on LAN - Remote wake devices by MAC address

Supported Platforms

Android
iOS
macOS
Linux
Windows

Installation

Add to your pubspec.yaml:

dependencies:
  rusty_dlna: ^0.0.1

Setup

Initialize the library

import 'package:rusty_dlna/api/cast.dart';
import 'package:rusty_dlna/frb_generated.dart';

void main() async {
  await RustLib.init();
  runApp(MyApp());
}

Platform-specific configuration

Android

Add network permissions to android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE"/>

macOS

Add network entitlements to macos/Runner/DebugProfile.entitlements and macos/Runner/Release.entitlements:

<key>com.apple.security.network.client</key>
<true/>
<key>com.apple.security.network.server</key>
<true/>

iOS

Add to ios/Runner/Info.plist:

<key>NSLocalNetworkUsageDescription</key>
<string>This app needs local network access to discover DLNA devices</string>
<key>NSBonjourServices</key>
<array>
    <string>_ssdp._udp</string>
</array>

Usage

Scan for devices

final devices = await scanProjectors(timeoutSecs: BigInt.from(5));

for (final device in devices) {
  print('Found: ${device.friendlyName} at ${device.ip}');
}

Cast a video

final device = devices.first;
await device.castVideo(videoUrl: 'http://example.com/video.mp4');

Playback control

await device.play();
await device.pause();
await device.stop();
await device.seek(targetTime: '00:05:00'); // HH:MM:SS format

Volume control

await device.setVolume(volume: 50);
final currentVolume = await device.getVolume();
await device.setMute(mute: true);

Get playback status

// Get position as formatted strings (HH:MM:SS)
final (current, total) = await device.getPositionInfo();
print('Progress: $current / $total');

// Get position in seconds
final (currentSec, totalSec) = await device.getPositionInfoSec();

// Get transport state
final state = await device.getTransportInfo();
// TransportState: Playing, Paused, Stopped, Transitioning, NoMedia, Unknown

Wake on LAN

await wakeOnLan(macAddress: 'AA:BB:CC:11:22:33');

API Reference

ProjectorInfo

Property	Type	Description
`friendlyName`	`String`	Device display name
`ip`	`String`	Device IP address
`locationXmlUrl`	`String`	UPnP description URL
`avTransportUrl`	`String?`	AVTransport control URL
`renderingControlUrl`	`String?`	RenderingControl URL

ProjectorInfo Methods

Method	Description
`castVideo(videoUrl)`	Cast video and start playback
`play()`	Resume playback
`pause()`	Pause playback
`stop()`	Stop playback
`seek(targetTime)`	Seek to position (HH:MM:SS)
`setVolume(volume)`	Set volume (0-100)
`getVolume()`	Get current volume
`setMute(mute)`	Set mute state
`getPositionInfo()`	Get position as strings
`getPositionInfoSec()`	Get position in seconds
`getTransportInfo()`	Get playback state

Global Functions

Function	Description
`scanProjectors(timeoutSecs)`	Discover DLNA devices
`wakeOnLan(macAddress)`	Send Wake-on-LAN packet

Example

See the example directory for a complete demo app.

License

MIT License - see LICENSE for details.