USE.md



Voice over IP setup
Your account supports making phone calls over the Internet -
a.k.a. VoIP.
Account and sub-accounts
Your "phone number" or VoIP address -
what others use to call you -
is the same as your email address.
You can have multiple "phones" -
places to make and receive calls -
and each has their own sub-account.
Example:

Name: Jonas Smedegaard
VoIP address: sip:jonas@bitbase.dk
Phone account 1: jonas-cellphone
Phone account 2: jonas-laptop
Phone account 3: jonas-dect

Setup of a sub-account
Some applications ask for the full address,
some for username and domain separately.
CSipSimple on Android

Install csipsimple from f-droid.
Select "Use sip account"

Enter username, password, "bitbase.dk", your full name (as display name).
Leave "Transport" set to the default "TLS".
Click "Login"


Select "Settings" from main menu.

Select "Network" submenu.
Select "Media Encryption" and choose ZRTP.


Optionally: Select "advanced" and "start at boot".

Making a call
When your VoIP application is active,
and registration with our server succeeds
(see [setup]),
you can initiate phone calls.
Test services
Here are some test services you can try call:

echo (or 9876): Repeats what you say, after a brief delay
time: speaks the current time at the phone server
helloworld: speaks "Hello World"
recordsample: records what you say...
playbacksample: plays back the most recently recorded sample

Receiving a call
To receive calls,
your VoIP application is active and registered continuously.
Beware esp. on mobile devices
that having VoIP active drains more battery.