Library:Libvorbis
| Developer | Xiph.Org Foundation |
|---|---|
| Uses | Library:Libogg |
| Platforms | any (portable C) |
| Versions | 1.0 (2002) to 1.3.7 (2020) |
| License | BSD-3-Clause |
| Website | https://xiph.org/vorbis/ |
| On this wiki | Facts · Code · Notes · Topics |
The Xiph.Org reference Vorbis codec (C, BSD-3-Clause): libvorbis (vorbis_synthesis_*, vorbis_analysis_*), libvorbisenc (vorbis_encode_*) and libvorbisfile (ov_* Ogg file reader), shipped as libvorbis.dll / libvorbisfile.dll, libvorbis.so.0 or statically in engines, FFmpeg and libsndfile. Its encoder vendor string "Xiph.Org libVorbis I YYYYMMDD (nickname)", also written into every file it encodes, dates the version.
Overview
libvorbis is the Xiph.Org reference implementation of the Format:Vorbis audio codec (C, BSD-3-Clause): libvorbis proper (decoder and encoder core: vorbis_synthesis_, vorbis_analysis_, vorbis_info_, vorbis_comment_), libvorbisenc (the encoder's tuned setup modes: vorbis_encode_) and libvorbisfile (ov_ convenience API that reads Format:Ogg files through Library:Libogg, seeks and decodes to PCM). Games and engines link it as libvorbis.dll / vorbis.dll / libvorbis_64.dll plus libvorbisfile.dll / vorbisfile.dll, as libvorbis.so.0, libvorbisenc.so.2 and libvorbisfile.so.3, or statically (FFmpeg, libsndfile, SDL_mixer, many engines). stb_vorbis and Tremor (integer decoder) are independent decoders with other names.
Identification
- Vendor string: libvorbisenc writes ENCODE_VENDOR_STRING into every comment header it creates, and it is in the binary: "Xiph.Org libVorbis I YYYYMMDD" with a nickname since 1.3.1. The same string in an .ogg file's comment header tells which libvorbis encoded it (unless a muxer rewrote it, as FFmpeg does).
- Version string: vorbis_version_string() returns GENERAL_VENDOR_STRING "Xiph.Org libVorbis 1.3.x" (present in 1.3.2 builds and later).
- Exports (win32/vorbis.def): vorbis_info_init, vorbis_synthesis_headerin, vorbis_synthesis_idheader, vorbis_synthesis_pcmout, vorbis_analysis_headerout, vorbis_comment_query, vorbis_version_string and also the three data exports
_floor_P,_mapping_P,_residue_P(function-pointer tables of the floor, mapping and residue back ends); the current .def also lists the six vorbis_encode_* functions (46 names). libvorbisfile exports ov_open, ov_open_callbacks, ov_fopen, ov_read, ov_read_float, ov_pcm_total, ov_time_total, ov_pcm_seek, ov_info, ov_comment and others (35 names). - In a file: Format:Vorbis#Header packets.
| libvorbis | Date | ENCODE_VENDOR_STRING |
|---|---|---|
| 1.0 | 2002-07-19 | Xiph.Org libVorbis I 20020717 |
| 1.0.1 | 2003-11-17 | Xiph.Org libVorbis I 20030909 |
| 1.1.0 | 2004-09-22 | Xiph.Org libVorbis I 20040629 |
| 1.1.1, 1.1.2 | 2005 | Xiph.Org libVorbis I 20050304 |
| 1.2.0 | 2007-07-25 | Xiph.Org libVorbis I 20070622 |
| 1.2.1 (unreleased) | Xiph.Org libVorbis I 20080501 | |
| 1.2.2 | 2009-06-24 | Xiph.Org libVorbis I 20090624 |
| 1.2.3 | 2009-07-09 | Xiph.Org libVorbis I 20090709 |
| 1.3.1 | 2010-02-26 | Xiph.Org libVorbis I 20100325 (Everywhere) |
| 1.3.2 | 2010-11-01 | Xiph.Org libVorbis I 20101101 (Schaufenugget) |
| 1.3.3 | 2012-02-03 | Xiph.Org libVorbis I 20120203 (Omnipresent) |
| 1.3.4 | 2014-01-22 | Xiph.Org libVorbis I 20140122 (Turpakäräjiin) |
| 1.3.5 | 2015-03-03 | Xiph.Org libVorbis I 20150105 (⛄⛄⛄⛄) (four U+26C4 snowmen, UTF-8) |
| 1.3.6 | 2018-03-16 | Xiph.Org libVorbis I 20180316 (Now 100% fewer shells) |
| 1.3.7 | 2020-07-04 | Xiph.Org libVorbis I 20200704 (Reducing Environment) |
The dates in the string are not always the release dates (1.0.1, 1.1.0, 1.3.1, 1.3.5), and 1.1.1 and 1.1.2 share one string.
Where it appears
Checked here: Unreal Engine 5.8's prebuilt libvorbis_64.dll (2015 PE timestamp, 46 exports incl. vorbis_encode_) and libvorbisfile_64.dll (35 exports) are 1.3.2, as are those of four UE games checked; The Binding of Isaac: Rebirth's 32-bit libvorbis.dll (40 exports, no vorbis_encode_) is 1.3.2; Unreal Engine's libsndfile-1.dll (libsndfile 1.2.2) and an FFmpeg 9.0 static Windows build contain 1.3.7; Software:VLC media player 3.0.23 x64 links 1.3.6 into plugins/codec/libvorbis_plugin.dll and plugins/demux/libogg_plugin.dll. In 7,835 Ogg Vorbis files of one commercial game, 68 were encoded by libvorbis 1.3.3 and 1 by 1.3.7 (the rest carry FFmpeg's vendor string).
Code & repositories
- https://github.com/xiph/vorbis @
1b75110b5a2754ba1931d82dd83cb822b266a21d· license: BSD-3-Clause
libvorbis, libvorbisenc and libvorbisfile source (lib/info.c header packing and vendor strings, lib/codebook.c codebook sync, lib/vorbisfile.c), the Vorbis I specification source (doc/Vorbis_I_spec.tex) and CHANGES with every release's vendor string.
Tested on: Read at this commit; header layouts checked against 7,835 Ogg Vorbis files with the Python dumper on Format:Ogg; vendor and version strings compared with libvorbis DLLs of Unreal Engine 5.8 and The Binding of Isaac: Rebirth and static copies in libsndfile 1.2.2 and FFmpeg 9.0. Not built. · checked 2026-10-17; last activity 2026-08-04; Note: the latest release ships binaries; the wiki links only the source, never the binaries
Pitfalls
- A 1.3.2 library (2010, still shipped by Unreal Engine) predates the decoder fixes of 1.3.5 ("Fix decoder crash with invalid input") and 1.3.6 (CVE-2018-5146, out-of-bounds write in codebook decoding; CVE-2017-14632, CVE-2017-14633); the 1.3.7 CVEs (CVE-2017-14160, CVE-2018-10392, CVE-2018-10393) are encoder-side.
- The vendor string in a file names the encoder library, not the program; FFmpeg's muxer replaces it ("Lavf..."), so the absence of a libVorbis vendor does not mean another encoder.
Evidence & references
- https://github.com/xiph/vorbis at 1b75110b5a2754ba1931d82dd83cb822b266a21d: lib/info.c lines 32-33 (GENERAL_VENDOR_STRING, ENCODE_VENDOR_STRING) and 690-692 (vorbis_version_string), CHANGES lines 1-182 (one line per release with its vendor string), win32/vorbis.def, win32/vorbisfile.def, win32/vorbisenc.def.
- Binaries read with a small Python PE reader (exports and strings), nothing executed.