mirror of https://gitlab.gnome.org/GNOME/calls.git synced 2024-12-04 20:07:36 +00:00

Purism GNOME phone app

Find a file

Pierre Michel Augustin 0932189cf0 po: Add Creole Haitian translation		2021-02-23 07:24:25 +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	project: rename to gnome-calls	2021-02-04 01:19:26 +00:00
debian	Document and release 0.3.1	2021-02-16 11:49:35 +01:00
doc	project: rename back to calls	2021-02-11 08:31:27 +00:00
plugins	Let calls-provider be an abstract class	2021-01-31 23:01:13 +00:00
po	po: Add Creole Haitian translation	2021-02-23 07:24:25 +00:00
src	application: Fix double free	2021-02-16 02:59:24 +01: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	project: rename back to calls	2021-02-11 08:31:27 +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	docs: update depedencies instructions	2019-09-02 12:03:47 +02:00
sm.puri.Calls.json	project: rename back to calls	2021-02-11 08:31:27 +00: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.