DEV Community

Cover image for Introducing ReactTVPlayer: An Open Source Media Player for TV Apps on Devices ๐Ÿ“บ ๐Ÿ–ฅ๏ธ
Lewis Hunt
Lewis Hunt

Posted on • Updated on

Introducing ReactTVPlayer: An Open Source Media Player for TV Apps on Devices ๐Ÿ“บ ๐Ÿ–ฅ๏ธ

I'm excited to share React TV Player - a free to use open source React media player component designed for TV, aiming to lower the barrier to entry and simplify playback in big-screen web apps! ๐Ÿ™Œ

With a customizable UI and easy arrow-key navigation, it can play a variety of urls like Dash/HLS streams and it even supports YouTube, Twitch & Vimeo videos - saving the cost and hassle of additional media encoding ๐ŸŽ‰


Live demo (for desktop browsers)

Github repo (full readme info and source code)


Installation

It has been built as an npm package for easy install:



npm install react-tv-player


Enter fullscreen mode Exit fullscreen mode

Usage

Then just import the player and render it in your App/Page



import React from "react";
import { TVPlayer } from "react-tv-player";
function App() {
  return (
    <>
      <TVPlayer url="https://www.youtube.com/watch?v=SkVqJ1SGeL0" />
    </>
  );
}


Enter fullscreen mode Exit fullscreen mode

The demo's source code App.tsx illustrates how the component can be initialised with more props such as metadata, custom buttons, preview images and multiple media...



<TVPlayer
  title={mediaList[mediaIndex].title}
  subTitle={mediaList[mediaIndex].subTitle}
  url={mediaList[mediaIndex].url}
  light={mediaList[mediaIndex].preview}
  customButtons={customButtons}
  mediaCount={mediaList.length}
  onLikePress={handleLike}
/>


Enter fullscreen mode Exit fullscreen mode

The Github readme details the props available plus the more advanced methods and hooks available to you.


Why Another Player?

In the dynamic landscape of the OTT TV industry, I've dedicated years working with various players. During this journey, two persistent challenges surfaced time and again: performant UI and compatible media encodings. These hurdles often forced us to heavily customise players and tackle streaming difficulties, leading to added costs and frustrating delays. ๐Ÿ˜ซ

Enter ReactTVPlayer, an open-source component that seamlessly integrates with your React applications...

What Sets It Apart?

It's designed for TV experiences out of the box, complete with customisable UI buttons and intuitive arrow key plus cursor navigation. ๐ŸŽฎ In addition to handling HLS and Dash streams effortlessly, it tackles the formidable challenge of playing YouTube and Vimeo urls directly on TV. Supporting YouTube/Vimeo eliminates the need for custom media encoding when it's not always necessary or even affordable. ๐ŸŽ‰

How Does It Work?

Under the hood, this component harnesses the power of open-source libraries like Norigin Media's spatial navigation hook. It builds upon the excellence of React Player, which utilises hls.js and dash.js. Powered by React TypeScript (although you don't need to use TypeScript to make the most of it), this library is packaged efficiently using Vite, making integration a breeze. ๐Ÿ’ช

From Amazon FireTV sticks and Samsung Tizen Smart TVs to Xbox, LG webOS and even desktop-based web apps, ReactTVPlayer aims to cover a vast landscape of devices, especially those post-2018 with modern Chromium browsers. ๐Ÿ“บ ๐Ÿ–ฅ๏ธ ๐Ÿ’ป


I hope this post has given you a good intro to the component and how it can help simplify and enhance the playback experiences in your next big-screen web apps! ๐Ÿ™Œ


Live demo (for desktop browsers)

Github repo (full readme info and source code)


https://github.com/lewhunt/react-tv-player

Top comments (4)

Collapse
 
iz profile image
IZ

Thanks for good article. Here is another free IPTV provider:

Image description

Web: XTV
Android: XTV

Collapse
 
lewhunt profile image
Lewis Hunt

thanks, will take a look!

Collapse
 
dumebii profile image
Dumebi Okolo

This is awesome!

Collapse
 
lewhunt profile image
Lewis Hunt

Thanks! Glad it was useful ๐Ÿ™