{"id":15145777,"url":"https://github.com/soundcloud/liboggz","last_synced_at":"2025-09-29T15:31:05.675Z","repository":{"id":46242050,"uuid":"4707724","full_name":"soundcloud/liboggz","owner":"soundcloud","description":"A library and tools for working with Ogg encapsulation, with support for seeking, chopping and validation.","archived":false,"fork":true,"pushed_at":"2023-04-09T21:06:01.000Z","size":1149,"stargazers_count":2,"open_issues_count":1,"forks_count":4,"subscribers_count":130,"default_branch":"master","last_synced_at":"2024-09-22T18:03:22.700Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.xiph.org/oggz/","language":"C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"kfish/liboggz","license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soundcloud.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-06-19T00:11:11.000Z","updated_at":"2024-04-18T03:39:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/soundcloud/liboggz","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soundcloud%2Fliboggz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soundcloud%2Fliboggz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soundcloud%2Fliboggz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soundcloud%2Fliboggz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soundcloud","download_url":"https://codeload.github.com/soundcloud/liboggz/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219874595,"owners_count":16554599,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-26T11:42:48.113Z","updated_at":"2025-09-29T15:31:05.268Z","avatar_url":"https://github.com/soundcloud.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"Documentation files for Oggz\n----------------------------\n\n    PATCHES: Instructions for generating patches\n    README: this file\n    README.symbian: Instructions for building for Symbian\n    README.win32: Instructions for building on Win32\n\nRun:\n----\n\n    $ oggz help\n\nfor documentation of the various oggz commands.\n\nAbout Oggz\n==========\n\nOggz comprises liboggz and the tool oggz, which provides commands to\ninspect, edit and validate Ogg files. The oggz-chop tool can also be\nused to serve time ranges of Ogg media over HTTP by any web server that\nsupports CGI.\n\nliboggz is a C library for reading and writing Ogg files and streams.\nIt offers various improvements over the reference libogg, including\nsupport for seeking, validation and timestamp interpretation. Ogg is\nan interleaving data container developed by Monty at Xiph.Org,\noriginally to support the Ogg Vorbis audio format but now used for\nmany free codecs including Dirac, FLAC, Speex and Theora.\n\nDependencies\n------------\n\nOggz depends only on libogg, available in most free software\ndistributions, or in source form at: http://xiph.org/downloads/\n\nSupport is built-in for parsing the headers of and seeking to time\npositions in Ogg Dirac, FLAC, Speex, Theora and Vorbis. Oggz is also\ncompatible with Annodex streams, and supports seeking on all tracks\ndescribed in an Ogg Skeleton track.\n\nInstallation\n------------\n\nRelease archives can be installed using the conventional commands:\n\n    $ ./configure\n    $ make check\n    $ sudo make install\n\nsequence. Configuration details are in the file INSTALL. If you obtained\nthis source by svn, first run \"./autogen.sh\" to create the configure script,\nthen run the above commands.\n\nRead the file README.win32 for installing under MS Windows, and\nREADME.symbian for information about building for Symbian devices.\n\nSource layout\n-------------\n\n    doc/\n    doc/liboggz        autocreated by the doxygen tool from comments\n                       contained in the public C header files\n\n    include/           public C header files\n\n    src/\n    src/liboggz/       library source code.\n    src/tools/         command line tools\n    src/examples/      example programs using liboggz\n    src/tests/         unit and functional tests\n\n    symbian/           files necessary to compile the library for Symbian\n    win32/             files necessary to compile the library and tools for\n                       Microsoft Windows\n\nDevelopers\n----------\n\nliboggz is maintained in git at git://git.xiph.org/liboggz.git\n\nA list of outstanding tasks is maintained in the TODO file of this source\ndistribution. When implementing anything listed in this file, please update\nit by deleting that entry, and include that as part of the patch or commit\nthat implements the fix.\n\nPlease send patches to ogg-dev@xiph.org\n\nProgramming with liboggz\n------------------------\n\nliboggz supports the flexibility afforded by the Ogg file format while\npresenting the following API niceties:\n\n    * Full API documentation\n\n    * Comprehensive test suite of read, write and seeking behavior.\n    The entire test suite can be run under valgrind if available.\n\n    * Developed and tested on GNU/Linux, Darwin/MacOSX, Win32 and\n    Symbian OS. May work on other Unix-like systems via GNU autoconf.\n    For Win32: nmake Makefiles, Visual Studio .NET 2003, 2005 and 2008\n    solution files are provided in the source distribution.\n\n    * Strict adherence to the formatting requirements of Ogg bitstreams,\n    to ensure that only valid bitstreams are generated; writes can fail\n    if you try to write illegally structured packets.\n\n    * A simple, callback based open/read/close or open/write/close\n    interface to raw Ogg files.\n\n    * Writing automatically interleaves with packet queuing, and provides\n    callback based notification when this queue is empty\n\n    * A customisable seeking abstraction for seeking on multitrack Ogg\n    data. Seeking works easily and reliably on multitrack and multi-codec\n    streams, and can transparently parse Theora, Speex, Vorbis, FLAC,\n    PCM, CMML and Ogg Skeleton headers  without requiring linking to those\n    libraries. This allows efficient use on servers and other devices\n    that need to parse and seek within Ogg files, but do not need to do\n    a full media decode.\n\nFull documentation of the liboggz API, customization and installation,\nand mux and demux examples can be read online at:\n\n    http://www.xiph.org/oggz/doc/\n\noggz tool\n---------\n\nUsage: oggz \u003csubcommand\u003e [options] filename ...\n\noggz is a commandline tool for manipulating Ogg files. It supports\nmultiplexed files conformant with RFC3533. Oggz can parse headers for CELT,\nCMML, Dirac, FLAC, Kate, PCM, Speex, Theora and Vorbis, and can read and write\nOgg Skeleton logical bitstreams.\n\nCommands:\n  help          Display help for a specific subcommand (eg. \"oggz help chop\")\n\nReporting:\n  codecs        Display the codecs present in an Ogg file\n  diff          Hexdump the packets of two Ogg files and output differences.\n  dump          Hexdump packets of an Ogg file, or revert an Ogg file from\n                such a hexdump.\n  info          Display information about one or more Ogg files and their\n                bitstreams.\n  scan          Scan an Ogg file and output characteristic landmarks.\n  validate      Validate the Ogg framing of one or more files.\n\nExtraction:\n  rip           Extract one or more logical bitstreams from an Ogg file.\n\nEditing:\n  chop          Extract the part of an Ogg file between given start and/or\n                end times.\n  comment       List or edit comments in an Ogg file.\n  merge         Merge Ogg files together, interleaving pages in order of\n                presentation time.\n  sort          Sort the pages of an Ogg file in order of presentation time.\n\nMiscellaneous:\n  known-codecs  List codecs known by this version of oggz\n\nThe script bash-completion/oggz enables completion of tool options and codec\nnames when using the bash shell. Source it from your .profile, or install it\nin /etc/bash_completion.d to enable it system-wide.\n\n\noggz-chop: General usage and CGI installation\n---------------------------------------------\n\noggz-chop extracts the part of an Ogg file between given start and/or end\ntimes. The output file contains copies of the headers of the input file, and\nall the codec data required to correctly decode the content between the start\nand end times specified on the commandline. For codecs with data dependencies\nlike video keyframes, the keyframe prior to the starting time will be included\nin the output.\n\nAn Apache server can be configured to use oggz-chop to handle all Ogg files\n(or, all Ogg files in a particular directory). An example Apache configuration\nis in the liboggz source tree, along with a script for installing it on a\nDebian server.\n\nThe oggz-chop binary checks if it is being run as a CGI script (by checking\nsome environment variables), and if so acts based on the CGI query parameter\nt=, much like mod_annodex. It accepts all the time specifications that\nmod_annodex accepts (npt and various smpte framerates), and start and end\ntimes separated by a /.\n\nLicense\n-------\n\nOggz is Free Software, available under a BSD style license.\n\nMore information is available online at the Oggz homepage:\n\n    http://xiph.org/oggz/\n\nenjoy :)\n\n--\nConrad Parker\nhttp://www.annodex.net/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoundcloud%2Fliboggz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoundcloud%2Fliboggz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoundcloud%2Fliboggz/lists"}