5.1. System-wide settings¶
DAVx⁵ makes use of system proxy settings, unless you use app-wide settings to override them. Only HTTP(S) proxies will be used. System proxy settings can most importantly be found in
Android APN settings (for mobile network connections; defined by network provider),
Android WiFi settings (for WiFi connections; defined when adding a WiFi network).
Your network provider may have defined a system proxy in APN settings that you’re not aware of. Check in case of networking problems.
5.2. App-wide settings¶
There are some settings that apply to the whole DAVx⁵ app. You can access them in the DAVx⁵ navigation drawer / Settings.
- Show debug info
Shows important information about your device and the current system state, DAVx⁵ accounts (including collection URLs) etc. Use this information to narrow down sync problems systematically. Can be shared to email or other apps.
- Verbose logging
If this option is enabled, DAVx⁵ will create a verbose log file which contain various status messages and the whole HTTP traffic. A permanent notification will appear which you can use to send this log to any app, including email, Share via HTTP, or Amaze’s “Save to file”. Use this log file to narrow down sync problems systematically. (You may have to expand the notification to see the “Send” action.) As soon as you turn off verbose logging, the log will be deleted and the notification cancelled.
- Keep in foreground
If this option is enabled, DAVx⁵ will display a permanent notification. This notification keeps DAVx⁵ always in foreground, so that vendor specific background-app-killing (so-called battery saving “features” which may prevent background sync processes) hopefully won’t apply to DAVx⁵ anymore. This is a low-priority status message notification, which is only displayed if you pull down the notifications. It can be silented (=still running but not displayed) in the notifcation channels, too. Using this option will not increase battery consumption of DAVx⁵.
- Override proxy settings
Allows to override the system proxy settings (see above). If this option is enabled, you have to specify a HTTP(S) proxy which is used instead of the system proxy. Can be used to route all DAVx⁵ traffic through a certain proxy, for instance a Tor proxy.
- Distrust system certificates
If this option is enabled, system-wide CA certificates will not be trusted automatically. In this case, every certificate has to be verified and accepted explicitly.
- Reset (un)trusted certificates
Clears the app key stores where both previously trusted and rejected certificates are saved. If those certificates are encountered again, they will have to be verified again.
- App permissions
Opens the dialog where you can manage DAVx⁵ permissions.
- Notification settings
Allows you to change appearance and priority of various DAVx⁵ notifications.
- Reset hints
When DAVx⁵ is started the first time, there are some setup hints. Use this option to make all hints that have been previously dismissed re-appear (if applicable).
- Tasks app
Select your preferred tasks app. Tasks are only synchronized with the selected app.
5.3. Account settings¶
- Sync intervals
Here you can choose the preferred sync interval for address books, calendars and task lists. If you select “only manually”, synchronization is only run on explicit user request. In the other cases, the sync interval is saved in Android settings. Android will run synchronization when local data has been changed (normally very quickly, but in some cases, it may take a few seconds or even minutes) and in regular intervals (given that system-wide automatic synchronization is enabled, permissions are granted, battery saving is disabled for DAVx⁵ and there is a network connection).
Synchronization is not initiated by DAVx⁵ itself. DAVx⁵ relies on the Android content provider framework, which manages synchronization and calls sync adapters like DAVx⁵ according to its settings (like sync interval). If Android does not call DAVx⁵ for some reason, there is no way that DAVx⁵ can synchronize automatically.
Keep in mind that low sync intervals need more battery (although only changed records are transmitted). Sync intervals less than 15 minutes are not allowed by Android 7 and later, because it would use too much battery. If you need up-to-date information in your calendar app, use a moderate sync interval (like one hour) and the “Synchronize now” function of your calendar app when you need it.
- Sync over WiFi only
If this option is enabled, DAVx⁵ skips synchronization unless the device is connected to a WiFi network. Android Settings / Accounts will still show a successful sync even when the synchronization has been skipped. Manually forced synchronization will ignore this setting! It is not intended as a security function, but to avoid network connection error notifications.
When Android Data Saver mode is active, sync over WiFi only is automatically enabled.
Use WiFi SSID restriction to restrict synchronization to one or more specific WiFi networks (requires location permission, including background location). List all allowed SSIDs as a comma-separated list, for instance SSID1,ssid2. Hidden networks and SSIDs with commas are not supported.
- User name / password / client certificate
You can change the credentials used for synchronization at any time here (for instance, when your password has been changed on the server).
- Past event time limit
Number of days which events will be synchronized in the past. For instance, 90 (default setting) will synchronize events which are 90 days in the past and all newer events. Older events won’t be synchronized and won’t show up in the calendar anymore. An empty value means that all events will be synchronized.
- Default reminder
Number of minutes a default reminder will be created before the start of every event that:
is a date/time event (= not a full-day event)
doesn’t have a reminder.
An empty value means that no default reminders will be created. Default reminders are only set locally, but if an event is edited and uploaded, they will be uploaded like normal reminders.
- Manage calendar colors
When turned on, DAVx⁵ will set the local calendar colors to the colors transmitted by the server (or default green, if not sent by the server). To fetch updated colors from the server, see Refreshing the collection list.
- Event color support
Whether colors of single events are synchronized to the Android device. If you enable this option, only new events are affected, so you mave have to unselect the calendar, sync, select it again and sync again. This option is disabled by default because there are some big calendar apps which crash when processing colorized events.
- Contact group method
Controls which contact group method is used for this account. For more information, see Contact groups.