Welcome to Quartx Call Logger’s documentation!

https://api.codacy.com/project/badge/Grade/af3dc404e10e4a8f9f8e79823ff654e9 https://travis-ci.org/quartx-software/quartx-call-logger.svg?branch=master https://coveralls.io/repos/github/quartx-software/quartx-call-logger/badge.svg?branch=master Documentation Status

Quartx Call Logger

Call logger component for the Quartx phone system monitoring frontend. http://www.quartx.ie/

This logger can monitor phone systems for CDR(Call Data Records) and send the records to the monitoring frontend. The monitoring frontend will then analyze the records and display them in a easy to view web interface.

The currently supported phone systems are:

  • Siemens Hipath

Support for new phone systems can be easily added through plugins. With the plugin system any system can be supported as long as the system has some sort of API or Serial Interface. The documentation on how to create a plugin can be found here.


There are two ways to install this package. First is by using PYPI to install system wide, the other is by cloning the git repo and install using Pipenv, whitch isolates the package from the rest of the system for development.


pip install quartx_call_logger
pip install git+https://github.com/quartx-software/quartx-call-logger.git


git clone https://github.com/quartx-software/quartx-call-logger.git
cd quartx-call-logger
pip install pipenv
pipenv install --dev


The Configuration for this package is located in /Library/Application Support/quartx on MacOS, /etc/xdg/quartx on Unix/Linux or C:\ProgramData\quartx\quartx on Windows.

First we download the base configuration file from github so we can modifiy it. The following commands are for Linux/Unix.

sudo mkdir -p /etc/xdg/quartx
sudo curl https://raw.githubusercontent.com/quartx-software/quartx-call-logger/master/quartx_call_logger/data/defaults.yml > /etc/xdg/quartx/call-logger.yml

Currently the only required settings is the token. The token is the authentication key used to authenticate the user and identify who the call logs belong to. Contact Quartx Call Monitoring for the token key.

sudo nano /etc/xdg/quartx/call-logger.yml
token: 3bf6940a6bc249a729e7e4fdd5350bb4887d2dac942a553b198f2dfc678055bf

The plugin settings may also need to be changed depending on the phone system. You can read the configuration comments to see what changes may be required.


The call logger can be run with just one single command when on Linux.


To run the call-logger as a service you can install the systemd service file

sudo curl https://raw.githubusercontent.com/quartx-software/quartx-call-logger/master/quartx-call-logger.service > /etc/systemd/system/call-logger.service
sudo systemctl enable --now call-logger.service


Support for other phone systems can be added through plugins. Documentation for creating plugins can be found at readthedocs.