MIMETypesCodecs: Difference between revisions

From XiphWiki
Jump to navigation Jump to search
(added some more formats)
(Add Opus to the list of allowed codecs for Ogg mime types.)
(30 intermediate revisions by 7 users not shown)
Line 1: Line 1:
== Specification of MIME Types and of codecs parameters ==
== Specification of MIME types and respective codecs parameter ==
 
Also includes a specification of the recommended file extensions to use with Ogg.


=== MIME Types ===
=== MIME Types ===


The following MIME types are now officially registered with IANA (well, almost,
The following MIME types are now officially registered with IANA and specified with the IETF as [http://www.ietf.org/rfc/rfc5334.txt RFC 5334]:
see [[https://datatracker.ietf.org/idtracker/draft-goncalves-rfc3534bis/]]):


* application/ogg - for complex, multitrack, multiplexed files encapsulated in Ogg
* video/ogg - for video (with audio) encapsulated in Ogg
** requires a Skeleton logical bitstream
 
* video/ogg - for video encapsulated in Ogg
** recommends a Skeleton logical bitstrem
** recommends a Skeleton logical bitstrem
** .ogv file extension
** Macintosh File Type Code: OggV


* audio/ogg - for audio encapsulated in Ogg
* audio/ogg - for audio encapsulated in Ogg
** recommends a Skeleton logical bitstrem
** recommends a Skeleton logical bitstrem
** .oga file extension, .ogg for Vorbis I, .spx for Speex
** Macintosh File Type Code: OggA


* application/ogg - for complex, multitrack, multiplexed files encapsulated in Ogg
** requires a Skeleton logical bitstream
** .ogx file extension
** Macintosh File Type Code: OggX


[[MIME_Types_and_File_Extensions | Other MIME types]] are still in the process.


[[MIME_Types_and_File_Extensions|Other MIME types]] are still in the process.


=== Codecs Parameter ===
=== Codecs Parameter ===


[http://www.rfc-editor.org/rfc/rfc4281.txt | Typically], MIME types of media encapsulation formats use the optional "codecs" parameter to specify which codes are being used in a particular file.
[http://www.rfc-editor.org/rfc/rfc4281.txt Typically], MIME types of media encapsulation formats use the optional "codecs" parameter to specify which codes are being used in a particular file.


Codecs encapsulated in Ogg require a text identifier at the beginning of the first header page to identify the encapsulated codecs.  The following table contains the identifiers for existing Xiph codecs and the codecs parameter names used for */ogg MIME types (in alphabetical order):
Codecs encapsulated in Ogg require a text identifier at the beginning of the first header page to identify the encapsulated codecs.  The following table contains the identifiers for existing Xiph codecs and the codecs parameter names used for */ogg MIME types (in alphabetical order):
Line 28: Line 34:
|-
|-
! Codecs Parameter Name
! Codecs Parameter Name
! Codec Identifier (decimal)
! Codec Type
! Codec Identifier (hex)
! Codec Identifier
! Codec Identifier (octal)
(decimal, hex, octal)
! Version Field (if available)
! Version Field (if available)
|-
|-
| [http://lists.xiph.org/pipermail/ogg-dev/2008-February/000891.html | dirac]
| [http://svn.annodex.net/liboggz/trunk/src/liboggz/oggz_auto.h celt]
| char[0,5]: 'BBCD\0'
| audio
| '0x42 0x42 0x43 0x44 00'
| char[0,8]: <tt>'CELT\ \ \ \ '</tt>
| '0102 0102 0103 0104 0000'
hex: <tt>'0x43 0x45 0x4c 0x54 0x20 0x20 0x20 0x20'</tt>
 
oct: <tt>'0103 0105 0114 0124 0040 0040 0040 0040'</tt>
| char[28,4]: version id
|-
| [http://svn.annodex.net/liboggz/trunk/src/liboggz/oggz_auto.h cmml]
| text
| char[0,8]: <tt>'CMML\0\0\0\0'</tt>
hex: <tt>'0x43 0x4d 0x4d 0x4c 0x00 0x00 0x00 0x00'</tt>
 
oct: <tt>'0103 0115 0115 0114 0000 0000 0000 0000'</tt>
| char[8,2]: major version number,
char[10,2]: minor version number
|-
| [http://wiki.xiph.org/index.php/OggDirac  dirac]
| video
| char[0,5]: <tt>'BBCD\0'</tt>
hex: <tt>'0x42 0x42 0x43 0x44 0x00'</tt>
 
oct: <tt>'0102 0102 0103 0104 0000'</tt>
| ??
| ??
|-
|-
| [http://flac.sourceforge.net/ogg_mapping.html | flac]
| [http://flac.sourceforge.net/ogg_mapping.html flac]
| char[0,5]: '\177FLAC'
| audio
| '0x7F 0x46 0x4C 0x41 0x43'  
| char[0,5]: <tt>'\177FLAC'</tt>
| '0177 0106 0114 0101 0103'
hex: <tt>'0x7F 0x46 0x4C 0x41 0x43'</tt>
 
oct: <tt>'0177 0106 0114 0101 0103'</tt>
| char[5,1]: binary major version number,  
| char[5,1]: binary major version number,  
char[6,1]: binary minor version number of mapping
char[6,1]: binary minor version number of mapping
|-
|-
| [http://lists.xiph.org/pipermail/vorbis-dev/2001-August/004501.html | midi]
| [[OggMNG|jng]]
| char[8]: 'OggMIDI\0'
| video
|  
| char[0,8]: <tt>'\213JNG\r\n\032\n'</tt>
hex: <tt>'0x8b 0x4a 0x4e 0x47 0x0D 0x0A 0x1A 0x0A'</tt>
 
oct: <tt>'0213 0112 0116 0107 0015 0012 0032 0012'</tt>
| ??
|-
| [[OggKate|kate]]
| text
| char[0,8]: <tt>'\x80kate\0\0\0'</tt>
hex: <tt>'0x80 0x6b 0x61 0x74 0x65 0x00 0x00 0x00'</tt>
 
oct: <tt>'0200 0153 0141 0164 0145 0000 0000 0000'</tt>
| char[9,1]: major version number,
char[10,1]: minor version number
|-
| [http://lists.xiph.org/pipermail/vorbis-dev/2001-August/004501.html midi]
| text
| char[0,8]: <tt>'OggMIDI\0'</tt>
hex: <tt>'0x4f 0x67 0x67 0x4d 0x49 0x44 0x49 0x00'</tt>
 
oct: <tt>'0117 0147 0147 0115 0111 0104 0111 0000'</tt>
| char[8,1]: version field
|-
|-
| [http://svn.annodex.net/liboggz/trunk/src/liboggz/oggz_auto.h | speex]
| [[OggMNG|mng]]
| char[0,8]: 'Speex  '
| video
| '0x53 0x70 0x65 0x65 0x78 0x20 0x20 0x20'
| char[0,8]: <tt>'\212MNG\r\n\032\n'</tt>
| '0123 0160 0145 0145 0170 0040 0040 0040'
hex: <tt>'0x8a 0x4d 0x4e 0x47 0x0D 0x0A 0x1A 0x0A'</tt>
| char[8,24]: version field,
 
char[24,4]: version id
oct: <tt>'0212 0115 0116 0107 0015 0012 0032 0012'</tt>
| ??
|-
|-
| [http://svn.annodex.net/liboggz/trunk/src/liboggz/oggz_auto.h | theora]
| [[OggOpus|opus]]
| char[0,7]: '\x80theora'
| audio
| '0x80 0x74 0x68 0x65 0x6f 0x72 0x61'
| char[0,8]: <tt>'OpusHead'</tt>
| '0180 0164 0150 0145 0157 0162 0141'
hex: <tt>'0x4f 0x70 0x75 0x73 0x48 0x65 0x61 0x64'</tt>
 
oct: <tt>'0117 0160 0165 0163 0110 0150 0141 0145 1044'</tt>
| char[8,1]: version field
|-
| [[OggPCM|pcm]]
| audio
| char[0,8]: <tt>'PCM\ \ \ \ \ '</tt>
hex: <tt>'0x50 0x43 0x4d 0x20 0x20 0x20 0x20 0x20'</tt>
 
oct: <tt>'0120 0103 0115 0040 0040 0040 0040 0040'</tt>
| char[8,2]: version major field,
char[10,2]: version minor field
|-
| [[OggMNG|png]]
| video
| char[0,8]: <tt>'\211PNG\r\n\032\n'</tt>
hex: <tt>'0x89 0x50 0x4e 0x47 0x0D 0x0A 0x1A 0x0A'</tt>
 
oct: <tt>'0211 0120 0116 0107 0015 0012 0032 0012'</tt>
| ??
|-
| [http://svn.annodex.net/liboggz/trunk/src/liboggz/oggz_auto.h speex]
| audio
| char[0,8]: <tt>'Speex\ \ \ '</tt>
hex: <tt>'0x53 0x70 0x65 0x65 0x78 0x20 0x20 0x20'</tt>
 
oct: <tt>'0123 0160 0145 0145 0170 0040 0040 0040'</tt>
| char[28,4]: version id
|-
| [http://svn.annodex.net/liboggz/trunk/src/liboggz/oggz_auto.h  theora]
| video
| char[0,7]: <tt>'\x80theora'</tt>
hex: <tt>'0x80 0x74 0x68 0x65 0x6f 0x72 0x61'</tt>
 
oct: <tt>'0180 0164 0150 0145 0157 0162 0141'</tt>
| char[7,1]: major version number,
| char[7,1]: major version number,
char[8,1]: minor version number,
char[8,1]: minor version number,
char[9,1]: version revision number
char[9,1]: version revision number
|-
|-
| [http://svn.annodex.net/liboggz/trunk/src/liboggz/oggz_auto.h | vorbis]
| [http://svn.annodex.net/liboggz/trunk/src/liboggz/oggz_auto.h vorbis]
| char[0,7]: '\x01vorbis'
| audio
| '0x01 0x76 0x6f 0x72 0x62 0x69 0x73'
| char[0,7]: <tt>'\x01vorbis'</tt>
| '0001 0166 0157 0162 0142 0151 0163'
hex: <tt>'0x01 0x76 0x6f 0x72 0x62 0x69 0x73'</tt>
 
oct: <tt>'0001 0166 0157 0162 0142 0151 0163'</tt>
| char[7,4]: version field
| char[7,4]: version field
|-
|-
| [[OggYUV4MPEG|yuv4mpeg]]
| video
| char[0,8]: <tt>'YUV4MPEG'</tt>
hex: <tt>'0x59 0x55 0x56 0x34 0x4d 0x50 0x45 0x47'</tt>
oct: <tt>'0131 0125 0126 0064 0115 0120 0105 0107'</tt>
| char[8,1] = '2' (0x32) for yuv4mpeg format version 2
|}
|}


        Codec Identifier            | Codecs Parameter
The "char[x,y]" fields mean here: start at byte number x (counting from 0) for a length of y bytes.
      -----------------------------------------------------------
 
        char[8]: 'OggMIDI\0'        | midi
[[Category:Ogg]]
        char[8]: 'CMML\0\0\0\0'      | cmml
        char[8]: '\211PNG\r\n\032\n' | png
        char[8]: '\212MNG\r\n\032\n' | mng
        char[8]: '\213JNG\r\n\032\n' | jng
        char[8]: 'CELT    '          | celt
        char[8]: 'PCM    '          | pcm
        char[9]: '\x80kate\0\0\0\0'  | kate
        char[9]: 'YUV4MPEG2'        | yuv4mpeg

Revision as of 09:19, 3 July 2012

Specification of MIME types and respective codecs parameter

Also includes a specification of the recommended file extensions to use with Ogg.

MIME Types

The following MIME types are now officially registered with IANA and specified with the IETF as RFC 5334:

  • video/ogg - for video (with audio) encapsulated in Ogg
    • recommends a Skeleton logical bitstrem
    • .ogv file extension
    • Macintosh File Type Code: OggV
  • audio/ogg - for audio encapsulated in Ogg
    • recommends a Skeleton logical bitstrem
    • .oga file extension, .ogg for Vorbis I, .spx for Speex
    • Macintosh File Type Code: OggA
  • application/ogg - for complex, multitrack, multiplexed files encapsulated in Ogg
    • requires a Skeleton logical bitstream
    • .ogx file extension
    • Macintosh File Type Code: OggX


Other MIME types are still in the process.

Codecs Parameter

Typically, MIME types of media encapsulation formats use the optional "codecs" parameter to specify which codes are being used in a particular file.

Codecs encapsulated in Ogg require a text identifier at the beginning of the first header page to identify the encapsulated codecs. The following table contains the identifiers for existing Xiph codecs and the codecs parameter names used for */ogg MIME types (in alphabetical order):

Codecs Parameter Name Codec Type Codec Identifier

(decimal, hex, octal)

Version Field (if available)
celt audio char[0,8]: 'CELT\ \ \ \ '

hex: '0x43 0x45 0x4c 0x54 0x20 0x20 0x20 0x20'

oct: '0103 0105 0114 0124 0040 0040 0040 0040'

char[28,4]: version id
cmml text char[0,8]: 'CMML\0\0\0\0'

hex: '0x43 0x4d 0x4d 0x4c 0x00 0x00 0x00 0x00'

oct: '0103 0115 0115 0114 0000 0000 0000 0000'

char[8,2]: major version number,

char[10,2]: minor version number

dirac video char[0,5]: 'BBCD\0'

hex: '0x42 0x42 0x43 0x44 0x00'

oct: '0102 0102 0103 0104 0000'

??
flac audio char[0,5]: '\177FLAC'

hex: '0x7F 0x46 0x4C 0x41 0x43'

oct: '0177 0106 0114 0101 0103'

char[5,1]: binary major version number,

char[6,1]: binary minor version number of mapping

jng video char[0,8]: '\213JNG\r\n\032\n'

hex: '0x8b 0x4a 0x4e 0x47 0x0D 0x0A 0x1A 0x0A'

oct: '0213 0112 0116 0107 0015 0012 0032 0012'

??
kate text char[0,8]: '\x80kate\0\0\0'

hex: '0x80 0x6b 0x61 0x74 0x65 0x00 0x00 0x00'

oct: '0200 0153 0141 0164 0145 0000 0000 0000'

char[9,1]: major version number,

char[10,1]: minor version number

midi text char[0,8]: 'OggMIDI\0'

hex: '0x4f 0x67 0x67 0x4d 0x49 0x44 0x49 0x00'

oct: '0117 0147 0147 0115 0111 0104 0111 0000'

char[8,1]: version field
mng video char[0,8]: '\212MNG\r\n\032\n'

hex: '0x8a 0x4d 0x4e 0x47 0x0D 0x0A 0x1A 0x0A'

oct: '0212 0115 0116 0107 0015 0012 0032 0012'

??
opus audio char[0,8]: 'OpusHead'

hex: '0x4f 0x70 0x75 0x73 0x48 0x65 0x61 0x64'

oct: '0117 0160 0165 0163 0110 0150 0141 0145 1044'

char[8,1]: version field
pcm audio char[0,8]: 'PCM\ \ \ \ \ '

hex: '0x50 0x43 0x4d 0x20 0x20 0x20 0x20 0x20'

oct: '0120 0103 0115 0040 0040 0040 0040 0040'

char[8,2]: version major field,

char[10,2]: version minor field

png video char[0,8]: '\211PNG\r\n\032\n'

hex: '0x89 0x50 0x4e 0x47 0x0D 0x0A 0x1A 0x0A'

oct: '0211 0120 0116 0107 0015 0012 0032 0012'

??
speex audio char[0,8]: 'Speex\ \ \ '

hex: '0x53 0x70 0x65 0x65 0x78 0x20 0x20 0x20'

oct: '0123 0160 0145 0145 0170 0040 0040 0040'

char[28,4]: version id
theora video char[0,7]: '\x80theora'

hex: '0x80 0x74 0x68 0x65 0x6f 0x72 0x61'

oct: '0180 0164 0150 0145 0157 0162 0141'

char[7,1]: major version number,

char[8,1]: minor version number,

char[9,1]: version revision number

vorbis audio char[0,7]: '\x01vorbis'

hex: '0x01 0x76 0x6f 0x72 0x62 0x69 0x73'

oct: '0001 0166 0157 0162 0142 0151 0163'

char[7,4]: version field
yuv4mpeg video char[0,8]: 'YUV4MPEG'

hex: '0x59 0x55 0x56 0x34 0x4d 0x50 0x45 0x47'

oct: '0131 0125 0126 0064 0115 0120 0105 0107'

char[8,1] = '2' (0x32) for yuv4mpeg format version 2

The "char[x,y]" fields mean here: start at byte number x (counting from 0) for a length of y bytes.