Does your artifact manager get in the way? Join us on Oct. 8 at 10am PT, to discuss how npm can help.Sign up »


2.7.2 • Public • Published

mat-video for Angular 5/6/7/8+ and Material

npm version Build Status Maintainability

mat-video is an Angular component for playing videos. It has all the features you would expect from a standard video player, all in an extremely light package. The video player is designed to be flexible and easy to use; you can be up and running in less than 5 minutes!

It was built for modern browsers using TypeScript, CSS3 and HTML5 with Angular & Material 5/6/7/8+.

See the changelog for recent changes.

If you wish to contribute, please fill out the pull request template. For issues, please fill out the issue template before submitting.


  • Native HTML5 video player
  • Easy to use
  • Play/Pause
  • Seeking
  • Volume
  • Autoplay
  • Preload
  • Looping
  • Scaling
  • Fullscreen
  • Download
  • Buffering spinners
  • Poster image
  • Subtitles and text tracks
  • Multiple media sources
  • Customizable controls
  • Material theming
  • Keyboard shortcuts
  • Fixed and responsive sizing
  • Supports Chrome, Firefox, Safari, and Edge


mat-video requires Angular Material as a peer dependency, including animations.

npm install --save @angular/material @angular/cdk @angular/animations hammerjs

Add the following import to src/polyfills.ts:

import 'hammerjs';

To use mat-video in your project install it via npm:

npm install --save mat-video

Add the following to your module:

import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
import { MatVideoModule } from 'mat-video';
  imports: [
export class AppModule { }

Finally, include an Angular Material theme in styles.css, or via a <link> element in index.html.

@import '~@angular/material/prebuilt-themes/indigo-pink.css';


A minimal example is quite simple, in your HTML file:

    <mat-video src="localOrRemoteVideo.mp4"></mat-video>

A slightly more customized example, in your HTML file:

    <mat-video title="My Tutorial Title" [autoplay]="true" [preload]="true" [fullscreen]="true" [download]="false" color="accent" spinner="spin" poster="image.jpg">
      <source matVideoSource src="tutorial.mp4" type="video/mp4">
      <source src="tutorial.webm" type="video/webm">
      <track matVideoTrack src="subtitles_en.vtt" kind="subtitles" srclang="en" label="English">
      <track src="subtitles_no.vtt" kind="subtitles" srclang="no" label="Norwegian">


Attribute Type Description Default
src string Path or URL to a video null
title string Title for the video null
autoplay boolean Whether the video should autoplay false
preload boolean Whether the video should preload true
loop boolean Whether the video should loop false
time number (two-way bindable) Get or set the timestamp of the video 0
muted boolean (two-way bindable) Get or set whether the video is muted false
quality boolean Whether the video will have a quality indicator true
download boolean Whether the video will have a download option false
fullscreen boolean Whether the video will have a fullscreen option true
showFrameByFrame boolean Whether the video will display frame-by-frame controls false
keyboard boolean Whether the player will have keyboard shortcuts true
overlay boolean Force the overlay/controls to be shown or hidden null
color ThemePalette Material theme color palette for the sliders primary
spinner string Use 'spin', 'dot', 'split-ring', 'hourglass', or pass your own buffering spinner class spin
poster string Path or URL to a poster image null

In addition, source and track elements are supported by mat-video.

The matVideoSource attribute can be used on the source tag to automatically reload the video when the source changes.

The matVideoTrack attribute can be used on the track tag to automatically reload the video when the track changes.


Listening to video events can be accomplished by directly accessing the video tag within mat-video.

In your HTML file:

    <mat-video #video src="localOrRemoteVideo.mp4"></mat-video>

In your TS file:

export class SampleComponent implements OnInit {
  @ViewChild('video') matVideo: MatVideoComponent;
  video: HTMLVideoElement;
  constructor(private renderer: Renderer2) { }
  ngOnInit(): void { = this.matVideo.getVideoTag();
    // Use Angular renderer or addEventListener to listen for standard HTML5 video events
    this.renderer.listen(, 'ended', () => console.log('video ended'));'ended', () => console.log('video ended'));

This API feature is considered experimental, and is subject to change.

Angular Compatibility Depreciation Notice (2019-06-14)

Angular is rapidly growing with every major release. This has caused an increasing burden on the development of mat-video to support older versions of Angular. Due to the vast amount of differences between modern Angular and previous Angular versions, mat-video will officially be dropping support for older Angular versions with the upcoming Angular 9 release scheduled for November 2019. Existing releases will continue to function with older versions of Angular, however, no support will be provided for these versions. Instead, mat-video will provide backwards compatibility in a similar way to how Angular supports this. This notice is provided as an opportunity for developers to make necessary upgrades and plans for the future. More details will be announced closer to the release of Angular 9.


mat-video is an open-source project developed by Nicholas Koehler.

Special thanks to mediapack-me for responsive assistance.


npm i mat-video

Downloadsweekly downloads









last publish


  • avatar
Report a vulnerability