Resource: Dynamic Image

Dynamic Image Resources provide state-responsive visual assets that evaluate internal Android conditions, sensor feeds, or live provider data to display context-appropriate graphics in real time. Rather than behaving as static bitmaps, a Dynamic Image operates as an array of condition-mapped image slots.

Once configured and saved in the central library (Edit mode > Launcher options > Resources > Dynamic image), a dynamic image can be used across multiple page objects, button states, window frames, or widget backgrounds, updating globally whenever the master resource changes.

Dynamic images are managed and created through two access points:

• Global Resource Library: Edit mode > Launcher options > Resources > Dynamic image (used to build and store reusable templates).
• Object Insertion: Edit mode > Edit on > Add > Graphic > Image > Default > Dynamic image.

Selecting Type from this dialog provides access to 17 distinct functional categories:

Complex dynamic categories (such as Clock and Calendar) utilize a three-stage stacking hierarchy to define the final graphic:

Background Plate → Dynamic Condition Slots → Foreground Frame

• Background Slot (Bottom Layer): Renders beneath all changing elements. Ideal for static watch dial faces, metallic instrument bezels, circular gauges, or calendar desk pads.
• Dynamic State Slots (Middle Layer): Swapped automatically as system conditions change (e.g., swapping from 16:00 to 17:00, or from Few clouds to Rain). Any individual slot can be replaced with custom artwork.
• Foreground Slot (Top Layer): Overlays on top of the dynamic states using transparent PNG or WebP assets. Useful for:
  • Applying glass glare reflections across clock hands or dials.
  • Centering mechanical watch cap screws over the hand axis.
  • Cutout border masks that trim inner moving graphics cleanly.

While Total Launcher uses standard Android bitmaps for root system wallpapers, a Dynamic Image can serve as a live environmental wallpaper via canvas layering:

• Add a Weather Dynamic Image as an object: Add > Graphic > Image > Dynamic image > Weather.
• Scale the graphic container to cover the entire page boundary (100% width, 100% height).
• In the Object Design Menu, send the object to the lowest layer using Lower Z-Order (or assign it to the page background layer).
• Position Date, Clock, and App Drawer items on top of it.
• Result: The wallpaper scenery automatically shifts between crisp sunshine, overcast skies, rain animations, or nocturnal starfields based on live local forecast updates.

See Dynamic Images - Weather for more details.

When designing counters for notifications or unread Gmails, standard notification dots can clutter minimal designs when no alerts exist:

• Open the Dynamic Image set for Notification count or Gmails (unread).
• In the 0 slot, assign a completely transparent 1×1 WebP or PNG graphic.
• Populate slots 1 through 10+ with colored badge graphics or numbered circles.
• Result: The notification graphic remains completely invisible during zero-alert states, only appearing on screen when unread messages arrive.

Modern Android versions (Android 10+) broadcast an operating system flag (UI_MODE_NIGHT) when switching between Light and Dark themes via scheduled sunset times or the Quick Settings panel.

• Creating a Themed image allows two completely different graphic designs to occupy the same object space.
• Assign light, pastel, or low-contrast icons to the Light theme slot.
• Assign dark, high-contrast, or neon-accented icons to the Dark theme slot.
• Total Launcher listens natively to the Android OS broadcast and swaps the visible graphic instantly without requiring a separate theme profile reload.

If an analog or digital clock requires a specific visual change at a single hour (such as changing color during evening hours), the entire 24-hour set does not need to be rebuilt:

• Only modify the target hour slot (e.g., 17:00 for 5:00 PM).
• Unaltered slots will continue to render the default clock assets.
• Total Launcher triggers the customized graphic exactly at 17:00:00 and returns to the default profile when the hour completes.

1. Add the Circle Indicator Widget:
   1. Long-press an empty space on the home screen, select Add > Widget, and choose Circle indicator from Total Launcher's built-in widget selection list.
   2. Verification: The Circle indicator configuration dialog opens immediately on the screen.
2. Select the Target Resource:
   1. In the configuration dialog, tap the Target option.
      1. From the list of available device resources, choose Battery.
   2. Verification: The preview reflects the `% available` battery metric rather than RAM or Storage.
3. Style Color and Background:
   1. In the same dialog:
      1. Color: Tap to choose the stroke/meter color using either the standard Color Picker or dynamic color definitions.
      2. Background: Optionally define the widget container's background (e.g., solid color, shape, or empty/transparent).
      3. Margins: Adjust container margins if needed for layout alignment.
   2. Verification: The indicator preview shows the chosen palette and container styling.
4. Confirm and Place:
   1. Confirm selections to place the widget on the layout.
   2. Verification: The radial battery ring appears on the screen and accurately mirrors the current battery percentage.

• For a fully customizable live calendar badge (like the top-red calendar frame with today's date centered inside) that does not rely on whether an icon pack supports dynamic calendar intents, build it directly using a layered Image/Text object:

1. Add the Background Graphic:
   1. Long-press any empty space on the screen and select Add > Graphic (or Image). Load the calendar frame artwork (e.g., the white card with the red header). Tap the checkmark to place it.
   2. Verification: The calendar frame sits on the screen and can be moved or resized.
2. Add the Dynamic Date Text:
   1. Long-press the screen, choose Add > Text, and tap the Edit (pencil) icon to open text properties.
      1. In the text field: Tap the dynamic tag button (or type the date format variable 'd' for single-digit or 'dd' for two-digit day).
      2. Under text style, set Alignment to Center, choose the font, and set the text color to #FF212121.
   2. Verification: The text object displays the current numerical day of the month on the screen.3.Position and Group:
3. Drag the date text directly over the body of the calendar graphic.
   1. Long-press to enter multi-select mode, select both the graphic and the text, and tap Group.
   2. Verification: Dragging either item moves the entire calendar icon as one unified element.
4. Assign the Tap Action:
   1. Select the newly created group, tap the Edit (pencil) icon, navigate to Action, and set it to Launch application > select the preferred Calendar app.
   2. Verification: Tapping the badge launches the calendar app immediately.

To populate custom dynamic image slots with cohesive assets, transparent PNG or WebP collections designed for open interface systems can be utilized:

• Erik Flowers Weather Icons: Comprehensive collection of over 200 standardized meteorological vector graphics and web assets ready for OpenWeatherMap mapping.
  URL: https://erikflowers.github.io/weather-icons/
• IconArchive Weather Collections: Free downloadable PNG icon sets sorted by style (realistic, flat vector, monochrome glyphs) on transparent backgrounds.
  URL: https://www.iconarchive.com/tag/weather
• Open Clipart Library: Public-domain vector collection providing complete sets of moon phases, dial gauges, and weather art.
  URL: https://commons.wikimedia.org/wiki/File:Weather_icon_-_complete_set.svg

Also see the UI Section on Dynamic Images.