Desk Phone Utility

This little utility allows to remotely control snom VoIP desk phones. In particular, it was tested using a snom D717.

The primary application of the utility is using it to open tel and callto URIs from the browser.

The documentation can be found at fjung.com/desk_phone_utility, the source code at github.com/fxjung/desk_phone_utility.

Licensed as Free Software under the :download:`MIT License <../../LICENSE>`.

Installation/Setup

User Install

git clone https://github.com/fxjung/desk_phone_utility.git
cd desk_phone_utility
pip install -e .

Developer Install

git clone [email protected]:fxjung/desk_phone_utility.git
cd desk_phone_utility
pip install -e .[dev,doc]
pre-commit install
make -C docs html

After building the docs they are located in docs/build/html/index.html.

Basic Usage

First, set up the snom http password:

desk_phone_utility set-password

Afterwards, you can test it by trying to call a number of your choice, e.g.

desk_phone_utility "tel:+49 800 3301000"

Finally, for example in Mozilla Firefox, if you encounter a tel: link and get the prompt for the application to open the link with, select desk_phone_utility. If you don’t know where it is located, just run

which desk_phone_utility

to find out.

Configuration

desk_phone_utility can be configured through a toml config file located at ~/.config/desk_phone_utility/config.toml. A file containing example values gets automatically created during first launch. Alternatively, the example file can be downloaded :download:`here <../../src/desk_phone_utility/data/example_config.toml>`.