<insert previous page>

====== Dynamic Images - Weather ======

Dynamic Images in Total Launcher act as a "visual status indicator." Unlike a static icon which never changes, a Dynamic Image automatically updates its appearance based on the real-time data source. In this case, the current weather conditions are provided by OpenWeatherMap.org.

==== Understanding the Weather Dynamic Image ====

The Weather Dynamic Image is a specialized container. Instead of holding a single static picture, it contains a "set" or "pack" of images representing various weather states (e.g., Clear, Clouds, Rain, Snow).

  * **How it Functions:** The launcher polls the device's location data to obtain the current weather status. It then selects and displays the specific image from the set that matches the current condition.
  * **Toggle vs. Status:** It is important for new users to note that a Dynamic Image reflects a **status**. Tapping it will not change the weather; however, an "Action on tap" can be assigned to it (like opening a weather app) separately.

==== Add a Dynamic Weather Image to a Page ====
  - Enter ''Edit Mode'' > ''Edit On'' > Page Design Menu ''Add'' 
  - In the Add dialog, tap ''Graphic'' > ''Image''
  - In the "Action on Tap" dialog, tap ''Default'' (Do Nothing)
  - In the "Image" dialog, tap ''Dynamic image''
  - In the "Dynamic image" dialog, tap "Add" icon {{:ui:ui-icon_add_gray.webp?direct&25}}
  - In the "Add" dialog, the default selection type is "clock". Tap the drop-down arrow and scroll down to ''Weather-OpenWeatherMap.org'' to select it.
  - The "Add" dialog will now list 18 pre-formatted weather icons for conditions. To use these images just proceed. To modify these images see [[:howto:howto-dynamic_image-customize|How to Customize Dynamic Images.]]
    - While in this dialog 2 decisions are necessary:
      - **Label:** - Enter the title which a user will to identify the object in the Dynamic Resources dialog. 
      - **Location desired:**
        - **Current:** By default (slider in the right position) the current GPS location is used. As the device moves, the location changes. Nothing further needs to be done. Proceed to Step G.I.3 to select OK.
        - **Static:** Designate a specific data point for the icon, i.e. a latitude and a longitude. To choose this:
          - Tap the Option icon {{:ui:ui-icon_option.webp?direct&25}} in the dialog.
            - Tap the slider to **Off** (slider in left position).
            - This opens a search input dialog. Enter the location (city, state), tap the search icon {{:ui:ui-icon_search.webp?direct&25}}, then tap the drop-down arrow to reveal the eligible locations. Tap the desired location. The latitude and longitude now fills the required dialog.
          - Tap **OK** to exit.
      - Tap **OK** again to return to the Dynamic image dialog. 
  - Tap the newly created Weather item to select it.
  - The Dynamic Image Weather object is now on the page and selected.
  - Continue with placing the object at the desired location on the page and performing any "image" options desired. See discussion in the "UI" section at [[:ui:ui-object-image-option-edit|Object: Image - Options.]]

== 2. Image Set Customization ==

While the launcher provides built-in sets, you can "Edit" the dynamic image to swap out specific icons.

  * **Mapping:** Each weather status (e.g., "Thunderstorm") has a corresponding %%slot%%.
  * **Customization:** You can replace these default images with your own custom images or icons from an icon pack to match your theme's aesthetic. See [[:howto:howto-dynamic_image-customize|How to Customize Dynamic Images.]]

=== Quick Tips for New Users ===

  * **Visibility:** If the weather icon isn't appearing, ensure the device's Location Services (GPS) are enabled and Total Launcher has permission to access it.
  * **Refresh Rate:** Total Launcher optimizes battery by updating weather at set intervals. You can adjust the **GPS Interval** in ''Main menu'' > ''Launcher Options'' > ''Behavior'' > ''Advanced'' > ''GPS interval''.
  * **Mixed Graphics:** For a professional look, group a **Dynamic Text** object (for temperature) with your **Dynamic Image** (for condition) to create a custom "Weather Widget."

<WRAP noprint>{{page>site:site-footer-comment_feedback_block}}</WRAP>