Asterisk audio conversion module
================================

About
-----

Asterisk_ is a complete PBX in software. It runs on Linux, BSD and MacOSX and provides all of the features you would expect from a PBX and more. Asterisk does voice over IP in many protocols, and can interoperate with almost all standards-based telephony equipment using relatively inexpensive hardware.

Asterisk audio conversion module is a powerful asterisk module that convert audio files from/to any format. The module depends on codec_xxx.so and format_xxx.so for both source and target format. For example, convert from gsm to g729 need codec_gsm.so, codec_g729.so, format_gsm.so and format_g729.so. 

Usage
-----

This module register a CLI named **convert**, Usage:

**convert** <input> <output>
 - input: absolute name of input file
 - output: absolute name of input file

**Example:**

  Asterisk*CLI> convert /tmp/input.gsm /tmp/output.g729

  Asterisk*CLI> convert /tmp/input.gsm /tmp/output.ilbc

  Asterisk*CLI> convert /tmp/input.gsm /tmp/output.g723

Sources
-------

 * Version 0.1: http://redice.krisk.org/res_conv-0.1.tgz

Install
-------
The sample way to install the module is:
 1. download and uncompress the source tar ball.
 2. 'cd' to the directory containing the source code and type 'make AST_HEADER=/where/your/asterisk/header/is/'
 3. Copy res_conv.so to asterisk module directory (/usr/share/asterisk/modules for example).

**Example:**
   
   Bash# wget http://redice.krisk.org/res_conv-0.1.tgz
 
   Bash# tar -zxvf res_conv-0.1.1.tgz
   
   Bash# cd res_conv

   Bash# make AST_HEADER=/usr/src/asterisk/include

   Bash# cp res_conv.so /usr/share/asterisk/modules/

   Bash# asterisk -r

   Asterisk*CLI> load res_conv.so

   Asterisk*CLI> convert /tmp/input.gsm /tmp/output.g729


Bugs report
-----------
Report any bug to `wiki page`_ or `Write to me`_.  

.. _Asterisk: http://www.asterisk.org
.. _Write to me: redice_li@yahoo.com
.. _wiki page: http://www.voip-info.org/wiki/view/Asterisk+audio+convert+module

