Gizmo Project Generic Package
=============================

The generic package was created for 2 reasons, first as a fallback in case
users are not able to install the existing install packages, and second for
those interested in creating their own Gizmo install packages.

1) Running Gizmo from the Generic Package

  - Make sure all of Gizmo's dependencies are satisfied.  If your system
    doesn't provide packages for any of Gizmo's dependencies, then you may be
    able to compile and install them from sources. If installing dependencies
    from sources, make sure not to install them to system paths.  For example,
    if your system is running older versions of GTK+, it would be possible to
    compile GTK+ 2.6.10 (from sources), install to /usr/local/gtk-2.6.10, and
    include /usr/local/gtk-2.6.10/lib in your LD_LIBRARY_PATH. To check if
    gizmo has found the correct version of its dependencies, make sure the
    following command shows the correct path for the dependency you installed:

    $ ldd ./gizmo

    In the above GTK+ example, the output should include:

    libgtk-x11-2.0.so.0 => /usr/local/gtk-2.6.10/libgtk-x11-2.0.so.0

    Please be advised that compiling and installing from sources, requires
    some expertise and is not advised for those who are not familiar with
    doing so.  YOUR SYSTEM COULD AS A RESULT BE RENDERED PARTIALLY OR
    COMPLETELY DISFUNCTIONAL, SO PLEASE DON'T SAY WE DID NOT WARN YOU!!

    Gizmo's dependencies include:

    * GTK+ 2.6 or higher
    * GConf2
    * ALSA (libasound.so.2)
    * libstdc++5

    Note: If you are not comfortable installing Gizmo's dependencies from
    source packages, you could try contacting your distribution maintainers
    and asking them to create a Gizmo install package for their distribution.

  - Once all of Gizmo's dependencies have been satisfied, it is possible to
    run Gizmo directly from the directory it was extracted to. Simply use the
    shell script 'gizmo-run', which will pre-load libsipphoneapi.so and point
    Gizmo to the correct data files location.

2) Creating Gizmo Project install packages

  - If installing Gizmo as follows:
      /usr/local/bin/gizmo
      /usr/local/lib/libsipphoneapi.so
      /usr/local/lib/libsipphoneapi.so.version
      /usr/local/share/gizmo

     You will need to ensure that libsipphoneapi.so is located in the LD
     runtime path, and that gizmo is called with the '--datadir' flag pointing
     to Gizmo's data directory (if not installed at '/usr/share/gizmo').  If
     installed as above, Gizmo would need to be started as follows:

     gizmo --datadir=/usr/local/share/gizmo

If you have any questions or comments please email us at developer@sipphone.com

