@nxtedition/mime

@nxtedition/mime

MIME type lookup and extension resolution with built-in support for broadcast and professional media formats missing from the standard mime package.

Install

npm install @nxtedition/mime

Usage

Lookup MIME type by filename

import { lookup } from '@nxtedition/mime'

lookup('video.mxf') // 'application/mxf'
lookup('video.mp4') // 'video/mp4'
lookup('video.nut') // 'video/x-nut'
lookup('audio.ac3') // 'audio/ac3'
lookup('subs.stl') // 'application/x-ebu-stl'
lookup('subs.scc') // 'text/x-scc'

Get extension from MIME type

import { extension } from '@nxtedition/mime'

extension('video/mp4') // 'mp4'
extension('video/x-dnxhd') // 'dnxhd'
extension('audio/ac3') // 'ac3'
extension('application/x-ebu-stl') // 'stl'
extension('video/quicktime', 'clip.mov') // 'mov'

Broadcast & media types

Types handled beyond the standard mime package:

Extension	MIME Type	Format
.nut	video/x-nut	NUT container
.dnxhd	video/x-dnxhd	Avid DNxHD/DNxHR
.dv	video/x-dv	DV video
.h265	video/h265	Raw HEVC stream
.av1	video/av1	Raw AV1 stream
.ffv1	video/ffv1	FFV1 archival codec
.vc1	video/vc1	VC-1 video
.ac3	audio/ac3	Dolby Digital
.eac3	audio/eac3	Dolby Digital Plus
.opus	audio/opus	Opus audio
.flac	audio/flac	FLAC lossless
.pcm-s16le	audio/x-pcm-s16le	Raw 16-bit PCM
.pcm-s24le	audio/x-pcm-s24le	Raw 24-bit PCM
.pcm-s32le	audio/x-pcm-s32le	Raw 32-bit PCM
.stl	application/x-ebu-stl	EBU STL subtitles
.scc	text/x-scc	Scenarist Closed Captions
.cap	application/x-cap	Softel CAP captions
.890	application/x-890	Cavena 890 subtitles
.pac	application/x-pac	Screen Electronics PAC
.ass	text/x-ass	Advanced SubStation Alpha
.ssa	text/x-ssa	SubStation Alpha
.exr	image/x-exr	OpenEXR
.cin	image/x-cin	Cineon
.ism	application/vnd.ms-sstr+xml	Smooth Streaming

API

lookup(name: string): string | null

Returns the MIME type for the given filename or path, or null if unknown.

extension(mimeType: string, fileName?: string): string | null

Returns the file extension for the given MIME type, or null if unknown. The optional fileName parameter is used to disambiguate (e.g. video/quicktime → mov when the filename ends in .mov).

License

MIT