hwine
Hwine
Introduction: I plan to be working on the documentation for the companion iOS application. As others have mentioned, feel free to kibitz. The final location will be The iPhone companion app (IPHONE COMPANION APP PAGE MISSING)
A big thanks to Daniel Jones for his feedback, which I've incorporated. A good editor always improves (and often shortens) things! :)
NOTE: this section is under active development.
iPhone, iPod touch & iPad application
This section describes the companion application for iOS devices. This app is designed to be used in conjunction with the desktop version, using Bonjour synchronization.
iOS app Differences from Desktop Application
The main differences are:
- You may only display one view at a time, and
- Only the currently viewed task list will be synchronized.
The creation of new task lists is best done from the desktop application, then synchronize that task list with the iOS app. Note: at this time, trying to synchronize multiple task lists is a very exacting process, and not suggested for the average user.
Other Differences
Several other minor differences exist:
- "mutually exclusive" sub categories are not enforced in the iOS app
- filtering by multiple categories is not supported
Synchronizing using Bonjour
WARNING!
Bonjour synchronization always occurs between the currently viewed task lists in both the desktop and iOS application, regardless of the task list names. There are no warnings issued if you attempt to sync different task lists - the desktop version will be used, and any iOS app changes to the other list will be lost.
If you're working with multiple task lists, be careful to do things in the correct order. The task list being offered by the desktop will be used, regardless of the task list being viewed in the iOS app. Further, only changes to the offered task list will be uploaded - all others are discarded.
| Same List | Changes | Result |
| Yes | non-overlapping | Changes from both iOS app & desktop are used |
| Yes | conflicting | iOS app changes are used, desktop are discarded |
| No | iOS app changes | Desktop values are used, iOS app changes are discarded |
The above table was verified using version 3.3 of the iOS app, and 1.2.28 of the desktop app.
Using on "corporate" networks
Industrial strength wifi networks (as sometimes found in offices) may be configured to not allow support for the bonjour protocol. The workaround is to detach from your computer from the official wifi network, and temporarily create an "adhoc" network. After creating the adhoc network, your iOS device should have no trouble finding the Task Coach server on the same adhoc network.
Trouble Shooting Failed Syncs
On rare occasions, Task Coach will be unable to complete synchronizations. Usually, restarting the iOS app or the desktop app or both will resolve the issue. If that does not work, re-installation of the iOS app is recommended.
If the above approaches do not work, please ask for help on the mailing list.
