Skip to main content

Extract samples

warning

We are phasing out Media Parser and are moving to Mediabunny!

With parseMedia(), you can extract video and audio samples from a variety of media formats.

Getting tracks​

Use onVideoTrack and/or onAudioTrack to get information about a video track.

Extract tracks from a video
import {parseMedia} from '@remotion/media-parser';

const samples = await parseMedia({
  src: 'https://remotion.media/video.mp4',
  onVideoTrack: ({track, container}) => {
    console.log(track.codecEnum);
                         
(property) codecEnum: MediaParserVideoCodec
    return null;
  },
});

See the type definitions for MediaParserVideoTrack and MediaParserAudioTrack for more information.

Return null if you are not interested in getting samples from the track.

Getting samples​

If you return a callback from onVideoTrack and/or onAudioTrack, you can get samples from the track.

Extract samples from a video
import {parseMedia} from '@remotion/media-parser';

const samples = await parseMedia({
  src: 'https://remotion.media/video.mp4',
  onVideoTrack: ({track, container}) => {
    return (sample) => {
      console.log(sample);
                    
(parameter) sample: MediaParserVideoSample
    };
  },
});

See the type definitions for MediaParserVideoSample and MediaParserAudioSample for more information.

Check if a sample was the last onev4.0.307​

If you would like to execute code when the last sample of a track has been parsed, you can return a callback from the sample callback that will be called when the last sample has been parsed.

Execute code when the last sample of a track has been parsed
import {parseMedia} from '@remotion/media-parser';

const samples = await parseMedia({
  src: 'https://remotion.media/video.mp4',
  onVideoTrack: ({track, container}) => {
    return (sample) => {
      return () => {
        console.log(sample, 'is the last sample');
      };
    };
  },
});

Seeking in callbacks​

In all types of callbacks, you can pause, resume, seek and abort.

Looping the parse
import {parseMedia, mediaParserController} from '@remotion/media-parser';

const controller = mediaParserController();

const samples = await parseMedia({
  src: 'https://remotion.media/video.mp4',
  controller,
  onVideoTrack: ({track, container}) => {
    return (sample) => {
      return () => {
        // When it's the last sample, seek to the beginning
        controller.seek(0);
      };
    };
  },
});

See: mediaParserController() and Seeking.