emiliodallatorre/flutter_rtmp_broadcaster

Flutter RTMP broadcaster

[!IMPORTANT] Development of version 3.0 is being restarted. Expect breaking changes to the API and Android/iOS build configuration while this work is in progress.

This plugin extends the Flutter camera plugin with RTMP streaming support for Android and iOS. Web is not supported.

It follows the same API structure as the camera plugin and adds a startStreaming(url) method to initiate real-time streaming to an RTMP endpoint.

Underlying implementation:

Android: rtmp-rtsp-stream-client-java
iOS: HaishinKit.swift

Features

Live camera preview embedded in a widget
Snapshot capture to file
Video recording
Direct access to image streams from Dart

Usage

The controller extends the camera plugin's API with the following methods:

Function	Description
`startVideoStreaming(String url, {int bitrate = 1200 * 1024, bool? androidUseOpenGL})`	Starts streaming to an RTMP endpoint
`startVideoRecordingAndStreaming(String filePath, String url, {int bitrate = 1200 * 1024, bool? androidUseOpenGL})`	Starts streaming to an RTMP endpoint while simultaneously recording to a local file
`pauseVideoStreaming()`	Pauses the active stream
`resumeVideoStreaming()`	Resumes a paused stream
`stopEverything()`	Stops any active streaming and recording

Getting started

iOS

Add the following keys to ios/Runner/Info.plist:

<key>NSCameraUsageDescription</key>
<string>App requires access to the camera for live streaming feature.</string>
<key>NSMicrophoneUsageDescription</key>
<string>App requires access to the microphone for live streaming feature.</string>

Android

Set minSdkVersion to 21 or higher in android/app/build.gradle.

Example

The example app demonstrates camera preview, snapshot capture, video recording, and RTMP streaming. Clone the repository and run the app on an Android or iOS device to try it.

A local RTMP test server is available under server/, set up via Docker Compose, for testing without a public endpoint.

Troubleshooting & issues

Report bugs or unexpected behavior via GitHub issues. Availability for support is limited; for prioritized or paid support, contact [info@emiliodallatorre.it](mailto:info@emiliodallatorre.it).

Contributing

Fork the repository and create a branch for your change
Make the change
Ensure the code is formatted and tested
Submit a pull request describing the change

Support development

If this plugin is useful to you, consider supporting its development via Buy Me a Coffee.

emiliodallatorre/flutter_rtmp_broadcaster