Skip to content
Newer
Older
100644 94 lines (57 sloc) 2.79 KB
0688a68 @kfish add README
authored
1 ------------------------------------------------------------
2 HOgg -- Ogg encapsulation stuffz
3 ------------------------------------------------------------
4
5 Requirements:
414d052 @kfish Release 0.4.1
authored
6 - Cabal (tested with various version from 1.1.3 to 1.6.0)
6c72db7 @kfish update cabal and README with info for GHC6.8 (but default to 6.6)
authored
7
8 - Data.ByteString, included with GHC >= 6.6, and available separately
9 for GHC 6.4 at:
10 http://www.cse.unsw.edu.au/~dons/fps.html (version 0.7 or greater)
fa69715 @kfish clarify required libraries in README
authored
11
a76425b @gwern README: update for flags business
gwern authored
12 If building on Debian GNU/Linux:
fa69715 @kfish clarify required libraries in README
authored
13 $ apt-get install ghc6 libghc6-mtl-dev libghc6-hunit-dev
050004a @kfish Release 0.2.0
authored
14 $ apt-get install libghc6-cabal-dev # not needed for Debian unstable
0688a68 @kfish add README
authored
15
1346e76 @kfish note that HTTP1 support is optional, and point to instructions for en…
authored
16 Optional:
17 - HTTP1 with lazy bytestring support, from:
18 http://www.dtek.chalmers.se/~tox/site/http.php4
19 To configure with HTTP support, first install the above library, then
a76425b @gwern README: update for flags business
gwern authored
20 go install through Cabal, but run configure like
21
22 $ runhaskell Setup configure --flags="http"
23
1346e76 @kfish note that HTTP1 support is optional, and point to instructions for en…
authored
24
0688a68 @kfish add README
authored
25 Building:
91d0caa @kfish add info about modifying build for GHC6.6
authored
26
a76425b @gwern README: update for flags business
gwern authored
27 This package is configured by default to build with GHC 6.8.
6c72db7 @kfish update cabal and README with info for GHC6.8 (but default to 6.6)
authored
28
a76425b @gwern README: update for flags business
gwern authored
29 If you are building with GHC 6.6, you need to follow the usual Cabal
30 setup but run configure like:
31
32 $ runhaskell Setup configure --flags="-splitBase"
6c72db7 @kfish update cabal and README with info for GHC6.8 (but default to 6.6)
authored
33
34 If you are building with GHC 6.4, you will need to edit hogg.cabal
a76425b @gwern README: update for flags business
gwern authored
35 by adding 'fps' to the Build-Depends line and probably remove the Cabal
36 conditionals. You should consider upgrading to a more recent GHC.
6c72db7 @kfish update cabal and README with info for GHC6.8 (but default to 6.6)
authored
37
38 Once configured, the following procedure will build hogg:
91d0caa @kfish add info about modifying build for GHC6.6
authored
39
a76425b @gwern README: update for flags business
gwern authored
40 $ chmod +x Setup.hs
41 $ ./Setup.hs configure
42 $ ./Setup.hs build
43 $ ./Setup.hs install
0688a68 @kfish add README
authored
44
45 Usage:
a76425b @gwern README: update for flags business
gwern authored
46 General help (lists subcommands):
e273f78 @kfish add help info to README
authored
47
a76425b @gwern README: update for flags business
gwern authored
48 hogg help
e273f78 @kfish add help info to README
authored
49
a76425b @gwern README: update for flags business
gwern authored
50 Help on a subcommand:
e273f78 @kfish add help info to README
authored
51
a76425b @gwern README: update for flags business
gwern authored
52 hogg help <subcommand>
0688a68 @kfish add README
authored
53
33a439d @kfish update README to reflect multiple files, rename rewrite->rip, repacke…
authored
54 Info about the various tracks of one or more files:
55
56 hogg info file1.ogg file2.ogg ...
57
a76425b @gwern README: update for flags business
gwern authored
58 Dump packets of an Ogg file:
0688a68 @kfish add README
authored
59
a76425b @gwern README: update for flags business
gwern authored
60 hogg dump file1.ogg file2.ogg ...
0688a68 @kfish add README
authored
61
a76425b @gwern README: update for flags business
gwern authored
62 Dump pages of an Ogg file
0688a68 @kfish add README
authored
63
a76425b @gwern README: update for flags business
gwern authored
64 hogg pagedump file1.ogg file2.ogg ...
0688a68 @kfish add README
authored
65
a76425b @gwern README: update for flags business
gwern authored
66 Dump vorbis (theora, speex) packets
0688a68 @kfish add README
authored
67
a76425b @gwern README: update for flags business
gwern authored
68 hogg dump -c vorbis file.ogg ...
69 hogg pagedump -c vorbis file.ogg ...
70 hogg dumpraw -c vorbis file.ogg ...
33a439d @kfish update README to reflect multiple files, rename rewrite->rip, repacke…
authored
71
a76425b @gwern README: update for flags business
gwern authored
72 Chop out part of a file
5b2d797 @kfish update README
authored
73
a76425b @gwern README: update for flags business
gwern authored
74 hogg chop --start 01:10 --end 2:30 -o output.ogg file.ogg
5b2d797 @kfish update README
authored
75
33a439d @kfish update README to reflect multiple files, rename rewrite->rip, repacke…
authored
76 Merge
a76425b @gwern README: update for flags business
gwern authored
77
33a439d @kfish update README to reflect multiple files, rename rewrite->rip, repacke…
authored
78 merge pages from many input files and produce a single output file:
79
80 hogg merge -o output.ogg file1.ogg file2.ogg file3.ogg ...
81
0688a68 @kfish add README
authored
82
83 Checking stuff works:
84
a76425b @gwern README: update for flags business
gwern authored
85 Rewrite a file (parse pages, rewrite page data):
0688a68 @kfish add README
authored
86
a76425b @gwern README: update for flags business
gwern authored
87 hogg rip file.ogg > newfile.ogg
88 diff file.ogg newfile.ogg
0688a68 @kfish add README
authored
89
a76425b @gwern README: update for flags business
gwern authored
90 Repacket a file (parse to packets, rewrite with original segmentation):
0688a68 @kfish add README
authored
91
a76425b @gwern README: update for flags business
gwern authored
92 hogg reconstruct file.ogg > newfile.ogg
93 diff file.ogg newfile.ogg
Something went wrong with that request. Please try again.