Table of Contents

Total Launcher Widgets Guide: Advanced Features for Android Customization

Widgets within Total Launcher serve as essential dynamic components for Android customization, delivering advanced features and highly adaptable wrapper containers for applications, folders, and system status displays. Integrating these functional objects into a custom setup elevates the homescreen layout by merging aesthetic appeal with immediate accessibility. Utilizing these objects allows for deep layout design modifications, effectively transforming static screens into interactive, floating dashboards. Accessing and configuring these tools requires entering Edit Mode by long-pressing an empty screen area, tapping the Toggle Edit Mode icon, and selecting the Object Design menu to open the Widget selection dialog.

This chapter guides new and intermediate Total Launcher (TL) users through the types, functions, and customization options of widgets within the launcher environment. Widgets in Total Launcher provide both essential dynamic functionality and highly customizable wrapper containers for holding applications, windows, folders, launcher actions, application shortcuts, and system status displays.

Overview and Types of Widgets

In Total Launcher, widgets are one of the three main object categories, alongside Layout and Graphic. A widget is an individual object with an independent, specialized design and features for its specific purpose.

Total Launcher offers two primary categories of widgets:

Widget Selection Dialog

To locate this dialog, Enter Edit Mode (Long press an empty area → Toggle Edit Mode icon) > Tap the ''Edit Off'' icon in the lower right to change it to an ''Edit On'' icon Object Design menu (top) + > Widget. This dialog will be seen. The selections are explained below.

Widget - Placement and Advanced Uses

Add a Widget

To add an Application Widget, enter ''Edit On'' mode [long-press an empty area on the Page, Drawer, or Window] and select Add (+) icon Add icon, then select Widget from the Add dialog list. A visual thumbnail of all widgets will display in non-alphabetical order. Application Widgets will contain only widgets for apps installed on the user's device.

Widgets can be added to a page, sliding drawer, or window. Folders will not accept widgets.

Widget - Built-in

There are fourteen built-in widgets in Total Launcher:

Below is a more detailed discussion of each built-in widget. Understanding the differences between similar widgets, such as App Drawer, App Drawer (pager), App Group, and Contacts, is difficult. If the descriptions below still leave questions, this spreadsheet representation may be more helpful for those interested.


Widget: App Drawer

App Drawer Widget  The App Drawer widget is critical for advanced setup customization, offering flexibility in how apps are accessed. It can be placed directly on a page, within a window (to create a floating pop-up app drawer), or anchored to a screen edge (simulating a sliding drawer).

Interaction & Navigation

The bottom Menu Bar of the widget is the control center for finding and organizing apps. It contains the Add, Sort, Tag, and Search icons.

To customize the visual appearance of this bar (background, icon sets, text color/typeface), enter Edit On > select the App drawer (highlight) > select Object Design Menu (top) Object Design Menu (top) > Options .

The Search icon Search icon on the bottom menu bar offers two modes:

Creating a Custom Search Window

To fully customize the search experience (position, background, font), create a Window containing an App Drawer widget. Set the window's Action on open to Launcher Action > App search or Contact search. This forces the keyboard to open immediately when the window launches.

Sorting

The Menu Bar allows a managed Sort Sort icon icon.

Visual Design

The design options are, again, available once the widget is selected and the Option icon Option icon is tapped.

Layout & Quick Scrolling

Widgets placed in windows that have native scrolling will retain their own internal scrolling characteristics.

Item Aesthetics (Icons & Labels)

Users have detailed control over the visual presentation of apps. These can be applied globally via the Shared Options tab.

Backgrounds & Menu Bar

Transparency Trick:

Users can set a color in the color dialog using a hex code #00000000 to make an element transparent (hidden) while keeping the item functional.

Animation & Badges

VERIFY THIS COMMENT: do badges show on App Drawer and not App Group? Check your phone … then adjust this … This differs from the App Group, which displays badges, but customization is handled only system-wide via Main Menu > Launcher Options > Icon Style > Badge Count.


Widget: App Drawer (pager)

App Drawer (pager)  The App drawer (pager) is a distinct, built-in widget that offers an alternative to the standard 'App drawer' for displaying and organizing applications.

It is designed as a customizable container that holds user-selected apps and folders, featuring either vertical or horizontal scrolling.

Its primary difference lies in its presentation and built-in functionalities, which can provide a more structured and efficient user experience.

The App drawer (pager) can be accessed and added by entering Edit Mode > the Add icon (+) > Widget, then navigating the list of built-in widgets and selecting it.

Key Differences and Benefits

While the standard “App drawer” is highly customizable, the App drawer (pager) widget provides a different structural approach and unique features. A user may prefer this format for the following reasons:


Widget: App Group

App GroupThe App Group shares many core customization and aesthetic features with the App Drawer widget but does have some differences noted below. It allows users to create specific groups, which makes it ideal for creating static docks, categorized groups (like “Work Apps” or “Games”), or quick-access panels, rather than displaying all applications on the device (which is the primary function of the App Drawer).

