Subsections of Widgets

Manage Widgets

Home Screen Menu Home Screen Menu

Add

To add a widget, navigate to the home screen, long-press to show the widget menu, then hold and drag the widget to a position on the screen.

Select Widget Select Widget

The configuration screen will be shown. Tap to add the widget.

Configure Widget Configure Widget

Remove

To remove a widget, long press on it, then hold and drag it to the zone at the top of the screen.

Remove Widget Remove Widget

Resize

To resize a widget, long press on it to reveal the control frame, then hold and drag the controls.

Resize Widget (1x1) Resize Widget (1x1) Resize Widget (2x1) Resize Widget (2x1) Resize Widget (3x1) Resize Widget (3x1)

Tip

Widgets can be configured to swap layouts, or scale text and icons, to use all available space.

Widgets can also be aligned to an edge or corner when there is extra space.

Reconfigure

Suntimes -> Settings -> Widgets to show the widget list.

Widget List Widget List

Tap on a widget in the list to configure it.

Tap to configure widget actions.

Tap to configure widget themes.

Create Backup

Suntimes -> Settings -> Widgets to show the widget list, then : -> Create Backup to save widgets (and other settings) to file.

Widget List (menu) Widget List (menu)

Restore Backup

Suntimes -> Settings -> Widgets to show the widget list, then : -> Restore Backup to import settings from file.

After selecting a backup file you will be prompted to select an import method:

  • Restore Backup. Imported settings will be cached for now and restored later when requested by the launcher. The launcher must support this option.

  • Best Guess. Imported settings will be applied to existing widgets by type.

  • Direct Import. Imported settings will be applied directly. This only works correctly if the widget ids are unchanged.

Configure Widgets

Configure Widget Configure Widget

Layout

Suntimes groups widgets by type of data (sun, moon, etc). Each widget type offers a selection of different layouts. Change the layout settings to choose the widget that will be displayed at a given size.

Moon Widget 1x1 Moon Widget Moon Widget 1x1 Moon Widget Moon Widget 1x1 Moon Widget Moon Widget 1x1 Moon Widget Moon Widget 1x1 Moon Widget Moon Widget 1x1 Moon Widget Moon Widget 1x1 Moon Widget Moon Widget 1x1 Moon Widget Moon Widget 1x1 Moon Widget Moon Widget 1x1 Moon Widget

Swap layouts to fill available space

Suntimes can swap between widget layouts when resized to take advantage of available space.

  • Enabled :: The widget will switch between layouts depending on available space.
  • Disabled :: The widget maintains its initial layout when resized. Use this with “scale text and icons” for extra large widgets.

1x1 Layout 1x1 Layout 2x1 Layout 2x1 Layout 3x1 Layout 3x1 Layout

Appearance

Theme

Suntimes can customize the appearance of widgets with themes.

Dark theme Dark theme Light theme Light theme Translucent theme Translucent theme

Scale text and icons

Suntimes can scale widget text and icons to fill all available space.

  • Disabled :: Text and icons are displayed at normal size.
  • Enabled :: Text and icons will be scaled to fill available space.

Scaled text and icons Scaled text and icons

Align base

Suntimes can align widgets to an edge or corner when there is extra space.

Align widgets to an edge or corner Align widgets to an edge or corner
Top-Left Top Top-Right
Left Center Right
Bottom-Left Bottom Bottom-Right

General

Show Title

Widgets can be configured to show a title in the top left corner.

Tip

Title text supports limited % substitutions.

Show Labels

Some widgets can be configured to show optional labels.

Time Format

Widgets can be configured to display time in 12 or 24 hour format.

  • System Format (follows system settings)
  • 12-hour
  • 24-hour
  • Suntimes (follows app settings)
Data Source

Widgets can be configured to use a specific data source.

Time Zone

System Time Zone

The widget is configured to the current system time zone. [default]

User Defined

The widget is configured to a given user-defined time zone.

Tap to sort the list, then select a time zone from the drop-down.

Time Standard

Widgets can be configured to display:

  • Local Mean Time (LMT)
  • Apparent Solar Time (LTST)
  • Local Sidereal Time (LMST)
  • Greenwich Sidereal Time (GMST)
  • Coordinated Universal Time (UTC)
Use App Time Zone

The widget will use the same time zone as the main app; changes to the app setting will be reflected by widgets.

Location

User Defined

The widget is configured to a given set of user-defined coordinates. [default]

Select a place from the drop-down list, or tap to open the places list.

Tap to change the coordinates or label (then tap to save changes, or to cancel). If the label was changed then the coordinates will be saved as a new place.

Current (last known)

The widget will use the “last known” location. The home screen widgets use the passive location provider, so a separate app is required to query the location.

Use App Location

The widget will use the same location as the main app; changes to the app setting will be reflected by widgets.

Action

Suntimes can perform an action whenever a widget is tapped.

  • Do Nothing
  • Update Widget
  • Reconfigure Widget [default]
  • Perform Action
  • Update All Widgets

Widget Themes

Suntimes can customize the appearance of widgets using widget themes.

Defaults

Dark theme Dark theme Light theme Light theme Translucent theme Translucent theme Transparent theme Transparent theme

Manage Themes

To access the theme list Suntimes -> Settings -> Widgets -> Themes

Add, Edit, Copy, Remove

To add, edit, copy, or remove themes, navigate to the theme list.

To add a theme, tap add.

To copy a theme, select it, then tap copy to create a new theme with the same values.

To edit a theme, select it, then tap edit.

To remove a theme, select it, then tap delete.

Note

The default themes cannot be modified; the edit and remove actions will not be shown.

Share, Export, Import

From the theme list, select a theme, then tap to share the theme as a file.

Use : -> Export to export all themes to file.

Use : -> Import to import previously shared or exported themes.

Edit Themes

TODO