Home

Android Permissions Required

• SMS messages
• Notifications
• Network

Downloading and Installation of the App Package (.apk)

Manually

The end-user should be explained what URL to acquire the .apk file, and how to verify its integrity.

Using F-Droid

Android Application, install it from F-Droid.

Updates and Versioning

The end-user should have an explanation of how the app is versioned, and a high-level overview of the update process.

Quick Start

Go to Android Settings, select Add Account and Nextcloud-SMS.

Now set your server URL like this: https://nextcloud.example.org/. If Nextcloud is hosted under a subdirectory, you can set it to https://nextcloud.example.org/nextcloud, for example. Type your login and your password, and wait for the login.

That's all.

App parameters

When an account was created, go back to Settings and select Nextcloud-SMS.

You can select the following parameters:

• Differential sync interval
• Enable sync on: 2G, 3G, 4G, GPRS and Wi-Fi

App mechanics

The application uses three mechanics to push your messages to your Nextcloud instance

1. Periodic sync: It's a differential sync performed between your device and your Nextcloud instance. Device ask the server for its SMS stored list and send the missing messages to server. This sync is periodic (default: 3 hours).

2. Push on send/received: When your first received a message after a phone start or an account configuration, the phone start a push on send/received message. Each time your send or received a message, the phone push the message to the server, if data was available.

3. Push on network up: When your data connection comes up, application check if messages were received whereas data connection was unavailable and sync every messages since last synced message date

Building application

Because some parts can be common to multiple applications, you need to get my Android-lib present here: https://github.com/nerzhul/nrz-androidlib