media-codecs
Advanced tools
Readme
Get a codec parameter string (like "avc1.4d002a") from human readable options (like { name: "Main", level: "4.2" }) and back to a descriptive name ("AVC Main Profile Level 4.2").
Useful for checking supported codecs with HTMLMediaElement.canPlayType / MediaSource.isTypeSupported and to pass as option for the WebCodecs API VideoEncoder configure parameters. Supports Advanced Video Coding (AVC), Video Partition (VP8/VP9), AOMedia Video (AV1) and partially High Efficiency Video Coding HEVC.
See the demo that checks current browser support of all video codecs and MDN's Codecs in common media types.
npm install media-codecs
import { AVC } from "media-codecs";
const codec = AVC.getCodec({ profile: "Main", level: "4.2" });
// => avc1.4d002a
const mimeType = `video/mp4;codecs="${codec}"`;
console.log(MediaSource.isTypeSupported(mimeType));
Roadmap:
objectobjectobjectobjectobjectobjectobjectobjectvpKind: static property of media-codecs
avKind: static property of media-codecs
avcKind: static property of media-codecs
hevcKind: static property of media-codecs
Array.<CodecItem>Array.<AVProfileItem>Array.<string>Array.<string>Array.<number>Array.<MediaCodecItem>stringstringArray.<CodecItem>List of codecs
Kind: static constant of av
Array.<AVProfileItem>List of AV profiles numbers
Kind: static constant of av
See: av1-spec
Array.<string>AV Levels
Kind: static constant of av
See: av1-spec
Array.<string>List of supported tier
Kind: static constant of av
Array.<number>List of supported bit depth
Kind: static constant of av
Array.<MediaCodecItem>Return a list of all possible codec parameter string and their human readable names
Kind: static method of av
stringGet a codec parameter string
Kind: static method of av
| Param | Type |
|---|---|
| options | AVCodecOptions |
stringGet a codec human readbable name
Kind: static method of av
| Param | Type | Description |
|---|---|---|
| codec | string | a codec string (av01.P.LLT.DD eg. "av01.P.LLT.DD") |
Array.<VCProfileItem>Array.<number>Array.<MediaCodecItem>stringstringArray.<VCProfileItem>List of profiles with their profile numbers (PP) and the constraints component (CC).
Kind: static constant of avc
Array.<number>AVC Levels
Kind: static constant of avc
See: wikipedia.org
Array.<MediaCodecItem>Return a list of all possible codec parameter string and their human readable names
Kind: static method of avc
stringGet a codec parameter string
Kind: static method of avc
| Param | Type |
|---|---|
| options | AVCCodecOptions |
stringGet a codec human readbable name
Kind: static method of avc
| Param | Type | Description |
|---|---|---|
| codec | string | a codec string (cccc.PP.LL.DD eg. "vp09.00.10.08") |
Array.<VCProfileItem>Array.<number>Array.<string>Array.<string>Array.<MediaCodecItem>stringstringArray.<VCProfileItem>List of profiles with their profile numbers (PP) and the compatibility (C).
See Annexe 3 Profiles
Kind: static constant of hevc
Array.<number>HEVC Profile Compatibility as a number in the 0..32 range TODO: is that correct
Kind: static constant of hevc
Array.<string>HEVC Levels
Kind: static constant of hevc
See: hevc-levels
Array.<string>List of supported tier
Kind: static constant of hevc
Array.<MediaCodecItem>Return a list of all possible codec parameter string and their human readable names
Kind: static method of hevc
stringGet a codec parameter string
Kind: static method of hevc
| Param | Type |
|---|---|
| options | HEVCCodecOptions |
stringGet a codec human readbable name
Kind: static method of hevc
| Param | Type | Description |
|---|---|---|
| codec | string | a codec string (cccc.PP.C.TLL.CC eg. "hev1.1.3.H34.B0") |
Array.<CodecItem>Array.<number>Array.<string>Array.<number>Array.<MediaCodecItem>stringstringArray.<CodecItem>List of codecs
Kind: static constant of vp
Array.<number>List of VP profiles numbers
Kind: static constant of vp
Array.<string>VP Levels
Kind: static constant of vp
See: webmproject.org
Array.<number>List of supported bit depth
Kind: static constant of vp
Array.<MediaCodecItem>Return a list of all possible codec parameter string and their human readable names
Kind: static method of vp
stringGet a codec parameter string
Kind: static method of vp
| Param | Type |
|---|---|
| options | VPCodecOptions |
stringGet a codec human readbable name
Kind: static method of vp
| Param | Type | Description |
|---|---|---|
| codec | string | a codec string (avc1[.PPCCLL] eg. "avc1.640028") |
objectKind: global typedef Properties
| Name | Type | Description |
|---|---|---|
| name | string | |
| PP | string | profile numbers (seq_profile) |
objectKind: global typedef Properties
| Name | Type | Description |
|---|---|---|
| name | string | |
| PP | string | profile numbers as hex string |
| CC | string | constraints component as hex string |
objectKind: global typedef Properties
| Name | Type | Description |
|---|---|---|
| name | string | |
| cccc | string | the four-character ID for the codec |
objectKind: global typedef Properties
| Name | Type |
|---|---|
| name | string |
| codec | string |
objectKind: global typedef Properties
| Name | Type | Description |
|---|---|---|
| name | string | Human readable codec name: "VP8" or "VP9" |
| profile | number | 0, 1, 2 or 3 |
| level | string | |
| bitDepth | number |
objectKind: global typedef Properties
| Name | Type | Description |
|---|---|---|
| name | string | Human readable codec name: "AV1", potentially AV2 in the future |
| profile | string | AV profile name: "Main", "High" or "Professional" |
| level | string | |
| tier | string | "Main" or "High" |
| bitDepth | number | 8, 10 or 12 |
objectKind: global typedef Properties
| Name | Type | Description |
|---|---|---|
| profile | string | AVC profile name (eg. "Baseline") |
| level | string |
objectKind: global typedef Properties
| Name | Type | Description |
|---|---|---|
| profile | string | HEVC profile name (eg. "Main 10") |
| compatibility | number | |
| level | string | |
| tier | string | "Main" or "High" |
| constraint | string | TODO |
MIT. See license file.
FAQs
Get a codec parameter string (like 'avc1.4d002a') from human readable options (like { name: 'Main', level: '4.2' }) and back to a descriptive name ('AVC Main Profile Level 4.2').
The npm package media-codecs receives a total of 153 weekly downloads. As such, media-codecs popularity was classified as not popular.
We found that media-codecs 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.
Security News
ESLint has approved an RFC that adds support for TypeScript configuration files, which is aimed at improving the developer experience and recognizing changes in the evolving JavaScript ecosystem.
Security News
The NVD is facing a significant backlog with over 12,500 CVEs awaiting analysis, and more than 50% of known exploited vulnerabilities (KEVs) left unenriched since mid-February.
Security News
Ransomware costs victims an estimated $30 billion per year and has gotten so out of control that global support for banning payments is gaining momentum.