From 3b5353c23cccaaa1a428e807a8f06b34748bf17c Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Mon, 8 Aug 2016 18:51:40 +0200 Subject: Initial draft. --- TODO | 16 ++++++++++++++++ USE.md | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 84 insertions(+) create mode 100644 TODO create mode 100644 USE.md diff --git a/TODO b/TODO new file mode 100644 index 0000000..f75547c --- /dev/null +++ b/TODO @@ -0,0 +1,16 @@ + * Recommend Linphone on Android + (CSipSimple is old and unmaintained, does not support Opus or video, + and is rumored to hang and drain battery - + maybe esp. when switching between wifi and cellular). + * Linphone fails with TLS: Try with Letsencrypt instead of CAcert.org. + * Setup snippet (when it works): + + 1. Install linphone from f-droid. + 2. Select "Use sip account" + * Enter username, password, "bitbase.dk", your full name (as display name). + * Leave "Transport" set to the default "TLS". + * Click "Login" + 3. Select "Settings" from main menu. + * Select "Network" submenu. + * Select "Media Encryption" and choose ZRTP. + 4. Optionally: Select "advanced" and "start at boot". diff --git a/USE.md b/USE.md new file mode 100644 index 0000000..a14af70 --- /dev/null +++ b/USE.md @@ -0,0 +1,68 @@ +# 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 + + 1. Install csipsimple from f-droid. + 2. Select "Use sip account" + * Enter username, password, "bitbase.dk", your full name (as display name). + * Leave "Transport" set to the default "TLS". + * Click "Login" + 3. Select "Settings" from main menu. + * Select "Network" submenu. + * Select "Media Encryption" and choose ZRTP. + 4. 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. -- cgit v1.2.3