README 4.71 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


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)
37
- customizable
38
39
40
41
42
43
44
45
46
47
48

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/

49

50
51
52
53
54
55
56
Short description of content of source tree
-------------------------------------------

- ringtones/ contains the different ringtones.
- 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
57
  these protocols.
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
  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
--------------

74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
# Install libav-0.7 and some encoder/decoder librairies
sudo apt-get install libtheora-dev libvpx-dev libmp3lame-dev

# x264 doesn't do releases, so grab the last snapshot of it
wget ftp://ftp.videolan.org/pub/x264/snapshots/last_x264.tar.bz2
tar -jxf last_x264.tar.bz2
cd x264-snapshot...
./configure --enable-shared --enable-pic
make && sudo make install

# get the libav-0.7 release
wget http://libav.org/releases/libav-0.7.tar.gz
tar xzf libav-0.7.tar.gz
cd libav-0.7
./configure --enable-libx264 --enable-gpl --enable-swscale --enable-libvpx --enable-libmp3lame --enable-pic --enable-libtheora
make && sudo make install

91
# Compile the PJSIP library
92
cd libs/pjproject
93

Emmanuel Milou's avatar
Emmanuel Milou committed
94
./autogen.sh
95
./configure --disable-ilbc-codec && make clean && make dep && make
96
97
sudo make install

98
If you already have installed a different version of
99
100
101
102
103
104
105
106
107
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.

108
109
110
111
112
113
# Then the daemon
cd ../..
./autogen.sh --prefix=/usr --with-debug
make
sudo make install

Emmanuel Milou's avatar
Emmanuel Milou committed
114
115
# And the GNOME client
cd sflphone-client-gnome
116
117
118
119
120
121
./autogen.sh --prefix=/usr --with-debug
make
sudo make install

 Done !

Emmanuel Milou's avatar
Emmanuel Milou committed
122
123
124
125
126
127
128
129
130
131
132
133
134
135
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




136
137
138
139
140
Contributing to SFLPhone
------------------------

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

Emmanuel Milou's avatar
Emmanuel Milou committed
141
Development website: http://projects.savoirfairelinux.net/wiki/sflphone
142
143
144
145
146

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

  -- The SFLPhone Team