Basic NCID command line client written in Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Basic NCID command line client written in Python 2

python2 -m ncidmon [OPTIONS]


Retrieve call log, notify recent call and optionally listen/notify for incoming calls. Built-in webserver provides list of all recent calls.

Optional arguments:


Name or address and port or service name of NCID server.


Listen for incoming calls. Can be used for running in background, e.g. automatically started in user session. Recent calls are shown on standard output, with notifications enabled also per on screen notification. A web-based call list is also provided, per default on http://localhost:8080.

--http <host>:<port>

Name or address and port or service name to use for internal call list web server. The call list is only available in listening mode and if the specified port can be bound.


Show no notifcations for recent call and incoming calls. To be used for instant checks of recent calls. With notifications enabled recent and/or incoming call information are displayed per popup. The amount of information depends on the capabilities of your local notification OSD server.

-d, --debug

Print debug output.

-h, --help

Show usage and exit.



  • developed with Python 2.7 (last version check returned 2.7.6)


  • limit log entries output on console by configurable time span
  • restructure (file and folder hierarchy)
  • command line options for NCID and HTTP server addresses
  • maybe two twisted protocol implementations for simple request and continuous listening mode
  • support wildcard numbers (corporate telephone system)
  • i18n using gettext
  • direct execution from zip file
  • config command line options (using arparse) overriding application defaults
  • workaround EasyBox day/month inversion
  • python setup infrastructure
  • porting to Python 3
  • connection timeout