mirror of https://gitlab.gnome.org/GNOME/calls.git synced 2024-12-12 07:37:35 +00:00

Purism GNOME phone app

Find a file

Evangelos Ribeiro Tzaras d8f2534795 call-display: fix whitespace		2021-02-03 23:58:31 +00:00
.gitlab/issue_templates	gitlab-template: Add Librem 5	2020-12-22 08:04:19 +00:00
build-aux	Flatpak: Fix flatpak manifest, remove java dep and update deps	2020-02-24 15:54:17 +00:00
data	desktop: Add Network main category	2021-01-09 12:40:50 +01:00
debian	d/control: add version requirement on libcallaudio build dependency	2021-01-24 20:09:21 +00:00
doc	doc: meson: Use shared library for gtk-doc	2020-12-05 15:39:43 +01:00
plugins	Let calls-provider be an abstract class	2021-01-31 23:01:13 +00:00
po	Contacts: Add contacts list	2021-02-03 23:28:57 +01:00
src	call-display: fix whitespace	2021-02-03 23:58:31 +00:00
tests	tests: Disable atk bridge	2020-06-08 09:46:58 +00:00
.dir-locals.el	Initial import of cleaned Calls working tree	2018-05-17 14:16:51 +01:00
.gitignore	Add .gitignore	2020-03-13 11:38:58 +01:00
.gitlab-ci.yml	ci: Build flatpak in packaging stage	2021-02-04 00:25:38 +01:00
calls.doap	doap: Fix sytnax	2020-09-18 10:33:39 +02:00
COPYING	Add license COPYING file for appropriate packaging.	2020-03-25 21:10:53 +00:00
meson.build	Document changes and release 0.2.0	2021-01-06 01:35:24 +01:00
meson_options.txt	src: meson.build: remove librem5-hack option and depend on libcallaudio	2020-11-01 13:17:32 +01:00
README.md	docs: update depedencies instructions	2019-09-02 12:03:47 +02:00
sm.puri.Calls.json	flatpak: add libcanberra	2021-01-26 12:44:34 +01:00

README.md

Calls

A phone dialer and call handler.

License

Calls is licensed under the GPLv3+.

Dependencies

To build Calls you need to first install the build-deps defined by the debian/control file

If you are running a Debian based distribution, you can easily install all those the dependencies making use of the following command

sudo apt-get build-dep .

Building

We use the meson and thereby Ninja. The quickest way to get going is to do the following:

meson -Dprefix=/usr/local/stow/calls-git ../calls-build
ninja -C ../calls-build
ninja -C ../calls-build install

Running

Calls has a variety of backends. The default backend is "mm", which utilises ModemManager. To choose a different backend, use the -p command-line option. For example, to run with the dummy backend and some useful debugging output:

export G_MESSAGES_DEBUG=all
/usr/local/stow/calls-git/bin/calls -p dummy

If using ModemManager, Calls will wait for ModemManager to appear on D-Bus and then wait for usable modems to appear. The UI will be inactive and display a status message until a usable modem appears.

oFono

There is also an oFono backend, "ofono". This was the first backend developed but has been superceded by the ModemManager backend so it may suffer from a lack of attention.

The ofono backend depends on oFono Modem objects being present on D-Bus. To run oFono with useful output:

sudo OFONO_AT_DEBUG=1 ofonod -n -d

The test programs within the oFono source tree are useful to bring up a modem to a suitable state. For example:

cd $OFONO_SOURCE/test
./list-modems
./enable-modem /sim7100
./online-modem /sim7100

Then run Calls:

/usr/local/stow/calls-git/bin/calls -p ofono

Phonesim

One can also make use of the oFono modem simulator, phonesim (in the ofono-phonesim package in Debian):

ofono-phonesim -p 12345 -gui /usr/local/share/phonesim/default.xml

then, ensuring /etc/ofono/phonesim.conf has appropriate contents like:

[phonesim]
Address=127.0.0.1
Port=12345

run oFono as above, then:

cd $OFONO_SOURCE/test
./enable-modem /phonesim
./online-modem /phonesim

And again run Calls.