summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--TODO16
-rw-r--r--USE.md68
2 files changed, 84 insertions, 0 deletions
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.