callblocker

Blocks unwanted calls from your home phone, such as telemarketing, junk, spam, scam, etc.

The call blocker acts like a normal phone. No additional telephone switchboard (like FreePBX or Asterisk) is needed. When a telemarketer is calling, the call blocker picks up the phone and automatically hangs up after a few seconds. Like this the call is blocked. It's designed to run on devices with small footprints, such as a Raspberry Pi. When the call blocker is not running (e.g. hardware broke) your home phone is still working by design. Also it has the ability to check against online and offline phone spam lists.

Features

• supports VoIP systems and analog modems
• automatically blocks unwanted incoming calls
• logging of all incoming calls, including caller name lookups
• import your addressbook as whitelist or blacklist
• different kind of blocking modes
  • logging only
  • number blocking using blacklists only
  • number blocking using blacklists and avoid blocking, if number is in whitelist
  • number has to be in whitelist, all other numbers are blocked
• different kind of ways to verify incoming calls
  • user maintained offline blacklist
  • extern maintained offline blacklists (downloaded from the Internet and stored offline)
  • support of online spam check sites, for spam verification
  • detect anonymous and invalid numbers
  • support range of numbers matching whole areas/regions
• different kind of ways to get caller name of incoming calls
  • using whitelists and blacklists as offline lookup for caller name
  • support of online lookup sites, to find out who is calling
• online request caching
• nice web interface

Hardware

Supported (tested) server host systems

• Raspberry Pi
  • raspbian/buster (use master branch)
  • raspbian/stretch (use v0.13.x release)
  • raspbian/jessie (use v0.10.x release)
• Debian GNU/Linux
  • buster (use master branch)
  • stretch (use v0.13.x release)
  • jessie (use v0.10.x release)

Supported (tested) VoIP systems

• Fritzbox 7390, 5490

Supported (tested) analog modems

• USRobotics: USR5637 (56K USB Faxmodem)
• Zoom: Model 3095 (V.92 56K USB Mini External Modem)

Install

via Debian package

Download provided Debian package matching your OS.

Work in progress: not finished yet! Use 'via manual build' for now.

apt install ./callblocker_*.deb

via manual build

Follow this instructions.

Setup web interface on Linux

The configuration of the web interface is optional, the callblocker daemon works perfectly without it. The web interface allows to view the caller log, change settings and diagnose problems. This instructions explain howto make it work with lighttpd, its also possible to configure it via apache.

Additional Debian packages are required:

sudo apt-get install lighttpd python3-systemd python3-setuptools python3-wheel

Prepare lighttpd, for additional information see here:

sudo pip3 install flipflop
sudo usermod -a -G systemd-journal www-data
sudo vi /etc/lighttpd/lighttpd.conf

• in the upper part you find the section 'server.modules='. Please add the module "mod_fastcgi" to it.
• make server.document-root point to "/usr/var/www/callblocker"
• at the end of this file add this code:

   fastcgi.server              = (
        ".py" => (
                "callblocker-fcgi" => (
                        "bin-path" => "/usr/var/www/callblocker/python-fcgi/api.py",
                        "socket" => "/var/run/lighttpd/fastcgi.python.socket")
        )
   )

• make sure the python file api.py has correct execution rights and restart lighttpd daemon.

sudo systemctl restart lighttpd.service

Setup

There are two ways to connect the call blocker application with your phone system, depending if it is VoIP or analog.

Prepare your settings file

cd /etc/callblocker
sudo mv tpl_settings.json settings.json
sudo vi settings.json
sudo systemctl start callblockerd.service

Setup using Fritzbox with an IP-phone

• create in the Fritzbox a new IP-phone
  • open your web browser and navigate to the URL http://fritz.box
  • in the menu "Telefonie -> Telefoniegeraete" click on "Neues Geraet einrichten"
  • choose "Telefon (mit und ohne Anrufbeantworter)" and click "Weiter"
  • choose "LAN/WLAN (IP-Telefon)", for name use for example "callblocker" and click "Weiter"
  • choose a password, remember it and click "Weiter"
  • choose "alle Anrufe annehmen" and click "Weiter"
• setup the IP-phone in the call blocker configuration (/etc/callblocker/setting.json):
  • edit the section sip -> accounts
  • "domain": "fritz.box"
  • "username": "your username"
  • "password": "your password"
  • make sure the account is enabled and the other fields are ok for you

Setup using an analog phone

• attach the USB modem to the Raspberry Pi
• use dmesg to find the device name /dev/<name>
• setup the Analog phone in the call blocker configuration (/etc/callblocker/setting.json):
  • edit the section analog -> phones
  • "device": "your device name"
  • make sure the account is enabled and the other fields are ok for you

Configuration file

The documentation of the configuration file "settings.json" is located here.

Offline blacklists

Through the web interface you have the possibility to maintain your own blacklist. Additionally there is the possibility to download automatically an extern maintained blacklist for later offline usage. You will need to setup a cronjob for this task to download the blacklist periodically.

Currently the following blacklists are supported:

Name	Site	Description
blacklist_toastedspam_com.py	http://www.toastedspam.com	Mostly USA and Canada (+1)
blacklist_ktipp_ch.py	https://www.ktipp.ch	Switzerland (+41)

The following cronjob will download each day the blacklist provided by ktipp_ch:

0 0 * * * /usr/share/callblocker/blacklist_ktipp_ch.py --output /etc/callblocker/blacklists/ >/dev/null 2>&1

Troubleshooting

See this instructions.