App widgets in Android are items placed on the home screen that display data and are periodically updated. The widgets for GTO display your task information, allowing you to view and perform some simple actions on your task lists without leaving the home screen. GTO widgets are updated whenever the data in GTO changes, either from a change made in the app or after a full sync.

Adding a widget

The methods of adding widgets vary based on Android version and the specific home screen app. Most of the time, though, you should be able to follow these steps to create a new GTO widget:
  1. Go to the home screen by pressing your device's Home button.
  2. Long-pressĀ (press and hold) an empty area on the home screen, where there isn't already a shortcut or widget.
  3. Select Widgets or Add Widget.
  4. Scroll down and select one of the GTO choices. Don't see GTO in this list?
  5. Customize the widget if you want. You can always return to this screen to configure an existing widget.
  6. Select Apply Settings or press your device's Back button.

Widget Settings

You can configure a widget at any time by pressing the widget settings button, located at the top of the widget.

A few of the settings require more explanation than the short description found in the settings menu:

Scrollable Widget

Note: In the current version of GTO, 3.1.23, scrolling widgets in Ice Cream Sandwich (Android 4) might not update properly. This will be fixed as soon as possible with a future update. Until then, disabling this setting should cause the widget to update properly.

Some home screens allow widgets to to be scrolled up and down, similar to how the main screen in GTO can be scrolled. These home screens are usually third-party apps available on the Google Play Store. The most popular are ADW Launcher, LauncherPro, Home++, and Go Launcher, but most other third-party home screens accept scrolling widgets. On Android version 3 (Honeycomb) and above, the default stock home screen also allows scrollable widgets. You might also need to enable scrolling widgets in the home screen settings.

Small Overlay Buttons

If you prefer a small widget that uses its space to show the most tasks possible, enable this to remove the large black buttons from the top and bottom of the widget. They'll be replaced by smaller buttons with a transparent background which take up very little space.

Easy-Click Rows

Enable this if you have trouble pressing the task you want on the widget. Each row will be a minimum of 2 lines of text high, regardless of how long the task description is.

Click Actions

Select the action you want to occur when you press a task on the widget. Pressing the list name on the widget always opens GTO to that list.

Open GTO - The app will open to the same list that was shown when it was closed. This is the same as selecting an app shortcut.
Open GTO to List - The app will open to the list being displayed on this widget, and the task you clicked will be highlighted in the app.
Create New Task - The app will open to the list being displayed on this widget, and the new task dialog will be opened.
Widget Settings - The widget settings page will be opened. This is the same as pressing the settings button on the widget.
Edit Task - The app will open to the task details screen with the task you clicked on.
Complete Task - The task you clicked on will be completed in the background, or uncompleted if it was already complete. This widget will refresh, but the app will not be opened.