Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/bilibili/flv.js

HTML5 FLV Player
https://github.com/bilibili/flv.js

Last synced: about 1 month ago
JSON representation

HTML5 FLV Player

Lists

README 

        

flv.js  [![npm](https://img.shields.io/npm/v/flv.js.svg?style=flat)](https://www.npmjs.com/package/flv.js)

======

An HTML5 Flash Video (FLV) Player written in pure JavaScript without Flash. LONG LIVE FLV!



This project relies on [Media Source Extensions][] to work.



**For FLV live stream playback, please consider [mpegts.js][] which is under active development.**



**This project will become rarely maintained.**



[mpegts.js]: https://github.com/xqq/mpegts.js

## Overview

flv.js works by transmuxing FLV file stream into ISO BMFF (Fragmented MP4) segments, followed by feeding mp4 segments into an HTML5 `` element through [Media Source Extensions][] API.



[Media Source Extensions]: https://w3c.github.io/media-source/



## Demo

[http://bilibili.github.io/flv.js/demo/](http://bilibili.github.io/flv.js/demo/)



## Features

- FLV container with H.264 + AAC / MP3 codec playback

- Multipart segmented video playback

- HTTP FLV low latency live stream playback

- FLV over WebSocket live stream playback

- Compatible with Chrome, FireFox, Safari 10, IE11 and Edge

- Extremely low overhead, and hardware accelerated by your browser!



## Installation

```bash

npm install --save flv.js

```



## Build

```bash

npm ci                 # install dependencies / dev-dependences

npm run build:debug    # debug version flv.js will be emitted to /dist

npm run build          # minimized release version flv.min.js will be emitted to /dist

```



[cnpm](https://github.com/cnpm/cnpm) mirror is recommended if you are in Mainland China.



## CORS

If you use standalone video server for FLV stream, `Access-Control-Allow-Origin` header must be configured correctly on video server for cross-origin resource fetching.



See [cors.md](docs/cors.md) for more details.



## Getting Started

```html



    if (flvjs.isSupported()) {

        var videoElement = document.getElementById('videoElement');

        var flvPlayer = flvjs.createPlayer({

            type: 'flv',

            url: 'http://example.com/flv/video.flv'

        });

        flvPlayer.attachMediaElement(videoElement);

        flvPlayer.load();

        flvPlayer.play();

    }



```



## Limitations

- MP3 audio codec is currently not working on IE11 / Edge

- HTTP FLV live stream is not currently working on all browsers, see [livestream.md](docs/livestream.md)



## Multipart playback

You only have to provide a playlist for `MediaDataSource`. See [multipart.md](docs/multipart.md)



## Livestream playback

See [livestream.md](docs/livestream.md)



## API and Configuration

See [api.md](docs/api.md)



## Debug

```bash

npm ci         # install dependencies / dev-dependences

npm run dev    # watch file changes and build debug version on the fly

```



## Design

See [design.md](docs/design.md)



## License

```

Copyright (C) 2016 Bilibili. All Rights Reserved.



Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

You may obtain a copy of the License at



    http://www.apache.org/licenses/LICENSE-2.0



Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.

```