chao2hang/flarum-xgplayer

Integrate XgPlayer (ByteDance video player) into Flarum posts with support for MP4, HLS, FLV and DASH formats.

Maintainers

Package info

github.com/chao2hang/flarum-xgplayer

Language:JavaScript

Type:flarum-extension

pkg:composer/chao2hang/flarum-xgplayer

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

dev-main 2026-06-21 15:14 UTC

Requires

MIT 89905551f1c38c0163e3ea99c322e5f400e1ceac

extensionvideoplayerflvdashhlsflarumbytedancexgplayer

This package is auto-updated.

Last update: 2026-06-21 15:15:19 UTC

README

License

A Flarum extension that integrates XgPlayer (ByteDance video player) into forum posts.

Features

  • Embed videos using BBCode: [xgplayer url=URL poster=URL type=TYPE]
  • Supports multiple video formats: MP4, HLS (.m3u8), FLV, DASH
  • Editor toolbar button with video insertion modal
  • Picture-in-Picture (PiP) support
  • Fullscreen with auto-rotate on mobile
  • Mobile-optimized progress bar and controls
  • Lazy CDN loading (scripts loaded only when needed)

Installation

composer require chaos/xigua-video

Then enable the extension in Flarum admin panel.

Usage

BBCode

[xgplayer url=https://example.com/video.mp4]
[xgplayer url=https://example.com/video.m3u8 type=hls]
[xgplayer url=https://example.com/video.mp4 poster=https://example.com/thumb.jpg]

Editor Button

Click the Video button in the post editor toolbar to open the video insertion modal.

Supported Formats

Format Type Description
MP4 mp4 Standard video format (default)
HLS hls HTTP Live Streaming (.m3u8)
FLV flv Flash Video
DASH dash Dynamic Adaptive Streaming

Requirements

  • Flarum ^2.0
  • PHP 8.x

Configuration

No configuration needed. The extension uses XgPlayer CDN by default.

Links

License

MIT