- JavaScript 78.1%
- TypeScript 21.5%
- CSS 0.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
ad74b96fd4
`\t *` rather than `\t*` is what the linter calls mixed spaces and tabs, and it failed the whole test job on 21 lines of comment I had just written. The house style is in the file from line 36 onwards. The dependency bump alongside it clears four advisories -- postcss path traversal (high, plus the incomplete-fix follow-up), nanoid, js-yaml and brace-expansion. All four are dev-only, all four are in the lockfile and none of them changes a published byte: `npm audit` goes from 4 to 0, 1232 tests pass and the bundle builds. |
||
| .github/workflows | ||
| e2e | ||
| public | ||
| scripts | ||
| src | ||
| .gitattributes | ||
| .gitignore | ||
| .prettierrc | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| eslint.config.js | ||
| LICENSE | ||
| MIGRATION.md | ||
| package-lock.json | ||
| package.json | ||
| playwright.config.ts | ||
| README.md | ||
| RELEASING.md | ||
| SECURITY.md | ||
| tsconfig.build.json | ||
| tsconfig.json | ||
| vite.config.ts | ||
| vite.iife.config.ts | ||
| vitest.config.ts | ||
Full documentation: https://docs.nomercy.tv/nomercy-video-player/
nomercy-video-player
The headless HLS video engine behind NoMercy TV.
It handles the hard parts of video and hands you plain events and methods.
You stay in control of the interface.
- Adaptive bitrate streaming over HLS, with HDR-aware quality
- Multi-format subtitles (VTT, ASS, SSA), chapters, and skip markers
- Chromecast, a full keyboard and touch input layer, a typed event bus
- A built-in
DesktopUiPluginfor full controls, or bring your own UI
Built on nomercy-player-core, the shared engine for the queue, auth, plugins, i18n, and storage.
Install
npm install @nomercy-entertainment/nomercy-video-player
HLS support is built in. hls.js ships with the player core, so .m3u8 streams work out of the box with nothing extra to install.
Quick start
import { nmplayer } from '@nomercy-entertainment/nomercy-video-player';
import { DesktopUiPlugin } from '@nomercy-entertainment/nomercy-video-player/plugins';
const player = nmplayer('player')
.addPlugin(DesktopUiPlugin)
.setup({
baseUrl: 'https://raw.githubusercontent.com/NoMercy-Entertainment/nomercy-media/master/Films',
playlist: [
{
id: 'sintel',
title: 'Sintel',
url: '/Sintel.(2010)/Sintel.(2010).NoMercy.m3u8',
duration: 888,
},
],
});
player.on('ready', () => {
player.item(0, { autoplay: true });
});
That mounts a working player with the full built-in UI.
Bring your own UI
No UI is bundled. Nothing is forced on you.
The controls, the input handling, every feature beyond playback is a plugin you opt into with addPlugin. Drop DesktopUiPlugin from the quick start above and you build your own interface from the player's events, the path the Build a Player tutorial walks one control at a time.
You can also swap any built-in behavior. Pass your own storage, URL resolver, logger, or retry policy to setup(). No subclassing.
Upgrading from v1
See MIGRATION.md for the full breaking-change list, including renamed methods, changed event payloads, and the item.file to item.url rename that breaks silently if missed.
Documentation
The docs site is the full reference, ordered from first player to plugin author:
- Introduction and Quick Start, install and first player
- The Guided Tour over transport, volume, queue, subtitles, quality, and chapters, method by method
- Build a Player, a ten-step tutorial that builds your own UI plugin from scratch
- Framework recipes for Vue, React, Svelte, and vanilla JS
- Configuration, API Methods, and Events
License
Apache-2.0
Repository: github.com/NoMercy-Entertainment/nomercy-video-player