Wiki
Clone wikiTaskwarriorAndroid / 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 displayednone
- 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