Customizable Application Container

The App Group widget primarily displays a focused selection of icons, relying heavily on user organization and selection. This selection can include applications, windows, folders, or shortcuts.

Functions and Tagging

The fundamental purpose of the App Group is to act as a grouping container as determined by the user. Once set by the user, it will not automatically update.

Layout, Display, and Quick Scrolling

The App Group widget provides extensive control over its layout, supporting both grid and list formats:

*Scrolling: The layout supports vertical scrolling, which is essential for displaying numerous items. Users can customize the scrolling experience using options such as system scroll animation, snap scroll (to ensure items settle without being cut off), hide scrollbar. Notably, the App Group currently does not support horizontal scrolling (paging) like the specialized App Drawer (pager).

Customization Highlights

App Group shares the rich visual customization settings found in the App Drawer when in Edit On mode and selected:


Widget: Contacts

ContactsContacts widget functions as a specialized container for displaying user contacts with extensive customization options for appearance, layout, and interaction as discussed below.

General Functions and Filtering

The Contacts widget can operate in either a Grid or List format. Switching off the “Grid type” option makes it a list view.

Image and Photo Handling

The Contacts widget integrates photos associated with contacts through the system contact manager.

Customization Details

Customization options for the Contacts widget are accessed via the options button (gear icon) while the widget is selected in Edit Mode.

The *Background setting provides complete color, dynamic color, icon pack, shape, image, or dynamic image selection.


Widget: Media Controller

Media Controller - Basic Media Controller - ActiveThis controls a media application and specifically works with media player apps that adhere to the MediaController API of the Android framework. Rather than attempting to list compatible media players, if the widget does not perform, the user should determine whether the media player meets this criterion.
The Media Controller displays a set of controls (buttons) along with media metadata (title and artist) and album art for managing audio or video playback.

Key Functions and Configuration

Configuration for the Media Controller is handled through its dedicated options menu:

Visual Customization

The Media Controller offers detailed options for customizing its appearance:

Want to disable the music widget's animation?

After adding the widget, long-press to open the widget settings and toggle album art on/off.


Widget: Page indicator

Page IndicatorThe widget serves as a visual aid to show the current location within the setup's available pages.

The default page indicator consists of a “house” image representing the home page, and multiple dots for setups with more than one page, all in white. (The image shown is for a 15-page setup.)

As a user's action causes the viewable page to change, the indicator representing the current page will enlarge slightly. This means each indicator (page) has 2 states:
• focused -or- current
• unfocused -or- available but not being viewed

Customization and States

Customization options are accessed by selecting the widget (press and hold it in Edit Mode On) and tapping the Options icon (cog wheel) in the object design menu at the top of the screen.

All customization for the page indicator elements uses the widget's Edit dialog, which opens the launcher's standard Edit dialog, consisting of Reset, Color, Dynamic color, Icon pack, Shape, Image, and Dynamic image. These options are fully discussed here.

For the Page indicator function, the above customizations are accessed by selecting the specific element of the indicator to modify:


Widget: Analog clock

Analog ClockThis functions as a clock face, displaying time with hour, minute, and second hands.

Customization and Features

All customization for the analog clock elements uses the widget's Edit dialog, which opens the launcher's standard Edit dialog, consisting of Reset, Color, Dynamic color, Icon pack, Shape, Image, and Dynamic image. These options are fully discussed here. The features to be customized with the above options are:


Widget: Compass

CompassThe Compass provides directional functionality.

All customization for compass elements has access to the widget's Edit dialog, which accesses the launcher's Edit dialog, in the following manner:

  • Compass skin
    • Reset
    • Icon pack
    • Shape
    • Image
  • Color filter
    • Reset
    • Color
    • Dynamic color
  • Background
    • Reset - Returns to the previous setting and saves no changes.
    • Color
    • Dynamic color
    • Icon pack
    • Shape
    • Image
    • Dynamic image

These options, discussed below, allow users to fully define the visual appearance of the directional elements and the container itself:


Widget: Circle indicator

Device resource Data Value Image
Battery % available Circle Indicator - Battery
RAM usage % available Circle Indicator - Ram
Storage
(internal storage)
% available Circle Indicator - Storage
SD card % available
(if inserted)
Circle Indicator - SD Card
The Circle indicator displays the current status of a specific device resource in a visual, circular format.

Key Functions and Customization

The Circle indicator configuration allows users to select which system data is represented and how the indicator is displayed. The selection of which data value to present is made in the Target option of the dialog.

Customization options for the widget container and indicator appearance are:


Widget: Drawer handle

Drawer HandleThis serves as an expanded trigger area to pull out a specific sliding drawer which is particularly useful if the default used by Total Launcher (a narrow invisible trigger area on the edge of the screen) is deemed too narrow or not accessible.
Total Launcher supports four sliding drawers (left, right, top, and bottom).

