@nomercy-entertainment/nomercy-video-player
Advanced tools
Full event-driven video player without a UI.
Plugin-Based HTML5 Video Player Built with TypeScript
Always feel like fighting video player UI choices? This one's built for developers who want complete control over their video experience.
A lightweight, plugin-based HTML5 video player built with TypeScript. Provides comprehensive video playback capabilities without imposing any UI decisions on your application.
Powers video playback in NoMercyTV
Choose your preferred package manager:
# npm
npm install @nomercy-entertainment/nomercy-video-player
# yarn
yarn add @nomercy-entertainment/nomercy-video-player
# pnpm
pnpm add @nomercy-entertainment/nomercy-video-player
import nmplayer from '@nomercy-entertainment/nomercy-video-player/src/index';
import OctopusPlugin from '@nomercy-entertainment/nomercy-video-player/src/plugins/octopusPlugin';
import KeyHandlerPlugin from '@nomercy-entertainment/nomercy-video-player/src/plugins/keyHandlerPlugin';
import type { PlayerConfig } from '@nomercy-entertainment/nomercy-video-player/src/types';
// Create player instance
const config: PlayerConfig = {
muted: false,
controls: false,
preload: 'auto',
accessToken: 'your bearer token', //(optional, can be passed in the file url as query manually)
basePath: 'https://raw.githubusercontent.com/NoMercy-Entertainment/media/refs/heads/master/Films/Films', // Base URL for media files (optional, can use a full url for the file)
playlist: [
{
title: 'Cosmos Laundromat',
description: 'On a desolate island, a suicidal sheep named Franck meets his fate…',
image: 'https://image.tmdb.org/t/p/w780/f2wABsgj2lIR2dkDEfBZX8p4Iyk.jpg',
file: '/Cosmos.Laundromat.(2015)/Cosmos.Laundromat.(2015).NoMercy.m3u8',
tracks: [
{ label: 'Dutch (Full)', file: '/Cosmos.Laundromat.(2015)/subtitles/Cosmos.Laundromat.(2015).NoMercy.dut.full.vtt', language: 'dut', kind: 'subtitles' },
{ label: 'English (Full)', file: '/Cosmos.Laundromat.(2015)/subtitles/Cosmos.Laundromat.(2015).NoMercy.eng.full.vtt', language: 'eng', kind: 'subtitles' },
// Additional subtitle tracks...
],
},
{
title: 'Sintel',
description: 'Sintel is an independently produced short film...',
image: 'https://image.tmdb.org/t/p/w780/q2bVM5z90tCGbmXYtq2J38T5hSX.jpg',
file: '/Sintel.(2010)/Sintel.(2010).NoMercy.m3u8',
tracks: [
{ label: 'Dutch (Full)', file: '/Sintel.(2010)/subtitles/Sintel.(2010).NoMercy.dut.full.vtt', language: 'dut', kind: 'subtitles' },
{ label: 'English (Full)', file: '/Sintel.(2010)/subtitles/Sintel.(2010).NoMercy.eng.full.vtt', language: 'eng', kind: 'subtitles' },
// Additional subtitle tracks...
],
},
// Additional playlist items...
],
playbackRates: [0.25, 0.5, 0.75, 1, 1.25, 1.5, 1.75, 2],
// Additional configuration options...
};
const player = nmplayer('player') // 'player' is the ID of the div element, do not use a video tag
.setup(config);
// Add keyboard controls
const keyHandler = new KeyHandlerPlugin();
player.registerPlugin('keyHandler', keyHandler);
player.usePlugin('keyHandler');
// Add subtitle support
const octopus = new OctopusPlugin();
player.registerPlugin('octopus', octopus);
player.usePlugin('octopus');
// Listen to events
player.on('play', () => console.log('Playback started'));
player.on('time', (timeData) => console.log(`${timeData.currentTime}s / ${timeData.duration}s`));
Want to extend functionality? Create custom plugins using our simple API:
import Plugin from '@nomercy-entertainment/nomercy-video-player/src/plugin';
import { NMPlayer } from '@nomercy-entertainment/nomercy-video-player/src/types';
export interface PluginArgs {
// Your extra config items
}
class CustomUIPlugin extends Plugin {
player: NMPlayer<PluginArgs> = NMPlayer < PluginArgs > {};
initialize(player: NMPlayer<PluginArgs>) {
this.player = player;
// Setup your plugin before use is called
}
dispose() {
// Clean up when plugin is unmounted
}
use() {
// Your plugin logic here
}
}
export default CustomUIPlugin;
💡 Need more examples? Check out our built-in plugins:
| Section | Description |
|---|---|
| 🏠 Wiki Home | Complete documentation hub |
| ⚡ Quick Start | Get running in 5 minutes |
| 📚 API Reference | Complete TypeScript API docs |
| 🔧 Plugin Development | Build custom plugins |
| 🎛️ Configuration | Player setup options |
| Feature | Chrome | Firefox | Safari | Edge |
|---|---|---|---|---|
| Core Audio | ✅ | ✅ | ✅ | ✅ |
| Web Audio API | ✅ | ✅ | ✅ | ✅ |
| Media Session | ✅ | ✅ | ✅ | ✅ |
| HLS Streaming | ✅ | ✅ | ✅* | ✅ |
| Spectrum Analyzer | ✅ | ✅ | ✅ | ✅ |
*Safari has native HLS support
We welcome contributions! Please see our Contributing Guide for details.
# Clone the repository
git clone https://github.com/NoMercy-Entertainment/NoMercyVideoPlayer.git
cd NoMercyVideoPlayer
# Install dependencies
npm install
# Start development
npm run dev
npm run build
npm run test
This project is licensed under the MIT License - see the LICENSE file for details.
NoMercy Entertainment builds open-source media tools that give developers full control over their audio and video experiences.
Built with ❤️ by the NoMercy Engineering Team
Empowering developers to create extraordinary video experiences
FAQs
Full event-driven video player without a UI.
We found that @nomercy-entertainment/nomercy-video-player demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Malicious Rust crate evm-units disguised as an EVM version helper downloads and silently executes OS-specific payloads likely aimed at crypto theft.
Security News
Socket CEO Feross Aboukhadijeh shares lessons from scaling a developer security startup to 10,000+ organizations in this founder interview.
Research
Socket Threat Research maps a rare inside look at OtterCookie’s npm-Vercel-GitHub chain, adding 197 malicious packages and evidence of North Korean operators.