Wiki

Clone wiki

TaskwarriorAndroid / Configuration

General

Application has no GUI for configuration. Like console Taskwarrior, all settings are stored in .taskrc.android located in <External Storage>/Android/data/kvj.taskw/files/<profile uuid> folder, where <profile uuid> is unique profile ID. You can find name of current profile ID in Navigation drawer, under current profile name (see screenshots)

In order to edit .taskrc.android, open navigation drawer, run Settings and edit file with plain test editor you like or use embedded one

Don't forget to reload configuration after .taskrc.android modification from Navigation drawer

Synchronization

Like with original Taskwarrior, in order to synchronize Android app with taskd server, you need to store three .pem files on your Android device locally and set paths to them in your .taskrc.android file.

There two ways:

  • RECOMMENDED Store .pem files in profile folder <External Storage>/Android/data/kvj.taskw/files/<profile uuid> (see General section) and specify relative path:
taskd.certificate=user.cert.pem
taskd.key=user.key.pem
taskd.ca=ca.cert.pem
  • Store .pem files somewhere and specify full path:
taskd.certificate=/storage/sdcard/user.cert.pem
taskd.key=/storage/sdcard/user.key.pem
taskd.ca=/storage/sdcard/ca.cert.pem

Other two options, taskd.server and taskd.credentials should be same with original Taskwarrior. taskd.trust is ignored now (hostname is not checked).

If sync does not work for you

try to enable debug output:

  • Add following to .taskrc.android: android.debug=y
  • Reload config and sync again
  • Check contents of taskw.log.txt file located in profile folder
  • Optionally share contents of it on IRC or Bitbucket if sync does not work for you. Share menu item is located in Navigation drawer

Security

There is no 100% guarantee that every version of Android can connect to every configuration and version of taskd, but, based on tests, following has been discovered:

  • Android 4+: taskd server with ciphers=NORMAL - OK, ciphers=SECURE256 - Fail
  • Android 5+: taskd server with ciphers=SECURE256 - OK
  • Android 4+: inthe.am server - OK

More tests are needed

Auto-sync

You can enable periodical sync with taskd server by adding following values to your .taskrc.android

android.sync.periodical=60
android.sync.onchange=3
android.sync.onerror=10

This will run sync with taskd every 60 minutes after every successful sync, run sync after 3 minutes after any tasks change command and run sync after 10 minutes when sync error is detected.

Every value is optional.

If you want to disable certain types of statusbar notifications displayed, add following to .taskrc.android:

android.sync.notification=<value> where <value> can be:

  • all - default behavior, all types are displayed
  • none - no notifications at all
  • combination of sync, success, error, separated by comma

Reports

By default app displays list of all available reports in Navigation drawer and shows next report by default. In order to change this behaviour, two configuration options are available:

android.reports=next,list,waiting
android.report.default=list

This will limit report list to only three reports and default report will be list

Updated