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

Mohammed Sadiq c30a41ffa9 Let calls-call be an abstract class And adapt to changes. A calls-mm-call IS-A calls-call (and so on)		2021-04-05 09:38:03 +05:30
.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	project: rename to gnome-calls	2021-02-04 01:19:26 +00:00
debian	sip: Initial provider	2021-04-03 00:08:31 +02:00
doc	project: rename back to calls	2021-02-11 08:31:27 +00:00
plugins	Let calls-call be an abstract class	2021-04-05 09:38:03 +05:30
po	po: Update Romanian translation	2021-03-31 20:44:27 +02:00
src	Let calls-call be an abstract class	2021-04-05 09:38:03 +05:30
tests	test: Test CallsSipOrigin	2021-04-03 00:46:29 +02: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: add -noreset to xvfb-run invocation for flatpak builds	2021-03-15 18:44:26 +00: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	meson: bump version	2021-02-21 04:04:53 +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	manager: Allow to add plugin dir via environent	2021-04-01 14:07:27 +02:00
sm.puri.Calls.json	sip: Initial provider	2021-04-03 00:08:31 +02: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.

When running from the source tree you can use CALLS_PLUGIN_DIR environment varible to specify the directroy from where plugins are loaded. To e.g. load the dummy plugin from the source tree:

export CALLS_PLUGIN_DIR=_build/plugins/dummy/
_build/src/gnome-calls -p dummy

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.