Customization and Configuration

The customization options for the drawer handle widget are specific to its function of linking to a sliding drawer and styling the trigger element.


Widget: Slider

SliderOffering on-screen control of screen brightness and volume (media, ring, notification, alarm, or call) through a linear representation with a “thumb” or bulb indicating the current point within the target's data range.

Key Functions and Customization

The default slider is basic. A horizontal line with a “thumb” or bulb that can be grabbed and slid for adjustment. All visual aspects of this object can be modified in the widget's edit dialog:


Widget: Photo slide

Photo SlideA slideshow of sequential or random images from a designated folder, displayed at user-selected intervals. and customization options (such as grayscale or corner radius).

Key Functions and Customization

uiTLM has successfully tested these types ot images support:

  • .bmp
  • .gif
  • .ico
  • .jpeg
  • .jpg
  • .png
  • .9.png (nine patch)
  • .webp

Customization features available in the widgets Edit dialog are:


Widget: RSS reader

RSS ReaderAn RSS reader integrates _R_eally _S_imple _S_yndication feeds (for news, podcasts, or aggregated channels) through any RSS service. The reader supports the display and content of user-selected services (3 are included, but a user can search for rss sports or rss podcasts etc), which can include images with text or text-only layouts.

Functional Characteristics

Toby says: Scroll with RSS in Windows!

Scrolling in Windows: Although windows themselves do not scroll their contents, widgets placed inside a window that possess native scrolling functionality will scroll correctly. This allows users to view long news feeds within a floating pop-up window or sliding panel.


Widget: Checklist

Checklist - View Checklist - EditThis is a “To Do” list, with each item preceded by an active checkbox for a user to indicate “completion” and an edit icon to open the checklist dialog for creating, deleting, and managing the list.

Key Functions and Customization

The Options dialog offers initial setup

Functional Characteristics

The following describes the everyday use and management of the checklist widget:

The item entry dialog offers the following options:

There is no stated limit on entries or on the character limit of an entry. The uiTLM wiki successfully tested 500-character entries and 10 entry items.


Widget: Application

The Application Widget serves as a container for third-party widgets provided by other apps installed on the user's device (e.g., Weather, Calendar, Music Player). Total Launcher extracts these standard Android views for placement by the user in the setup.

Application Widget The image shows Page 6 of 13 of the application widgets on the device used to capture the image. It is shown to provide the reader with sample view the application widget dialog.

These application widgets may not be on any user's device. A user's device will only show a list of application widgets installed on their device.

Android application developers will encode widget containers for specialized data display setups for their applications. When these are available, with the application Total Launcher extracts and displays each in the application widget dialog for the user to select and install on a page, drawer, or window.

Each application widget developer provides customization opportunities for their respective widgets. However, Total Launcher, in managing an application widget, focuses on the visual presentation of the wrapper container. The dialog for the application widget Option Edit is shown below

Application Widget Option Edit dialog
Application Widget NOT configurable

It is critical to remember that Total Launcher only saves the “Application Widget” placeholder on the page or window, not the 3rd-party widget's internal settings. When a backup is restored, the user will be responsible for returning to the application widget location, tapping its placeholder to initiate its reinstallation, and then reapply the application widget's settings.

Scaling vs. Resizing

There is a functional difference between resizing and scaling a widget in how they affect the widget's background size. Resizing the widget frame (dragging the corner handles) changes the container size, but the content inside does not automatically stretch to fill the new space. If the widget content appears too small or floats in empty space after resizing, use the rotate-transform icon Rotate-Transform icon (then tap its Transform button and use the top slider [10-100]) to zoom the widget with its contents, which will not change the background size.

Many third-party widgets come with built-in, non-removable padding. Total Launcher's object negative margin may “crop” this outer space, which is useful for achieving perfectly rounded corners that hug the widget's actual content.

Interaction Handling

Application widgets retain their native functionality. If a widget contains a scrollable list (such as a generic RSS reader or Calendar), it will intercept touch events. Swiping directly on the widget will scroll the list content rather than swiping the launcher page.

Limitations of App Widget Backup & Restore

It is critical to remember that Total Launcher only saves the placeholder for Application Widgets, not the widget or its internal settings when a backup is made.

When restoring a backup, the specific configuration of the third-party widget (e.g., the specific city in a weather widget or the account in a mail widget) is not restored. The user must tap the placeholder to reinitialize the widget and manually reapply its internal settings unless the widget's developer has provided a save-setting or restore feature.

Widget Not Updating?

If a widget (such as a Clock or Battery monitor) lags or stops updating, the issue is usually with the Android System, not the launcher. Go to the device's Android Settings > Apps, locate the app that provides the widget, and ensure it is excluded from the device's “Battery Optimization” or “Deep Sleep” features.