h265web.js - Browser HEVC/H.265 Playback SDK

中文 · English

   

Built and refined continuously since 2017, h265web.js PRO delivers mature browser playback with broad feature coverage and strong performance.

It covers HEVC/H.265, AVC/H.264, AV1, WebRTC, live streaming, VOD, WebCodec, WASM decoding, MediaInfo, snapshot, fullscreen, seek and multi-instance playback.

Recommended media server: ZLMediaKit - a strong streaming server/framework for live and VOD delivery.

If h265web.js helps your project, giving it a GitHub star is a simple way to support the work and help more developers discover it.

Quick Links

• GitHub: https://github.com/numberwolf/h265web.js
• Docs (Website: How to use): https://h265web.com/markdown-docs/get-started.php
• Docs (Local: How to use): README-HowToUse.MD
• Website: https://h265web.com/
• Public Demo: https://h265web.com/player.php

Contact

• GitHub: https://github.com/numberwolf/h265web.js
• Email: porschegt23@foxmail.com
• QQ Group Number: 925466059 (recommended)
• QQ: 531365872
• Discord: numberwolf#8694
• Wechat: numberwolf11

Demo Entry

• Public Demo: https://h265web.com/player.php
• WebRTC WHIP Publish Demo: webrtc-publish.html
• WebRTC WHEP Playback Demo: webrtc-play.html
• Docs (Website: How to use): https://h265web.com/markdown-docs/get-started.php
• Docs (Local: How to use): README-HowToUse.MD

Good Fit For

• Browser playback of HEVC/H.265, AVC/H.264 and AV1
• VOD and live playback in one SDK
• Protocol validation for MP4 / MOV / MKV / FLV / MPEG-TS / M3U8 / HLS / HTTP-FLV / WS-FLV / HTTP-TS / WS-TS / WebRTC / HEVC ES
• Browser-side player projects that need seek, playbackRate, fullscreen, snapshot, MediaInfo, multi-instance playback and multi-thread decode

Integration Cases (Partial)

Feature Matrix

---

Feature Support

Supported

• Protocol box

• Codec

• Features

WebRTC Publish and Playback

WHIP is the standard WebRTC HTTP ingestion protocol, and WHEP is the standard WebRTC HTTP egress protocol. h265web.js is a player, so WHEP is the recommended playback input. The HTTP(S) endpoint carries SDP signaling; negotiated media still uses WebRTC ICE/DTLS/SRTP.

• Browser WHIP publish demo: webrtc-publish.html
• h265web.js WHEP playback demo: webrtc-play.html

For ZLMediaKit RTMP-to-WebRTC conversion, set the timestamp policy before testing:

[protocol]
modify_stamp=1
paced_sender_ms=0

modify_stamp=1 uses the ZLMediaKit receive clock with smoothing. With modify_stamp=2, some H.264 + AAC RTMP inputs can continue decoding at the expected frame rate while Chrome drops late frames during native WebRTC playout.

The following command publishes the tested H.264 + AAC source to ZLMediaKit. ZLMediaKit then exposes it through WHEP:

ffmpeg -hide_banner -stream_loop -1 -re \
  -i /path/to/input.flv \
  -vf scale=640:360,format=yuv420p \
  -c:v libx264 -preset veryfast -tune zerolatency \
  -profile:v baseline -level 3.1 -bf 0 \
  -g 25 -keyint_min 25 -sc_threshold 0 \
  -c:a aac -profile:a aac_low -ar 44100 -ac 2 -b:a 128k \
  -f flv rtmp://127.0.0.1/live/test

Supported playback inputs for that stream:

http://127.0.0.1/index/api/whep?app=live&stream=test
webrtc://127.0.0.1/live/test
http://127.0.0.1/index/api/webrtc?app=live&stream=test&type=play

The first URL is standard WHEP and is recommended. webrtc:// is an SDK compatibility URL converted to WHEP. The third URL is specific to ZLMediaKit.

const player = H265webjsPlayer();

player.on_ready_show_done_callback = function () {
  console.log('WebRTC first frame ready');
};

player.on_play_time = function (seconds) {
  console.log('WebRTC play time', seconds);
};

player.on_error_callback = function (error) {
  console.error('WebRTC playback error', error);
};

player.build({
  player_id: 'canvas111',
  base_url: './static/',
  wasm_js_uri: 'h265web_wasm.js',
  wasm_wasm_uri: 'h265web_wasm.wasm',
  ext_src_js_uri: 'extjs.js',
  ext_wasm_js_uri: 'extwasm.js',
  width: 640,
  height: 360,
  auto_play: false,
  ignore_audio: false,
  core: 'webrtc'
});

player.load_media('http://127.0.0.1/index/api/whep?app=live&stream=test');

Omit core to let the SDK recognize the three WebRTC URL forms automatically. WebRTC uses the existing player lifecycle and callback names; no separate public API is required. Native WebRTC live playback stays at 1x and does not support seek. Standard WebRTC can only receive codecs negotiated by the browser. WebCodecs/WASM fallback for a non-negotiated codec requires the server to implement the optional h265web-rtc-encoded/v1 encoded-media transport.

Documentation

• English Docs Home: https://h265web.com/markdown-docs/get-started.php
• Getting Started: https://h265web.com/markdown-docs/get-started.php
• Simple Demo: https://h265web.com/markdown-docs/simple-demo.php
• API Documentation: https://h265web.com/markdown-docs/api-docs.php
• Donate: https://h265web.com/markdown-docs/donate.php

Partner Projects

• ZLMediaKit - a powerful streaming media service

• FFmpeg with H.265 HTTP-FLV live-stream support

• Web H.265 decoder

• YuvEye - image-quality and YUV analysis tool

About

• Technical community, questions and support group

• Player update history

• Why direct messages are not recommended

• About the founder

---

Donate

FFmpegSupportH265LiveEncode

• Github: https://github.com/numberwolf/FFmpeg-QuQi-H265-FLV-RTMP

TranscodeAndGet265CodecFileByFFmpeg

• mp4

ffmpeg -i input.mp4 \
-vcodec libx265 -pix_fmt \
-acodec aac -ac 2 -ar 44100 \
-preset medium -maxrate 1000k -bufsize 1000k \
-vtag hvc1 \
-movflags faststart \
-y video.mp4

• hls/m3u8 capture

ffmpeg -f avfoundation -i 1:0 \
-q 4 -r 10 \
-filter_complex "scale=1280:720" \
-pix_fmt yuv420p \
-vcodec libx265 \
-ar 22050 -ab 64k -ac 1 -acodec aac \
-threads 4 \
-preset veryfast \
-f segment \
-segment_list test.m3u8 \
-segment_time 5 \
-y /Users/numberwolf/Documents/webroot/VideoMissile/VideoMissilePlayer/res/hls1/v-%03d.ts

• mpeg-ts

ffmpeg -ss 20 -t 10 -i ./res/xinxiaomen.mp4 \
-vcodec libx265 -x265-params "bframes=0:keyint=10" -r 24 -filter_complex "scale=720:1280" -preset fast -maxrate 800k -bufsize 800k \
-acodec aac -ar 22050 -ac 1 \
-pix_fmt yuv420p \
-f mpegts -y ./res/veilside2.ts

UpdateLog

---