2/11/2016

Install and configure Linphone | OpenMCU

OpenMCUru

Wiki

(download)

GitHub

Donate

...

InstallandconfigureLinphone

InstallandconfigureLinphone
LinphoneisSIPcompliantsoftwareterminalforaudio/videocalls.Officialwebsite:
http://www.linphone.org/[http://www.linphone.org/]
Linphoneisfreesoftware,licensedundertheGPL.
ThisarticlecontainsinstructionsforsettingLinphoneforusewithOpenMCUru.AllthisappliestotheLinphoneversion3.6.1.Butmaybeappropriate
forotherversions.

Install
Linux
LinphoneispresentintherepositoriesofmanyLinuxdistributions.Itsinstallationcanbeperformedbypackagemanagers.

Ubuntu
InDebian/UbuntuyoucanalsoinstallLinphonefromtheofficialrepository.Butthereisnotthemostcurrentversionintherepository(egcurrentlythe
officialrepositorieshasnoVP8codec),andmoreoverversionintherepositoryisincomplete(absentsomepackages,inparticularthereisnox264
plugin).Therefore,itisrecommendedtoinstallinUbuntufromPPA.
ToinstalllatestLinphoneinUbuntu12.04'Precise'andaboveuseOfficialPPA[https://launchpad.net/~linphone/+archive/release]:
s
u
d
oa
d
d
a
p
t
r
e
p
o
s
i
t
o
r
yp
p
a
:
l
i
n
p
h
o
n
e
/
r
e
l
e
a
s
e
s
u
d
oa
p
t
g
e
tu
p
d
a
t
e
s
u
d
oa
p
t
g
e
ti
n
s
t
a
l
ll
i
n
p
h
o
n
e

DevelopmentPPA[https://launchpad.net/~rayanayar/+archive/linphone]:
s
u
d
oa
d
d
a
p
t
r
e
p
o
s
i
t
o
r
yp
p
a
:
r
a
y
a
n
a
y
a
r
/
l
i
n
p
h
o
n
e
s
u
d
oa
p
t
g
e
tu
p
d
a
t
e
s
u
d
oa
p
t
g
e
ti
n
s
t
a
l
ll
i
n
p
h
o
n
e

DebianSqueeze
ToinstalllatestLinphoneinDebianSqueezefirstmustbeenabledsqueezebackports[http://backports.debian.org/Instructions/]repository.Whenit
enabled,installusingthesecommands:
w
g
e
th
t
t
p
:
/
/
o
p
e
n
m
c
u
.
r
u
/
p
u
b
l
i
c
/
l
i
n
p
h
o
n
e
/
o
p
e
n
m
c
u
r
u
l
i
n
p
h
o
n
e
.
a
s
cO-|a
p
t
k
e
ya
d
de
c
h
o"
d
e
bh
t
t
p
:
/
/
o
p
e
n
m
c
u
.
r
u
/
p
u
b
l
i
c
/
l
i
n
p
h
o
n
e
/s
q
u
e
e
z
em
a
i
n
">/
e
t
c
/
a
p
t
/
s
o
u
r
c
e
s
.
l
i
s
t
.
d
/
o
p
e
n
m
c
u
r
u
l
i
n
p
h
o
n
e
.
l
i
s
t
a
p
t
g
e
tu
p
d
a
t
e
a
p
t
g
e
ti
n
s
t
a
l
ll
i
n
p
h
o
n
e

AvailableLinphone:3.8.3,3.8.2,3.8.1,3.7.0.

DebianWheezy
ToinstalllatestLinphoneinDebianWheezy:
w
g
e
th
t
t
p
:
/
/
o
p
e
n
m
c
u
.
r
u
/
p
u
b
l
i
c
/
l
i
n
p
h
o
n
e
/
o
p
e
n
m
c
u
r
u
l
i
n
p
h
o
n
e
.
a
s
cO-|a
p
t
k
e
ya
d
de
c
h
o"
d
e
bh
t
t
p
:
/
/
o
p
e
n
m
c
u
.
r
u
/
p
u
b
l
i
c
/
l
i
n
p
h
o
n
e
/w
h
e
e
z
ym
a
i
n
">/
e
t
c
/
a
p
t
/
s
o
u
r
c
e
s
.
l
i
s
t
.
d
/
o
p
e
n
m
c
u
r
u
l
i
n
p
h
o
n
e
.
l
i
s
t
a
p
t
g
e
tu
p
d
a
t
e
a
p
t
g
e
ti
n
s
t
a
l
ll
i
n
p
h
o
n
e

AvailableLinphone:3.9.0,3.8.3,3.8.2,3.8.1,3.7.0.

DebianJessie
ToinstalllatestLinphoneinDebianJessie:
w
g
e
th
t
t
p
:
/
/
o
p
e
n
m
c
u
.
r
u
/
p
u
b
l
i
c
/
l
i
n
p
h
o
n
e
/
o
p
e
n
m
c
u
r
u
l
i
n
p
h
o
n
e
.
a
s
cO-|a
p
t
k
e
ya
d
de
c
h
o"
d
e
bh
t
t
p
:
/
/
o
p
e
n
m
c
u
.
r
u
/
p
u
b
l
i
c
/
l
i
n
p
h
o
n
e
/j
e
s
s
i
em
a
i
n
">/
e
t
c
/
a
p
t
/
s
o
u
r
c
e
s
.
l
i
s
t
.
d
/
o
p
e
n
m
c
u
r
u
l
i
n
p
h
o
n
e
.
l
i
s
t
a
p
t
g
e
tu
p
d
a
t
e
a
p
t
g
e
ti
n
s
t
a
l
ll
i
n
p
h
o
n
e

AvailableLinphone:3.9.0,3.8.3,3.8.2,3.8.1.

OtherOS
Linphoneversionforotheroperationsystems(Windows,MacOS,Android,Blackberry,iOS)canbedownloadedfromofficialsite
[http://www.linphone.org/eng/download/].

Initialconfiguration

http://openmcu.ru/wiki/en/terminals/linphone

1/5

2/11/2016

Install and configure Linphone | OpenMCU

ItisrecommendedtodisableLinphoneshowyourvideo,otherwiseownvideoimagewilloverrideOpenMCUruvideo.Turnoffthesecondcheckbox.

Networksettings

Incaseofcomplexnetworkconfiguration,forexamplewhenusingVPN,youmayneedtospecifyatwhataddressLinphoneacceptconnections.This
addressshouldbespecifiedinthePublicIPaddressandmustbeenabledtheappropriateitemBehindNAT/Firewall(specifygatewayIP).See
thescreenshot.
OtheroptionsonthepageNetworkSettingsshouldbechangedonlyifyouunderstandtheirpurpose.

Multimediasettings

http://openmcu.ru/wiki/en/terminals/linphone

2/5

2/11/2016

Install and configure Linphone | OpenMCU

Onthistab,youcan:
enable/disableechocancellation
selectavideocapturedevice(webcam)
specifythepreferredresolutionforcaptureandsendvideo.

ManageSIPaccounts

IfLinphoneisusedonlytoconnecttoOpenMCUru,thenSIPaccountisnotneeded.However,ifthereisnoSIPaccountLinphonewillopen
AccountWizardontheeachstart.Youcanspecifyanyfakeaccountwithlocalhost,thenLinphonewillfallbehind.

Codecs

http://openmcu.ru/wiki/en/terminals/linphone

3/5

2/11/2016

Install and configure Linphone | OpenMCU

Onthecodecspagecanbeconfiguredbandwidth.Incaseofcommunicationproblemsitisencouragedtotrytodisableautomaticbitrate(disablethe
checkboxEnableadaptiveratecontrol)andsetthebitratelimit.Subjectiveobservationsindicatethatyoushouldnotsetmorethan75%ofthe
widthoftheInternetchannel.

VP8
ForVP8codecintheparameterslinemustbespecifiedthepreferredresolutionintheformat:
w
i
d
t
h
=
7
0
4
;
h
e
i
g
h
t
=
5
7
6

IfnothingisspecifieddefaultstoVP8CIF.Ifyouspecifyegwidth=320height=240willbeVP8CIFresolution320240.

H264
H264codecbydefaultalsodoesnotworkhigherthanCIF.Tomakeavailablelargerresolutionsmustbesettheappropriateprofile:
p
r
o
f
i
l
e
l
e
v
e
l
i
d
=
4
2
8
0
X
X

whereXXisprofilecodeinhexdecimalformat(detailsarehere[http://en.wikipedia.org/wiki/H.264/MPEG4_AVC#Levels]andhere
[http://tools.ietf.org/html/rfc6184]).Belowisatablewithafewreadyoptions:
profilelevelid hex dec level

maxresolution

428014

14

20

2.0

352288

42801E

1E

30

3.0

720576

42801F

1F

31

3.1

1280720

428028

28

40

4.0

19201080,20481024

H263+andH263
CodecsH263+(alsocalledH263porH2631998)andH263areconfiguredidentically.Toenablethemtoresolution4CIFmustbeaddedtothe
parameterslineCIF4=1(exactly,butnot4CIF=1).Asaresult,shouldgetaline:
C
I
F
4
=
1
;
C
I
F
=
1
;
Q
C
I
F
=
1

Echocancellation
Mainarticle:Echocancellation.
EchocancelingsettingslocatedonthepageMultimediasettings(seeabove).Thereisacheckboxforon/offechocancellation.Whentheecho
cancellationisonsoundisalittlequieter,but(theoretically)echoshouldbesuppressed.Thisfunctiondoesnotalwaysworkwell.Whenusing
speakersechocanbeveryloud.Inthiscase,youcanusetheheadsetandturnoffechocancellation.

Troubleshooting

http://openmcu.ru/wiki/en/terminals/linphone

4/5

2/11/2016

Install and configure Linphone | OpenMCU

ForsolvingvariousproblemswithLinphoneyoumayneedthedebugoutput.ToshowityouneedtoopenDebugwindow:menuHelpShow
debugwindow.
Exactlythesameoutput(andevenalittlemoreinformative)canbeobtainedfromtheconsoleifyoustartLinphonewithparameter:
l
i
n
p
h
o
n
ev
e
r
b
o
s
e

Seealso
Supportedterminals

ubuntu.ru

http://openmcu.ru/wiki/en/terminals/linphone

MediaManager

5/5