Libgami is a cross-platform library for connections to the asterisk manager interface based on GObject and glib. It may be used from any application using the glib main loop (either directly or through libraries like GTK+ or Qt).

Being based on GLib, libgami allows development for multiple platform environments, in contrast to the .NET Technology-dependent AMIConnector. Its use of the C language makes it a more complex choice, providing the benefit of a unified development environment across multiple platforms.

Version compatibility

The library has been tested with both version 1.4 and 1.6 of asterisk. While it achieves to hide some differences between versions, there are other cases where the correct handling of incompatibilities remains the responsibility of the application developer.

It proves an abstraction for

• differing parameters
• additional event classes
• changes of response formats

It does not

• try to determine which actions actually are present on the server - in fact, some version number still is no guarantee for the availability of a certain action - it might be disabled in the manager configuration file or be provided from some external module, or the user may lack the privileges to perform certain actions.
• provide any mappings for name / field changes in event packets

Documentation

The complete API documentation is included with the package and is avaiable for online viewing.

Language bindings

Libgami integrates with GObject-Introspection, which should allow for automatically generated language bindings using

• PyBank for Python
  
• GTK2-Perl/Introspection for Perl
• JGIR for Java
• Gjs or Seed for JavaScript
• Vala

Mono bindings for C# and .NET are possible, although there won't be any libgami-sharp package until the API stabilizes.

Completeness

While libgami aims at providing complete support for the asterisk manager api, there are a few actions missing, mostly due to API inconsistencies and/or unclean action behavior. The following is a complete list of missing actions:

• QueueRule
• QueueStatus
• Queues
• IAXnetstats
• IAXpeers
• ShowDialPlan
• UpdateConfig
• Command

Downloads

Binary packages for Debian

 Libgami binary package for Debian i386

 Libgami development package for Debian i386

 Libgami documentation package for Debian

Binary packages for Windows

 Libgami binary package for Windows32

 Libgami development package for Windows32

Source code

  Libgami source package