PHPackages                             chao2hang/flarum-xgplayer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. chao2hang/flarum-xgplayer

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

chao2hang/flarum-xgplayer
=========================

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

00

Since Jun 21Compare

[ Source](https://github.com/chao2hang/flarum-xgplayer)[ Packagist](https://packagist.org/packages/chao2hang/flarum-xgplayer)[ RSS](/packages/chao2hang-flarum-xgplayer/feed)WikiDiscussions Synced 2w ago

READMEChangelogDependenciesVersions (1)Used By (0)

XgPlayer Integration for Flarum
===============================

[](#xgplayer-integration-for-flarum)

[![License](https://camo.githubusercontent.com/70b1fde38198140c098a6eb8f7a5ad58610f49d9c9b4ccb843cdce8c5baaac51/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6368616f3268616e672f666c6172756d2d7867706c617965723f7374796c653d666c61742d737175617265)](https://github.com/chao2hang/flarum-xgplayer/blob/main/LICENSE)

A [Flarum](https://flarum.org/) extension that integrates [XgPlayer](https://xgplayer.bytedance.com/) (ByteDance video player) into forum posts.

Features
--------

[](#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
------------

[](#installation)

```
composer require chaos/xigua-video
```

Then enable the extension in Flarum admin panel.

Usage
-----

[](#usage)

### BBCode

[](#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

[](#editor-button)

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

### Supported Formats

[](#supported-formats)

FormatTypeDescriptionMP4`mp4`Standard video format (default)HLS`hls`HTTP Live Streaming (.m3u8)FLV`flv`Flash VideoDASH`dash`Dynamic Adaptive StreamingRequirements
------------

[](#requirements)

- Flarum `^2.0`
- PHP 8.x

Configuration
-------------

[](#configuration)

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

Links
-----

[](#links)

- [GitHub](https://github.com/chao2hang/flarum-xgplayer)
- [Packagist](https://packagist.org/packages/chaos/xigua-video)
- [XgPlayer Documentation](https://xgplayer.bytedance.com/)

License
-------

[](#license)

MIT

###  Health Score

9

—

LowBetter than 0% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/c67e2c684c4576cbf4e68917c8f5b0c56cbea1604d90a50a73b1aac286a29f74?d=identicon)[chao2hang](/maintainers/chao2hang)

### Embed Badge

![Health badge](/badges/chao2hang-flarum-xgplayer/health.svg)

```
[![Health](https://phpackages.com/badges/chao2hang-flarum-xgplayer/health.svg)](https://phpackages.com/packages/chao2hang-flarum-xgplayer)
```

###  Alternatives

[jansenfelipe/omr

Optical Mark Recognition from PHP

1893.3k1](/packages/jansenfelipe-omr)[quellenform/t3x-iconpack

Provides an iconpack-registry for custom iconpacks.

1556.7k26](/packages/quellenform-t3x-iconpack)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)