Halo Video Player

A unified video player plugin for Flutter that works across all platforms (Android, iOS, macOS, Windows, Linux, Web) with support for all standard video formats including .mp4, .mov, .avi, and more.

Features

• ✅ Cross-platform support: Works on Android, iOS, macOS, Windows, Linux, and Web
• ✅ Format support: Plays all standard video formats (.mp4, .mov, .avi, etc.)
• ✅ Platform-optimized: Uses the best video player for each platform
  • Android/iOS/macOS/Web: Uses video_player package
  • Windows: Uses Windows Media Foundation (native implementation)
  • Linux: Uses GStreamer (native implementation)
• ✅ Full control: Play, pause, seek, volume, playback speed, looping
• ✅ Easy to use: Simple API similar to video_player package

Installation

Add this to your pubspec.yaml:

dependencies:
  halo_videoplayer: ^0.0.1

Then run:

flutter pub get

Platform Setup

Android

No additional setup required. The plugin uses video_player which handles Android automatically.

iOS

No additional setup required. The plugin uses video_player which handles iOS automatically.

macOS

No additional setup required. The plugin uses video_player which handles macOS automatically.

Windows

The plugin uses Windows Media Foundation (WMF) which is built into Windows. No additional dependencies required.

Linux

The plugin requires GStreamer and its development packages. Install them:

Ubuntu/Debian:

sudo apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \
  gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
  gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly \
  gstreamer1.0-libav

Fedora:

sudo dnf install gstreamer1-devel gstreamer1-plugins-base-devel \
  gstreamer1-plugins-good gstreamer1-plugins-bad-free \
  gstreamer1-plugins-ugly-free gstreamer1-libav

Arch Linux:

sudo pacman -S gstreamer gstreamer-vaapi gst-plugins-base \
  gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav

Web

No additional setup required. The plugin uses video_player which handles Web automatically.

Usage

Basic Example

import 'package:flutter/material.dart';
import 'package:halo_videoplayer/halo_videoplayer.dart';

class VideoPlayerExample extends StatefulWidget {
  @override
  _VideoPlayerExampleState createState() => _VideoPlayerExampleState();
}

class _VideoPlayerExampleState extends State<VideoPlayerExample> {
  late HaloVideoPlayerController _controller;

  @override
  void initState() {
    super.initState();
    _controller = HaloVideoPlayerController(
      dataSource: HaloVideoPlayerDataSource.network(
        'https://example.com/video.mp4',
      ),
      autoPlay: false,
      looping: false,
    );
    _controller.initialize().then((_) {
      setState(() {});
    });
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: AspectRatio(
          aspectRatio: _controller.value.aspectRatio,
          child: HaloVideoPlayer(controller: _controller),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          if (_controller.value.isPlaying) {
            _controller.pause();
          } else {
            _controller.play();
          }
          setState(() {});
        },
        child: Icon(
          _controller.value.isPlaying ? Icons.pause : Icons.play_arrow,
        ),
      ),
    );
  }
}

Data Sources

Network Video

_controller = HaloVideoPlayerController(
  dataSource: HaloVideoPlayerDataSource.network(
    'https://example.com/video.mp4',
    httpHeaders: {'Authorization': 'Bearer token'},
  ),
);

File Video

_controller = HaloVideoPlayerController(
  dataSource: HaloVideoPlayerDataSource.file('/path/to/video.mp4'),
);

Asset Video

_controller = HaloVideoPlayerController(
  dataSource: HaloVideoPlayerDataSource.asset('videos/sample.mp4'),
);

Controls

// Play
await _controller.play();

// Pause
await _controller.pause();

// Seek to position
await _controller.seekTo(Duration(seconds: 30));

// Set volume (0.0 to 1.0)
await _controller.setVolume(0.5);

// Set playback speed
await _controller.setPlaybackSpeed(1.5); // 1.5x speed

// Set looping
await _controller.setLooping(true);

Listening to Player State

_controller.addListener(() {
  final value = _controller.value;
  print('Playing: ${value.isPlaying}');
  print('Position: ${value.position}');
  print('Duration: ${value.duration}');
  print('Buffering: ${value.isBuffering}');
});

Supported Formats

Android

• .mp4, .mov, .avi, .mkv, .webm, and more (via ExoPlayer)

iOS/macOS

• .mp4, .mov, .m4v, and more (via AVPlayer)
• Note: .avi format may have limited support on iOS/macOS

Windows

• .mp4, .mov, .avi, .mkv, .wmv, and more (via Windows Media Foundation)

Linux

• .mp4, .mov, .avi, .mkv, .webm, and more (via GStreamer)
• Requires GStreamer plugins to be installed

Web

• Depends on browser support (typically .mp4, .webm)

Troubleshooting

Linux: Video not playing

Make sure GStreamer and all required plugins are installed:

# Check if GStreamer is installed
gst-inspect-1.0 --version

# Check available plugins
gst-inspect-1.0 | grep -i "decode"

Windows: Video not playing

Ensure Windows Media Foundation is available (it's built into Windows 7+). If videos still don't play, check that the video format is supported by Windows Media Foundation.

Format not supported

If a specific format doesn't play on a platform:

• Linux: Install additional GStreamer plugins (bad, ugly, libav)
• Windows: The format may not be supported by Windows Media Foundation
• iOS/macOS: Check AVPlayer supported formats for your iOS/macOS version

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License.