User manual

Peers user manual

 

General considerations

Peers is a softphone, i.e. a software phone. To place calls using software, rules and unique “numbers” need to be established so that each software phone can place calls to other phones. Those rules are called a protocol.

Unfortunately, there are many protocols for voice communication over internet (VoIP): MGCP, H323, SIP, XMPP/jingle, IAX, etc. Peers softphone supports only one protocol: SIP. Nevertheless, this protocol seems to be more and more popular amongst VoIP providers. And many free SIP providers offer voice service for free for internet calls only (not towards fixed line phone, nor mobiles).

With this standard, each user needs its own account, its SIP account. If you want to use peers but don’t have any SIP account yet, you can create a SIP account on a free SIP provider. Here is a short list, (you will probably find many using google):

Each SIP provider will give you at least three parameters: username, domain and password. Sometimes a SIP provider may give you an outbound proxy or a proxy. Don’t be scared by this vocabulary, they just have to be provided into peers so that you can place and receive calls using peers.

Register your SIP account

Now that you have your SIP account, we will see how to configure your SIP account in Peers.

When you first start peers, it will display the following window:

If you open Edit > Account frame, you will be able to configure your SIP account.

It’s now time to provide:

  • User: your sip user name (often a number or a simple string you chose),
  • Domain: an internet domain (anything.com), it’s often a domain or a sub-domain of your SIP providers, so it will probably look like the start of the URL of the web site you visited to create this account,
  • Password: password provided by you sip provider. This is generally a complicated string with numbers, letters, etc. If you let password field empty, no registration will be done.
  • Outbound Proxy: this parameter is optional, it may be provided by your sip provider to give an address which is slightly different from domain.

Once credentials configured, click on Apply to register using your account.

If everything happens correctly, you should see a green bullet with “Registered” text

Peers main frame should also display this status:

You can now close your accoutn window using close button.

Place and receive calls

To place a call, you need to input the complete sip uri of the callee. If you don’t have the domain of the callee, or if you want to call a fixed line number, or any other classical phone number, just put the phone number followed by your own domain name.

Then click on call to start the call. A new frame should appear with a simple keypad and hangup button.

18 thoughts on “User manual

  1. Thats great! Really simple and in Java :) . Next step is to look to your source and documentation. Perhaps I will extend it.
    Some words to your description above. Perhaps you should add some examples with fixed numbers. I missunderstand your text (… just put the phone number followed by your own domain name) or it is wrong in my case. I use a Fritz!box and have to put in sip:@domain. So sip is always needed!? e.g.
    sip:1234@fritz.box (external number)
    sip:**1@fritz.box (internal telephone number 1)
    sip:++610@fritz.box (internal dect telephone)

  2. thanks for suggestions.

    sip: prefix is always needed. In theory, in sip, you could have other prefixes (tel:). This is the reason why it is necessary to always prefix your URIs with sip:

  3. thank your for this application
    i am null in JAVA and i tried to repeat steps in tutorial but when i want to build the application by “run as” i see this mistakes:
    logging to stdout
    2012-03-05 10:47:37,067 DEBUG [Thread-2] config file ./conf/peers.xml not found
    Exception in thread “Thread-2″ java.lang.NullPointerException
    at net.sourceforge.peers.sip.core.useragent.UserAgent.(UserAgent.java:103)
    at net.sourceforge.peers.gui.EventManager.(EventManager.java:80)
    at net.sourceforge.peers.gui.MainFrame$2.run(MainFrame.java:139)
    at java.lang.Thread.run(Thread.java:636)
    please could you help me

  4. thank your for this application
    i am null in JAVA and i tried to repeat steps in tutorial but when i want to build the application by “run as” i see this mistakes:
    logging to stdout
    2012-03-05 10:47:37,067 DEBUG [Thread-2] config file ./conf/peers.xml not found
    Exception in thread “Thread-2″ java.lang.NullPointerException
    at net.sourceforge.peers.sip.core.useragent.UserAgent.(UserAgent.java:103)
    at net.sourceforge.peers.gui.EventManager.(EventManager.java:80)
    at net.sourceforge.peers.gui.MainFrame$2.run(MainFrame.java:139)
    at java.lang.Thread.run(Thread.java:636)
    please could you help me and thank you in advance

    • actually, when you run peers, you can provide an argument which gives peers home folder.

      In eclipse, you can provide a program argument in run configurations frame. You can provide “..”.

      Menu Run > Run Configurations… > Arguments Tab > Program arguments: ..

  5. Hi!
    I am not be able to run this source code in eclipse….Plz help me… provide me complete detail steps which I should follow????? Thnx in advance

  6. Hi yohann
    Is it possible to integrate/register peers softphone with open ims core????
    I am running open ims server on one pc and want to register peers to it using registered users i,e; bob and alice.. ..Any guideline???
    Thnx

  7. Hi! I am trying to produce an alert system which can use voice, SMS texting and e-mail produced by program. Will Peers accept speech produce by a text-to-speech program and therefore an audio file and then transport that to a telephone as voice mail – this is particularly meant to be used for a land line.

    Thanks,

    John

  8. I want something I can run at startup and I think that if the account info is in a config file I need not set it inthe GUI . I do not want to make calls I am only using SIP registrtions for a custom applicaton. I also need to know if there is any way to do the following:

    1) Run Headless
    2) pass registration status to a secondary program as to whether registration is successful or not and whether it was declined or just unanswered. (unanswered meaning a firewall may have blocked it vs decliened meaning invalid credentials.
    3) encrypt config file

    If anyone has any idea whether tis or something else can accomplish the above with little modification please contact me at teknogeekz dot com

  9. Am not able to register guys..
    Getting error message as “unknown host:sip2sip.info” and if i specify Outbound proxy
    getting error message as “unknown host:proxy.sipthor.net”.
    Please reply soon

Leave a Reply