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 #

ProjectorInfo Methods #

Global Functions #

Example #

See the example directory for a complete demo app.

License #

MIT License - see LICENSE for details.