|
Size: 5524
Comment: cleaned up grammar and clarity throughout the guide
|
← Revision 121 as of 2018-10-15 09:35:59 ⇥
Size: 4699
Comment: Explain how to do a standard install not just how to install a snapshot
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| Ekiga is the default SIP and H.323 compatible VoIP, IP telephony, and video conferencing softphone application in Ubuntu. It allows you to make audio and video calls over the Internet to remote users with SIP or H.323 hardware and software. It is compatible with Windows Messenger and most VoIP applications, however it is not compatible with Skype or Google Talk. If you have the right SIP provider you can call out to any normal phone line. | #title Ekiga VoIP |
| Line 3: | Line 3: |
| Ekiga features STUN support which allows it to work seamlessly through your router and firewalls. | = Introduction = Ekiga was the default Internet telephony ([[VoIP]]) application/[[SoftPhone]] in Ubuntu until Ubuntu 9.10 (Karmic Koala), when it was replaced by [[Empathy]]. It lets you make audio and video calls over the Internet to people who have hardware or software that follows the [[http://en.wikipedia.org/wiki/Session_Initiation_Protocol|SIP]] or [[http://en.wikipedia.org/wiki/H.323|H.323]] standards. Ekiga also features basic instant messaging. |
| Line 5: | Line 6: |
| attachment:ekiga.png | Ekiga has a robust and wide support for multimedia, and is compatible with [[Windows Messenger]] and most VoIP applications. Ekiga cannot communicate with [[Skype]] because [[Skype]] uses its own non-standard protocols. If you have a suitable [[SIP provider]], you can also use Ekiga to place calls to any normal phone line. |
| Line 7: | Line 8: |
| During installation of Ekiga, it might be necessary to change router settings. | |
| Line 8: | Line 10: |
| == First use == | ||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents(4)>>|| {{attachment:ekiga_3.png}} |
| Line 10: | Line 13: |
| When you start Ekiga for the first time, a 10 step wizard will help you to correctly configure Ekiga. It is '''strongly''' recommended to complete the wizard. | ---- = Desktop interoperability = Ekiga works with Linux or Windows. For Mac OS, you can use the free software [[http://xmeeting.sourceforge.net|xmeeting]]. |
| Line 12: | Line 17: |
| When you're done and if you got an account on http://ekiga.net, you can call the echo test : {{{sip:500@ekiga.net}}}. You'll be able to check if you can reach the service (the SIP network), if your sound setup is ok (you can hear yourself '''with a delay'''), if your webcam works (you can see yourself). | Ekiga is compatible with Netmeeting (H.323, windows), Windows Messenger (SIP, Windows), [[Gizmo]] (SIP, multi-platform), and [[http://wiki.ekiga.org/index.php/Ekiga_Interoperability|other programs listed on the Ekiga documentation]]. |
| Line 14: | Line 19: |
| === How to set up an Ekiga.net account === | ---- = Ekiga.net services (free calls PC-to-PC) = Ekiga.net is a free service (no ads) based upon Free Software ([[http://www.iptel.org/|iptel]] and [[http://www.asterisk.org/|Asterisk]]) ran by the Ekiga team. |
| Line 16: | Line 23: |
| Once you're registered in http://ekiga.net, go to menu {{{Edit -> Accounts -> Add}}} | ---- = Register to a commercial VoIP provider (landline and mobile phones) = You can register to a commercial VoIP provider to place calls to normal phone line or cell phone (POTS). Ekiga allows you to register with several [[Ekiga/VoIPProviders|VoIP providers]]. |
| Line 18: | Line 27: |
| Account name: "ekiga.net” or whatever you wish | * See [[Ekiga/VoIPProviders]] - How to register to a commercial VoIP provider. |
| Line 20: | Line 29: |
| Registrar: {{{ekiga.net}}} | ---- = Configuration = * See [[Ekiga/Configuration]] for help on configuring Ekiga. |
| Line 22: | Line 33: |
| User: Your nick choosen on ekiga.net | ---- = FAQ (Frequently Asked Questions) = * See [[Ekiga/FAQ]] for answers to frequently asked questions about Ekiga. |
| Line 24: | Line 37: |
| Password: You password choosen on ekiga.net | ---- = Install Ekiga = |
| Line 26: | Line 40: |
| == Configuration == | In trusty (14.04) and later, Ekiga is available in the Universe repository. The package name is ''ekiga''. |
| Line 28: | Line 42: |
| === Network === | == Install snapshots from the website == You can get the latest development snapshots from [[http://snapshots.ekiga.net/|snapshots.ekiga.net]]. Installing them may solve problems you are experiencing, but be aware that the snapshots could also cause more problems. This package will replace your actual and stable version. |
| Line 30: | Line 45: |
| Ekiga is able to use STUN, in most cases everything should be fine even behind a NAT. | /* {{attachment:ekiga3_03-19-2008.png}} I don't know why this image is necessary. */ |
| Line 32: | Line 47: |
| === Sound === | == Install snapshots using a repository == |
| Line 34: | Line 49: |
| ==== Test your computer ==== | === Add this GPG key to verify the repository === *Add the key to your key list {{{ $ gpg --keyserver keyserver.ubuntu.com --recv-keys 3596ED6E }}} *Add the key to apt utils {{{ $ gpg --export --armor 3596ED6E | sudo apt-key add - }}} |
| Line 36: | Line 59: |
| To check if your computer meets the requirements for Ekiga, try this command in a terminal : | === Add the repositories === *The Ekiga SVN snapshot repository {{{ deb http://snapshots.ekiga.net/snapshots/ubuntu/ <release> main }}} *The updates repository (official) {{{ deb http://archive.ubuntu.com/ubuntu/ <release>-updates main multiverse }}} |
| Line 38: | Line 69: |
| {{{$ arecord -D plughw:0,0 -c 1 -r 8000 -f S16_LE - | aplay -D plughw:0,0 -c 1 -r 8000 -f S16_LE -}}} | where <release> is the codename of the Ubuntu release used, for example 'natty'. |
| Line 40: | Line 71: |
| Optionally you can add more features installing those packages: *for webcam support using only V4L API: '''libpt-snapshot-plugins-v4l''' *FireWire camera AVC video support: '''libpt-snapshot-plugins-avc''' *FireWire camera DC video support: '''libpt-snapshot-plugins-dc''' *The H264 Video codec: '''libopal-snapshot-plugins-h264''' |
|
| Line 41: | Line 77: |
| Now, try to call in your microphone, you should be able to hear yourself in your headset '''with a small delay''' (aproximatly half a second). If it doesn't work as expected, first try to configure ALSA : | === Install Ekiga Snapshot === *Install the package '''ekiga-snapshot''' |
| Line 43: | Line 80: |
| {{{$ alsamixer}}} | ------ |
| Line 45: | Line 82: |
| Check if your microphone is unmute, if the volum levels are ok,... | = Ekiga Links = Navigate to Ekiga pages at Ubuntu Help |
| Line 47: | Line 85: |
| ==== Ekiga and other audio applications ==== Ekiga is capable of running simultaneously with other sound applications (like music/video players). The following directions should be enough to accomplish this if you are using Dapper Drake: Go to the menu {{{Edit -> Preferences -> Devices -> Audio Devices}}} - Select "{{{ALSA}}}" as the audio plugin - Select "{{{Default}}}" as output - Select "{{{Default}}}" as input Then go to the menu {{{Edit -> Preferences -> General -> Sound Events}}} - Select "{{{Default}}}" as alternate device output For additional help using Ekiga simultaneously with other audio applications, see [http://wiki.ekiga.org/index.php/Getting_several_applications_using_the_sound_card_at_the_same_time_%3F Ekiga's wiki]. === Webcam === Note : Ekiga does not require a webcam. ==== Choosing the right kernel API ==== The Linux kernel has two ways to communicate with video devices, the old v4l and the new v4l2. It's best to use v4l2, but some drivers only support v4l. Go to the menu {{{Edit -> Preferences -> Devices -> Video device}}} - Try "{{{v4l2}}}” or "{{{v4l}}}” as video plugin ==== Choosing the right video device ==== If you have several video devices (like a TV card and a webcam) you will need to tell Ekiga which one to use: Go to the menu {{{Edit → Preferences → Devices → Video device}}} Change the channel number until you find the right one. ==== Test your webcam ==== To test your webcam you can do this: There are 6 icons on the left side of the main Ekiga window. Push the 4th button from the top (a grey round webcam). If eveything is ok, you'll see the output of the webcam. If not, you'll see the Ekiga logo bouncing slowly. == Ekiga.net special numbers == === Echo service === Once you're registered to http://ekiga.net, you can test your setup and line quality by dialing the echo service: {{{sip:500@ekiga.net}}}. === Audio conference server === If you are using 'ekiga.net' as your VoIP provider, you can access a conference server via the aliases *{{{sip:501@ekiga.net}}} -> Public conference room *{{{sip:501XXXX@ekiga.net}}} where XXXX is the number of your choice representing the number of the room. [For example, a group of friends could meet in conference room 1122 by dialing {{{sip:5011122@ekiga.net}}}] These rooms are thus semi-public/semi-private since anyone can join a conference room at any time if they choose the right number. You can read more on Ekiga on its [http://www.gnomemeeting.org/index.php?rub=1 website] [[BR]] == Snapshots == You can get the latest snapshots from here: [http://snapshots.voxgratia.org/] Installing them solved my problems with PC-to-phone calls. But be aware - they might be buggy and stuff. A good thing to do before installing those is to uninstall all pwlib opal or ekiga packages you already have installed. [[BR]] == References == * To read the Ekiga Documentation : run Ekiga and press F1 (require yelp) * [http://ekiga.org/ Ekiga website] * [http://ekiga.org/index.php?rub=3 Ekiga FAQ] * [http://wiki.ekiga.org// Ekiga wiki] * [http://www.asterisk.org Asterisk] is a full featured PABX including VoIP facitlies which complement Ekiga's capabilities. [[BR]] == ToDo == * Expand a lot more, do screenshots. * Link into InternetAndNetworking when there's more content. [[BR]] |
* [[Ekiga]] - Telephony Software * [[Ekiga/VoIPProviders]] - Commercial VoIP Providers * [[Ekiga/Configuration]] - Configuring Ekiga * [[Ekiga/FAQ]] - Frequently Asked Questions about Ekiga |
| Line 136: | Line 90: |
| CategoryDocumentation CategoryNeedsExpansion | = See also = * [[InternetApplications]] * [[Skype]] * [[SoftPhone]] ---- = External links = * To read the Ekiga Documentation : run Ekiga and press F1 (requires yelp) * [[http://ekiga.org/|Ekiga website]] * [[http://wiki.ekiga.org/|Ekiga online documentation]] * [[http://www.asterisk.org|Asterisk]] is a full featured PABX including VoIP facitlies which complement Ekiga's capabilities. * Ekiga needs you! [[http://mail.gnome.org/archives/ekiga-devel-list/2007-February/msg00041.html|Let's spread Ekiga!]] ---- CategorySoftware |
Introduction
Ekiga was the default Internet telephony (VoIP) application/SoftPhone in Ubuntu until Ubuntu 9.10 (Karmic Koala), when it was replaced by Empathy. It lets you make audio and video calls over the Internet to people who have hardware or software that follows the SIP or H.323 standards. Ekiga also features basic instant messaging.
Ekiga has a robust and wide support for multimedia, and is compatible with Windows Messenger and most VoIP applications. Ekiga cannot communicate with Skype because Skype uses its own non-standard protocols. If you have a suitable SIP provider, you can also use Ekiga to place calls to any normal phone line.
During installation of Ekiga, it might be necessary to change router settings.
Desktop interoperability
Ekiga works with Linux or Windows. For Mac OS, you can use the free software xmeeting.
Ekiga is compatible with Netmeeting (H.323, windows), Windows Messenger (SIP, Windows), Gizmo (SIP, multi-platform), and other programs listed on the Ekiga documentation.
Ekiga.net services (free calls PC-to-PC)
Ekiga.net is a free service (no ads) based upon Free Software (iptel and Asterisk) ran by the Ekiga team.
Register to a commercial VoIP provider (landline and mobile phones)
You can register to a commercial VoIP provider to place calls to normal phone line or cell phone (POTS). Ekiga allows you to register with several VoIP providers.
* See Ekiga/VoIPProviders - How to register to a commercial VoIP provider.
Configuration
* See Ekiga/Configuration for help on configuring Ekiga.
FAQ (Frequently Asked Questions)
* See Ekiga/FAQ for answers to frequently asked questions about Ekiga.
Install Ekiga
In trusty (14.04) and later, Ekiga is available in the Universe repository. The package name is ekiga.
Install snapshots from the website
You can get the latest development snapshots from snapshots.ekiga.net. Installing them may solve problems you are experiencing, but be aware that the snapshots could also cause more problems. This package will replace your actual and stable version.
I don't know why this image is necessary.
Install snapshots using a repository
Add this GPG key to verify the repository
- Add the key to your key list
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 3596ED6E
- Add the key to apt utils
$ gpg --export --armor 3596ED6E | sudo apt-key add -
Add the repositories
- The Ekiga SVN snapshot repository
deb http://snapshots.ekiga.net/snapshots/ubuntu/ <release> main
- The updates repository (official)
deb http://archive.ubuntu.com/ubuntu/ <release>-updates main multiverse
where <release> is the codename of the Ubuntu release used, for example 'natty'.
Optionally you can add more features installing those packages:
for webcam support using only V4L API: libpt-snapshot-plugins-v4l
FireWire camera AVC video support: libpt-snapshot-plugins-avc
FireWire camera DC video support: libpt-snapshot-plugins-dc
The H264 Video codec: libopal-snapshot-plugins-h264
Install Ekiga Snapshot
Install the package ekiga-snapshot
Ekiga Links
Navigate to Ekiga pages at Ubuntu Help
Ekiga - Telephony Software
Ekiga/VoIPProviders - Commercial VoIP Providers
Ekiga/Configuration - Configuring Ekiga
Ekiga/FAQ - Frequently Asked Questions about Ekiga
See also
External links
- To read the Ekiga Documentation : run Ekiga and press F1 (requires yelp)
Asterisk is a full featured PABX including VoIP facitlies which complement Ekiga's capabilities.
Ekiga needs you! Let's spread Ekiga!