README 4.22 KB
Newer Older
1
COPYRIGHT NOTICE
2

3
Copyright (C) 2004, 2005, 2006, 2008, 2009, 2010 Savoir-Faire Linux Inc.
4

5
This program is free software: you can redistribute it and/or modify
6
it under the terms of the GNU General Public License as published by
7
the Free Software Foundation, either version 3 of the License, or
8 9 10 11 12 13 14 15
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
16 17 18 19 20 21 22 23 24 25 26 27
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Additional permission under GNU GPL version 3 section 7:

If you modify this program, or any covered work, by linking or
combining it with the OpenSSL project's OpenSSL library (or a
modified version of that library), containing parts covered by the
terms of the OpenSSL or SSLeay licenses, Savoir-Faire Linux Inc.
grants you additional permission to convey the resulting work.
Corresponding Source for a non-source form of such a combination
shall include the source code for the parts of OpenSSL used as well
as that of the covered work.
28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76


Introduction
------------

SFLPhone is a Voice-over-IP software phone. We want it to be:
- user friendly (fast, sleek, easy to learn interface)
- corporate grade (transfers, holds, perfect audio quality)
- fully compatible with Asterisk (SIP and IAX protocols)
- customizable 

As the SIP/audio daemon and the user interface are separate processes,
it is easy to provide different user interfaces. SFLPhone0.8 comes with
a GTK graphical user interface, an interactive command line interface,
and even scripts to control the daemon from the shell.

SFLPhone is actually used by the support team of Savoir-Faire Linux Inc.

More information is available on the project homepage:
  http://www.sflphone.org/

 
Short description of content of source tree
-------------------------------------------

- ringtones/ contains the different ringtones.
- stund/ is an implementation of the protocol STUN used when there is a NAT.
- utilspp/ allows to implement a singleton.
- src/ is the core of SFLphone. It contains the main.cpp, managerimpl.cpp
  files, audio and gui directories, and files about signalisation SIP. Later,
  it should be better, when IAX will be implemented, that a directory groups
  these protocols. 
  The ManagerImpl class is the intermediaire between all the layer in the tree.
- src/audio/ is the audio layer. It contains all about tones, dtmf,
  audiodriver, rtp layer, audio codec ulaw, alaw and gsm.
- src/dbus, the dbus xml interfaces, and c++ bindings


About Savoir-Faire Linux
------------------------

Savoir-Faire Linux is a consulting company based in Montreal, Quebec.
For more information, please check out our website:
http://www.savoirfairelinux.com/

How to compile
--------------

# First compile the SIP library
77 78
cd libs/pjproject-1.0.3
./autogen.sh
79
./configure --disable-ilbc-codec && make clean && make dep && make
80 81
sudo make install

82 83 84 85 86 87 88 89 90 91
If you already have installed a different version of 
pjsip on your system, you will most likely have some errors
such as :

"ln: creating symbolic link `./libpjsip-sfl.a': File exists"

after executing make install.

Simply remove those files and run "make install" again.

92 93 94 95 96 97
# Then the daemon
cd ../..
./autogen.sh --prefix=/usr --with-debug
make
sudo make install

98 99
# And the GNOME client
cd sflphone-client-gnome
100 101 102 103 104 105
./autogen.sh --prefix=/usr --with-debug
make
sudo make install

 Done !

106 107 108 109 110 111 112 113 114 115 116 117 118 119
Free SIP/IAx2 accounts
---------------------

You may create a free SIP/IAX2 account through the account creation wizard in the both client (KDE and GNOME).
By doing this, you will be able to call other account registered to the same server.
Registered to this kind of account, you will be able to test your headset by dialing *100

ECHO test
--------
Dial *100, on sip.sflphone.org




120 121 122 123 124
Contributing to SFLPhone
------------------------

Of course we love patches. And contributions. And spring rolls.

125
Development website: http://projects.savoirfairelinux.net/wiki/sflphone
126 127 128 129 130

Do not hesitate to join us and post comments, suggestions, questions
and general feedback on the forge.novell mailing-list.

  -- The SFLPhone Team