Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time

Version 2.x coming soon...

Below is Version 1.x

A lightweight and sophisticated React-based H5 video player

GitHub Travis (.org) npm package npm bundle size (version) GitHub stars

简体中文 | English


Qier-player is a web video player component for React, It has a simple interface and smooth operation which supports the most functions of other video players. In addition, Qier-player can switch between video resolutions (4K, 2K, 1080P, 720P and 480P) if desired.

Keyboard Shortcuts

For these to work, the player must be in focus.

  • Up arrow key: Volume up
  • Down arrow key: Volume down
  • Left arrow key: Rewind 3 seconds
  • Right arrow key: Skip forward 3 seconds
  • Space key: Toggle play/pause

Here is an official demo site showing the player in use.


Screenshot of Qier Player

Quick Start


npm install --save qier-player


import React from 'react';
import ReactDOM from 'react-dom';
import QierPlayer from 'qier-player';

ReactDOM.render(<QierPlayer srcOrigin='Your video addedress' />, document.getElementById('root'));


Parameter Description Types Defaults
width setting the video width (e.g. 740 or "100%") number | string 740
height setting the video height (e.g. 420 or "100%") number | string 420
language language: 'en' is English and 'zh' is Chinese "en" | "zh" 'en'
themeColor theme color (only supports hexadecimal color) string '#f23300'
src480p 480p source URL boolean | string false
src1080p 1080p source URL boolean | string false
src720p 720p source URL boolean | string false
src2k 2K source URL boolean | string false
src4k 4K source URL boolean | string false
srcOrigin origin source URL (set this if not using specific resolution sources) boolean | string false


  • Thanks to kaiseixd for his inspiration when I was in trouble.
  • Thanks to the screenfull plugin and the its author.
  • Thanks to fanzy for tranlsating README
  • Thanks to iconfont as an unselfish icon creator.