HOgg 0.4.1.1 Released
---------------------
The HOgg package provides a commandline tool for manipulating Ogg files,
and a corresponding Haskell library. HOgg is in hackage, or on the web at:
http://www.kfish.org/~conrad/software/hogg/
This is the fifth public release. The focus is on correctness of Ogg
parsing, production and editing. The capabilities of the hogg commandline
tool are roughly on par with those of the oggz* [0] tools.
HOgg supports chained and multiplexed Ogg bitstreams conformant with
RFC3533[1]. HOgg can parse headers for CELT, CMML, FLAC, OggPCM, Speex, Theora
and Vorbis media codecs, and can read and write Ogg Skeleton bitstreams.
[0] Oggz: http://www.annodex.net/software/liboggz/index.html
[1] RFC3533: http://www.ietf.org/rfc/rfc3533.txt
New in this release
-------------------
This release introduces no functionality changes. Build warnings have been
removed, and the hogg.cabal file has been updated to point to the new git
repository at github.com/kfish/hogg.
Hackage Installation
--------------------
HOgg is in Hackage, at:
http://hackage.haskell.org/cgi-bin/hackage-scripts/package/hogg-0.4.1.1
If you have the Hackage "cabal" system installed, simply run:
$ cabal update
$ cabal install hogg
Source Tarball Installation
---------------------------
I am very interested in hearing about problems with building or installing
the package, particularly from people who are not yet familiar with building
from Haskell source. You need ghc instead of gcc; it compiles to a binary:
$ cabal configure
$ cabal build
$ cabal install
(A ./Setup.hs is also included, which may be used in place of the
"cabal"
command if that not present).
Building of this release has been tested with:
* GHC versions 6.12.1, 6.12.3, 7.0.3, 7.2.1 [2]
* The Haskell build system "Cabal" version 1.8.0.2 [3]
The GHC and Cabal versions listed above span the packages available in most
current distributions. I've tested on Ubuntu 10.04. I'm particularly
interested
to hear reports of build success or failure on other distributions or operating
systems.
[2] GHC: http://www.haskell.org/ghc/
[3] Cabal: http://www.haskell.org/cabal/
Usage
-----
$ hogg help
Usage: hogg <subcommand> [options] filename ...
hogg is a commandline tool for manipulating Ogg files. It supports chained
and multiplexed files conformant with RFC3533. Hogg can parse headers for
CELT, CMML, FLAC, PCM, Speex, Theora and Vorbis, and can read and write Ogg
Skeleton logical bitstreams.
Commands:
help Display help for a specific subcommand (eg. "hogg help
chop")
man Generate Unix man page for a specific subcommand (eg.
"hogg man chop")
Reporting:
info Display information about the specified files and
their bitstreams
dump Hexdump packets of an Ogg file
pagedump Display page structure of an Ogg file
dumpraw Dump raw (unparsed) page data
Extraction:
rip Rip selected logical bistreams from an Ogg file (default: all)
reconstruct Reconstruct an Ogg file by doing a full packet demux
Editing:
chop Extract a section (specify start and/or end time)
merge Merge, interleaving pages in order of presentation time
sort Rewrite with correct page ordering
addskel Write a Skeleton logical bitstream
Miscellaneous:
known-codecs List codecs known by this version of hogg
Please report bugs to <ogg-dev at xiph.org>
New subcommand man
------------------
$ hogg help man
man: Generate Unix man page for a specific subcommand (eg. "hogg man
chop")
Usage: hogg man [options]
Examples:
Generate a man page for the "hogg chop" subcommand:
hogg man chop
Options:
-h, -? --help Display this help and exit
-V --version Output version information and exit
$ hogg man man
.TH HOGG 1 "December 2008" "hogg" "Annodex"
.SH SYNOPSIS
.B hogg
.RI man
...
Source
------
Source code is available from the git repository at:
git clone git://github.com/kfish/hogg.git
Tarballs are available from:
http://www.kfish.org/~conrad/software/hogg/
cheers,
Conrad.
