CALLERID WITH PERSONAL INFORMATION LOOKUP ON
WWW.ENIRO.SE
0- BEFORE YOU USE THIS SOFTWARE
You can use this software ONLY for YOUR PERSONAL (and CLOSE FAMILY)
use and NOT for COMMERCIAL purposes under any circompstances . This restriction apply since this software retrives data from ENIRO.SE (the swedish phonebook website) who only allows you to use the data in this way. Please take your time, before using this software, to read the terms of use of the data from ENIRO.SE availble here: http://www.eniro.se/upphovsratt
If you DON'T AGREE to these terms, please DO NOT use this software and I'm NOT responsable for the consequences of your actions.
1- SOFTWARE PRESENTATION
This is a simple software, comprised of a server (calleridd) and a client (callerid), that can be used together with any VoIP-phone using the SIP protocol
(for ex. TELE2 and Bredbandsbolget in sweden) to allow you to see who you
are talking to. It also uses ENIRO.SE (The swedish phonebook website) to retrive some personal data on the person you are talking to, such as name, adress, cellphone, and a link to a map. If nobody answers the phone, a free SMS is sent to a given cellphone with the name, adress and a WAP link of the caller. The SMS routine uses ENIRO.SE's free SMS service to send you the SMS (max 5 SMS/day). Call data, conversation time and cost are then logged into an html file.
2- HOW TO CONFIGURE YOUR NETWORK
You shoukd have one of theses network configuration set up, In order for this software to work:
1- Your VoIP-phone box is connected to your home/internal network behind a Linux gatway/firewall/router.
The calleridd server side is then installed and run as a daemon on the gatway.
Callerid clients will then connect to the gateway to retrive call information.
2- Your VoIP-phone box is connected to a HUB (Not a switch) together with the computer that will run the calleridd server.
Callerid clients will then connect to that computer to retrive call information.
3- Your VoIP-phone box and the computer that will run the calleridd server are connected to the same physical LAN socket using a TP-split.
Callerid clients will then connect to that computer to retrive call information.
3- DETAILED PRESENTATION OF THE SERVER (calleridd)
As mentioned in 1-, the calleridd server sniffs the local network
UDP
traffic for SIP-communication and extract the phone number of the person you are talking to. It makes a search on ENIRO.SE (the swedish phonebook on the internet) and retrives the name, professional title (if enetered by the user), adress, cellphone number (if entered by the user) and a map of the location of the adress. This information is sent to the callerid clients.
If nobody answers the phone, a free SMS is sent to a given cellphone with the name, adress and a WAP link of the caller. The SMS routine uses ENIRO.SE's free SMS service to send you the SMS (max 5 SMS/day). Call data, conversation time and cost are then logged into an html-logfile in different colors, depending on what type call it is (local call, cell, international, free....). If somebody calls while you are buzy in a conversation, the call information is alsologged into the html-logfile to let you know.
The calleridd server is configured using a configuration file 'callerid.conf' located in '/etc/callerid'. It also has a local phonebook 'phonebook.dat' also located in '/etc/callerid', where the user can put his own contacts that are not listed on ENIRO.SE. Call information found in the local phonebook always overrides information retrived from ENIRO.SE. The server and client can share the same configuration file and phonebook.
4- DETAILED PRESENTATION OF THE CLIENT (callerid)
The callerid client retrives call information from the server when a call is in progress. If the phonenumber is found in the local phonebook, then the call data retrived from the server is ignored. The call information, such as name, adress, status (ringing, hang up and so on), duration and cost are then printed on the screen and updated while the call is in progress. The call information is printed in two locations: Your maine screen and your second screen (TV may be), if you are using the XINERAMA extention. The location where the data is printed on screen is defined in the configuration file.
If you enter a conversation, the callerid client uses 'aumix' available from http://www.jpj.net/~trevor/aumix.html to reduce the volume of the computer while you are talking. It increases the volume back to it's original state once the conversation is over. The callerid client uses XOSD software available from (http://www.ignavus.net/software.html) to display data on screen. This software has to be install on the computer where the client is run. .
If somebody calls while you are buzy in a conversation, the call information is also printed on screen to let you know.
5- NEWS/BUGS
If you find bugs, please notify me at grisou_75@yahoo.se. Or even better, fix them your self and send me a patch ;).
+ 2007-05-05: It has been a while since last update since I had too much to
do
at work. Small bug fixes... The SMS routine is working again. The
street name value was also broken since ENIRO has changed the pattern but
it's working now. The CVS and downloadable versions are now up to date...
Enjoy :)
+ 2007-04-05: Not callerid-related -> My beloved cat Gustav died today due
to a kidney failure since last week :(((((
+ 2007-01-18: The SMS routine is broken since ENIRO.SE made radical changes in their websites. I'm pretty close on figuring out how it works and I'll update the software as soon I do (If I have time that is)...
+ 2007-01-17: ENIRO.SE has done a new layout (much nicer than the old one I might add) and changed the topgraphy of the retrived data. I have rewritten some parts so the software now works again. I'm sure I've covered everything but I might have missed som stuff so... If you have problems send me an email... Or even better, fix them and send an email with the fixes ;)
6- REQUIREMENTS
+ XOSD (http://www.ignavus.net/software.html) for the client...
+ AUMIX (http://www.jpj.net/~trevor/aumix.html) for the client...
7- SCREENSHOTS
8- DOWNLOAD
The source code is available here.
CVS:
To login anonymously at the CVS type:
+ cvs
-d:pserver:anonymous@callerid.cvs.sourceforge.net:/cvsroot/callerid
login
To checkout the source code type:
+ cvs
-d:pserver:anonymous@callerid.cvs.sourceforge.net:/cvsroot/callerid
checkout callerid
9- INSTALL
Please, read point 0- and 6- for the conditions of use and the required software before trying to compile this software.
To compile the program, run 'make' and then copy the executable binary file somewhere in your path.
To compile and install the program in a given directory, edit the variable INSTALLDIR in the 'Makefile' and change it to the desired install-location and then run the command 'make install'.
If you use gcc-4.x.x then you'll get a lot of warnings. Ignore them (or fix them your self if you want). I developped the software using gcc-3.x.x and these warnings do not show up. I don't have time to fixe them right now (in the future may be) and they really do not alter the performance of the software...