README 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. This is a prototype codec and for now it has limited functionality.
  2. To build from a distribution tarball, you only need to do the following:
  3. % ./configure
  4. % make
  5. To build from the git repository, the following steps are necessary:
  6. 1) Clone the repository:
  7. % git clone git://git.opus-codec.org/opus.git
  8. % cd opus
  9. 1) Compiling
  10. % ./autogen.sh
  11. % ./configure
  12. % make
  13. Once you have compiled the codec, there will be a test_opus executable in
  14. the top directory.
  15. Usage: test_opus [-e] <application> <sampling rate (Hz)> <channels (1/2)>
  16. <bits per second> [options] <input> <output>
  17. test_opus -d <sampling rate (Hz)> <channels (1/2)> [options]
  18. <input> <output>
  19. mode: voip | audio | restricted-lowdelay
  20. options:
  21. -e : only runs the encoder (output the bit-stream)
  22. -d : only runs the decoder (reads the bit-stream as input)
  23. -cbr : enable constant bitrate; default: variable bitrate
  24. -cvbr : enable constrained variable bitrate; default:
  25. -unconstrained
  26. -bandwidth <NB|MB|WB|SWB|FB> : audio bandwidth (from narrowband to fullband);
  27. default: sampling rate
  28. -framesize <2.5|5|10|20|40|60> : frame size in ms; default: 20
  29. -max_payload <bytes> : maximum payload size in bytes, default: 1024
  30. -complexity <comp> : complexity, 0 (lowest) ... 10 (highest); default: 10
  31. -inbandfec : enable SILK inband FEC
  32. -forcemono : force mono encoding, even for stereo input
  33. -dtx : enable SILK DTX
  34. -loss <perc> : simulate packet loss, in percent (0-100); default: 0
  35. input and output are 16-bit PCM files (machine endian) or opus bitstreams
  36. with simple test_opus propritary framing.