2008-05-13 21:53:31 +02:00
|
|
|
vgmstream
|
|
|
|
|
|
|
|
|
|
This is vgmstream, a library for playing streamed audio from video games.
|
2008-07-05 13:49:29 +02:00
|
|
|
It is very much under development. There are two end-user bits: a command
|
2008-12-19 08:26:38 +01:00
|
|
|
line decoder called "test", and a Winamp plugin called "in_vgmstream".
|
2008-05-13 21:53:31 +02:00
|
|
|
|
2008-12-19 08:26:38 +01:00
|
|
|
*********** IMPORTANT!! ***********
|
2008-06-15 10:00:11 +02:00
|
|
|
--- needed files (for Windows) ---
|
2008-07-05 13:49:29 +02:00
|
|
|
Since Ogg Vorbis and MPEG audio are now supported, you will need to have
|
|
|
|
|
libvorbis.dll and libmpg123-0.dll.
|
2009-01-21 13:51:33 +01:00
|
|
|
You can get these from http://hcs64.com/files/vgmstream_external_dlls.zip
|
2008-06-15 10:00:11 +02:00
|
|
|
|
2009-01-21 13:51:33 +01:00
|
|
|
Put libvorbis.dll and libmpg123-0.dll somewhere Windows can find them.
|
|
|
|
|
For in_vgmstream this means in the directory with winamp.exe, or in a
|
2008-07-05 13:49:29 +02:00
|
|
|
system directory. For test.exe this means in the same directory as test.exe,
|
|
|
|
|
or in a system directory.
|
2008-06-15 10:00:11 +02:00
|
|
|
|
|
|
|
|
--- test.exe ---
|
2008-12-19 08:26:38 +01:00
|
|
|
Usage: ./test [-o outfile.wav] [-l loop count]
|
|
|
|
|
[-f fade time] [-d fade delay] [-ipcmxeE] infile
|
2008-05-13 21:53:31 +02:00
|
|
|
Options:
|
|
|
|
|
-o outfile.wav: name of output .wav file, default is dump.wav
|
|
|
|
|
-l loop count: loop count, default 2.0
|
|
|
|
|
-f fade time: fade time (seconds), default 10.0
|
2008-05-16 22:57:19 +02:00
|
|
|
-d fade delay: fade delay (seconds, default 0.0
|
2008-05-13 21:53:31 +02:00
|
|
|
-i: ignore looping information and play the whole stream once
|
|
|
|
|
-p: output to stdout (for piping into another program)
|
|
|
|
|
-P: output to stdout even if stdout is a terminal
|
|
|
|
|
-c: loop forever (continuously)
|
|
|
|
|
-m: print metadata only, don't decode
|
|
|
|
|
-x: decode and print adxencd command line to encode as ADX
|
2008-12-19 08:26:38 +01:00
|
|
|
-g: decode and print oggenc command line to encode as OGG
|
2008-05-13 21:53:31 +02:00
|
|
|
-e: force end-to-end looping
|
|
|
|
|
-E: force end-to-end looping even if file has real loop points
|
2008-07-12 17:38:05 +02:00
|
|
|
-r outfile2.wav: output a second time after resetting
|
2008-05-13 21:53:31 +02:00
|
|
|
|
|
|
|
|
Typical usage would be:
|
|
|
|
|
test -o happy.wav happy.adx
|
|
|
|
|
to decode happy.adx to happy.wav.
|
|
|
|
|
|
|
|
|
|
--- in_vgmstream ---
|
2008-12-19 08:26:38 +01:00
|
|
|
Drop the in_vgmstream.dll in your Winamp plugins directory. Please follow
|
|
|
|
|
the above instructions for installing the other files needed.
|
2008-05-13 21:53:31 +02:00
|
|
|
|
2008-12-19 08:26:38 +01:00
|
|
|
--- File types supported by this version of vgmstream ---
|
|
|
|
|
|
|
|
|
|
As manakoAT likes to say, the extension doesn't really mean anything, but it's
|
|
|
|
|
the most obvious way to identify files.
|
|
|
|
|
|
|
|
|
|
PS2/PSX ADPCM:
|
|
|
|
|
- .ads/.ss2
|
|
|
|
|
- .ass
|
|
|
|
|
- .bg00
|
|
|
|
|
- .bmdx
|
|
|
|
|
- .ccc
|
|
|
|
|
- .cnk
|
|
|
|
|
- .dxh
|
|
|
|
|
- .enth
|
|
|
|
|
- .fag
|
|
|
|
|
- .filp
|
|
|
|
|
- .gms
|
|
|
|
|
- .hgc1
|
|
|
|
|
- .ikm
|
|
|
|
|
- .ild
|
|
|
|
|
- .ivb
|
|
|
|
|
- .joe
|
|
|
|
|
- .kces
|
|
|
|
|
- .leg
|
|
|
|
|
- .mib, .mi4 (w/ or w/o .mih)
|
|
|
|
|
- .mic
|
|
|
|
|
- .mihb (merged mih+mib)
|
|
|
|
|
- .msvp
|
|
|
|
|
- .musc
|
|
|
|
|
- .musx
|
|
|
|
|
- .npsf
|
|
|
|
|
- .pnb
|
|
|
|
|
- .psh
|
|
|
|
|
- .rkv
|
|
|
|
|
- .rnd
|
|
|
|
|
- .rstm
|
|
|
|
|
- .rws
|
|
|
|
|
- .rxw
|
|
|
|
|
- .seg
|
|
|
|
|
- .sfs
|
|
|
|
|
- .sl3
|
|
|
|
|
- .str+.sth
|
|
|
|
|
- .sts
|
|
|
|
|
- .svag
|
|
|
|
|
- .svs
|
|
|
|
|
- .tec (w/ bad flags)
|
|
|
|
|
- .vas
|
|
|
|
|
- .vag
|
|
|
|
|
- .vgs (w/ bad flags)
|
|
|
|
|
- .vig
|
|
|
|
|
- .vpk
|
|
|
|
|
- .vs
|
|
|
|
|
- .wp2
|
|
|
|
|
- .xa2
|
|
|
|
|
- .xa30
|
|
|
|
|
|
|
|
|
|
GC/Wii DSP ADPCM:
|
|
|
|
|
- .agsc
|
|
|
|
|
- .amts
|
|
|
|
|
- .asr
|
|
|
|
|
- .cfn
|
|
|
|
|
- .dsp
|
2008-05-13 21:53:31 +02:00
|
|
|
- standard, with dual file stereo
|
|
|
|
|
- RS03
|
|
|
|
|
- Cstr
|
2008-05-16 00:06:33 +02:00
|
|
|
- _lr.dsp
|
2008-12-19 08:26:38 +01:00
|
|
|
- .gca
|
|
|
|
|
- .gcm
|
|
|
|
|
- .gsp+.gsp
|
|
|
|
|
- .hps
|
|
|
|
|
- .idsp
|
|
|
|
|
- .ish+.isd
|
|
|
|
|
- .mpdsp
|
|
|
|
|
- .mss
|
|
|
|
|
- .mus (not quite right)
|
|
|
|
|
- .pdt
|
|
|
|
|
- .sdt
|
|
|
|
|
- .smp
|
|
|
|
|
- .spt+.spd
|
|
|
|
|
- .ssm
|
|
|
|
|
- .stm/.dsp
|
|
|
|
|
- .str
|
|
|
|
|
- .sts
|
|
|
|
|
- .swd
|
|
|
|
|
- .thp, .dsp
|
|
|
|
|
- .tydsp
|
|
|
|
|
- .vjdsp
|
|
|
|
|
- .waa, .wac, .wad, .wam
|
|
|
|
|
- .wsi
|
|
|
|
|
- .ydsp
|
|
|
|
|
- .ymf
|
|
|
|
|
- .zwdsp
|
|
|
|
|
|
|
|
|
|
PCM:
|
|
|
|
|
- .aiff (8 bit, 16 bit)
|
|
|
|
|
- .asd (16 bit)
|
|
|
|
|
- .bh2pcm (16 bit)
|
|
|
|
|
- .gcsw (16 bit)
|
|
|
|
|
- .gcw (16 bit)
|
|
|
|
|
- .int (16 bit)
|
|
|
|
|
- .pcm (8 bit, 16 bit)
|
|
|
|
|
- .kraw (16 bit)
|
|
|
|
|
- .raw (16 bit)
|
|
|
|
|
- .rwx (16 bit)
|
|
|
|
|
- .sap (16 bit)
|
|
|
|
|
- .str (16 bit)
|
|
|
|
|
- .wav, .lwav (unsigned 8 bit, 16 bit)
|
|
|
|
|
- .xss (16 bit)
|
|
|
|
|
|
|
|
|
|
Xbox IMA ADPCM:
|
|
|
|
|
- .matx (XBOX IMA ADPCM)
|
2008-06-09 02:50:52 +02:00
|
|
|
- .wavm (XBOX IMA ADPCM)
|
2008-12-19 08:26:38 +01:00
|
|
|
- .wvs (XBOX IMA ADPCM)
|
|
|
|
|
- .xmu (Xbox IMA ADPCM)
|
|
|
|
|
- .xvas (Xbox IMA ADPCM)
|
2008-06-09 02:50:52 +02:00
|
|
|
- .xwav (XBOX IMA ADPCM)
|
2008-12-19 08:26:38 +01:00
|
|
|
|
|
|
|
|
Yamaha ADPCM:
|
|
|
|
|
- .dcs+.wav (Yamaha ADPCM)
|
|
|
|
|
- .str (Yamaha ADPCM)
|
|
|
|
|
- .spsd (Yamaha ADPCM)
|
|
|
|
|
|
|
|
|
|
DVI IMA ADPCM:
|
|
|
|
|
- .dvi (DVI IMA ADPCM)
|
|
|
|
|
- .idvi (DVI IMA ADPCM)
|
|
|
|
|
- .stma (DVI IMA ADPCM)
|
|
|
|
|
|
|
|
|
|
multi:
|
2008-07-02 03:48:16 +02:00
|
|
|
- .aifc (SDX2 DPCM, DVI IMA ADPCM)
|
2008-12-19 08:26:38 +01:00
|
|
|
- .asf, .as4 (8/16 bit PCM, EACS IMA ADPCM)
|
|
|
|
|
- .ast (GC AFC ADPCM, 16 bit PCM)
|
2008-07-04 02:15:50 +02:00
|
|
|
- .aud (IMA ADPCM, WS DPCM)
|
2008-12-19 08:26:38 +01:00
|
|
|
- .aus (PSX ADPCM, Xbox IMA ADPCM)
|
|
|
|
|
- .brstm (GC DSP ADPCM, 8/16 bit PCM)
|
|
|
|
|
- .emff (PSX APDCM, GC DSP ADPCM)
|
|
|
|
|
- .fsb (PSX ADPCM, GC DSP ADPCM, Xbox IMA ADPCM)
|
|
|
|
|
- .genh (lots)
|
2008-08-03 16:58:03 +02:00
|
|
|
- .nwa (16 bit PCM, NWA DPCM)
|
2008-12-19 08:26:38 +01:00
|
|
|
- .psw (PSX ADPCM, GC DSP ADPCM)
|
2009-01-20 02:03:33 +01:00
|
|
|
- .rwar,.rwav (GC DSP ADPCM, 8/16 bit PCM)
|
2008-12-19 08:26:38 +01:00
|
|
|
- .rwsd (GC DSP ADPCM, 8/16 bit PCM)
|
|
|
|
|
- .rsd (PSX ADPCM, 16 bit PCM, GC DSP ADPCM, Xbox IMA ADPCM)
|
2008-12-28 07:29:43 +01:00
|
|
|
- .sad (GC DSP ADPCM, NDS IMA ADPCM, Procyon Studios NDS ADPCM)
|
2008-12-19 08:26:38 +01:00
|
|
|
- .sng, .asf, .str, .eam (EA/XA ADPCM or PSX ADPCM)
|
|
|
|
|
- .strm (STRM: NDS IMA ADPCM, 8/16 bit PCM)
|
|
|
|
|
- .ss7 (EACS IMA ADPCM, IMA ADPCM)
|
|
|
|
|
- .xwb (16 bit PCM, Xbox IMA ADPCM)
|
|
|
|
|
|
|
|
|
|
etc:
|
2009-01-03 14:23:51 +01:00
|
|
|
- .aax (CRI ADX ADPCM)
|
2008-07-20 09:28:17 +02:00
|
|
|
- .acm (InterPlay ACM)
|
2008-12-19 08:26:38 +01:00
|
|
|
- .adp (GC DTK ADPCM)
|
|
|
|
|
- .adx (CRI ADX ADPCM)
|
|
|
|
|
- .afc (GC AFC ADPCM)
|
|
|
|
|
- .ahx (MPEG-2 Layer II)
|
2008-08-02 12:48:46 +02:00
|
|
|
- .aix (CRI ADX ADPCM)
|
2008-12-19 08:26:38 +01:00
|
|
|
- .bgw (FFXI PS-like ADPCM)
|
2008-08-11 10:31:51 +02:00
|
|
|
- .de2 (MS ADPCM)
|
2008-12-19 08:26:38 +01:00
|
|
|
- .kcey (EACS IMA ADPCM)
|
2009-01-04 16:36:06 +01:00
|
|
|
- .mwv (Level-5 0x555 ADPCM)
|
2008-12-19 08:26:38 +01:00
|
|
|
- .ogg, .logg (Ogg Vorbis)
|
|
|
|
|
- .rsf (CCITT G.721 ADPCM)
|
|
|
|
|
- .spw (FFXI PS-like ADPCM)
|
|
|
|
|
- .str (SDX2 DPCM)
|
|
|
|
|
- .um3 (Ogg Vorbis)
|
|
|
|
|
- .xa (CD-ROM XA audio)
|
|
|
|
|
|
|
|
|
|
loop assists:
|
|
|
|
|
- .mus (playlist for .acm)
|
|
|
|
|
- .pos (loop info for .wav)
|
|
|
|
|
- .sli (loop info for .ogg)
|
|
|
|
|
- .sfl (loop info for .ogg)
|
2008-05-13 21:53:31 +02:00
|
|
|
|
|
|
|
|
Enjoy!
|
|
|
|
|
-hcs
|
