SPLive

SPLive Logo

Official Flutter SDK for Specular.Live

Voice • Video • Chat • Groups • Live Streaming • WebRTC • End-to-End Encryption

Overview

SPLive is the official Flutter SDK for building modern real-time communication applications powered by Specular.Live.

It provides everything required to build applications similar to:

  • Discord
  • Telegram Voice Chat
  • Google Meet
  • Clubhouse
  • Slack Huddles

without having to manage signaling, media pipelines, or networking yourself.

Features

Authentication

  • Login
  • Register
  • Refresh Token
  • Logout
  • Current User

Groups

  • Create Groups
  • Join Groups
  • Leave Groups
  • Group Management

Voice Rooms

  • Join Voice Rooms
  • Leave Voice Rooms
  • Mute / Unmute
  • Speaking Indicator
  • Raise Hand
  • Stage Mode
  • Audience Mode

Video Rooms

  • Camera
  • Screen Sharing
  • Camera Switching
  • Active Speaker Detection
  • Recording
  • Google Meet Style UI

Chat

  • Text Messages
  • Images
  • Voice Messages
  • File Attachments
  • Emoji Reactions
  • Typing Indicator

Event System

Specular.events.onUserJoined

Specular.events.onUserLeft

Specular.events.onMessage

Specular.events.onReaction

Specular.events.onTyping

Specular.events.onRecordingStarted

Specular.events.onRoomClosed

Offline Support

  • Offline Queue
  • Automatic Retry
  • File Cache
  • Image Cache
  • Audio Cache
  • Video Cache

Reconnect

Automatic reconnection similar to Discord.

Security

  • AES-256-GCM
  • X25519
  • End-to-End Encryption
  • Secure Key Storage
  • Media Encryption
  • Key Rotation

Flutter Widgets

Ready-to-use UI widgets:

  • VoiceRoomWidget
  • VideoRoomWidget
  • StageWidget
  • AudienceGrid
  • ParticipantTile
  • ChatDrawer
  • ReactionOverlay
  • MicGlow
  • RaiseHandWidget

Installation

Add SPLive to your project.

dependencies:
  splive: ^1.0.0

Install packages.

flutter pub get

Initialize

import 'package:flutter/widgets.dart';
import 'package:splive/splive.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Specular.initialize();

  runApp(const MyApp());
}

No API URL or WebSocket configuration is required.

All applications connect securely to the official Specular.Live infrastructure.

Login

final user = await Specular.login(
  username: "john",
  password: "123456",
);

Join Voice Room

await Specular.joinVoiceRoom(
  groupId: "community",
);

Join Video Room

await Specular.joinVideoRoom(
  groupId: "meeting-room",
);

Send Message

await Specular.chat.sendText(
  "Hello everyone!",
);

Listen For Events

Specular.events.onMessage.listen((event) {
  print(event.message);
});

Encryption

Enable End-to-End Encryption.

await Specular.enableEncryption();

Documentation

Complete documentation is available at

https://specular.live/docs

Example

A complete Flutter application is included inside

example/

It demonstrates:

  • Authentication
  • Groups
  • Voice Rooms
  • Video Rooms
  • Chat
  • Recording
  • Notifications
  • Admin Features
  • Offline Queue
  • Encryption

Platform Support

Platform Supported
Android ✅
iOS ✅
macOS ✅
Windows ✅
Linux ✅
Web 🚧

Requirements

Flutter 3.24+

Dart 3.5+

License

MIT License

Copyright © 2026 Specular.Live

Links

Website

https://specular.live

Documentation

https://specular.live/docs

GitHub

https://github.com/specular-live/splive

Issues

https://github.com/specular-live/splive/issues

Libraries

splive