<WRAP hide>%%<!-- googleoff: index -->%%</WRAP>
<WRAP center notice centeralign>
**⚠️ v4.0 UI Transition Notice - In Process:**
//The release of Total Launcher v4.0 has introduced significant user interface changes. Please note that this 
page does not yet reflect these updates. The new layout paths, folds, and visual maps are currently being 
compiled and will be deployed shortly.//
</WRAP>
<WRAP hide>%%<!-- googleon: index -->%%</WRAP>


----


======  Dynamic Color Dialog  ======

Dialog selections are discussed below the image. For navigation to an item make a selection in the Dynamic Color image.

{{imapmarkers>:ui:ui-graphic-selection-phone_green_sq-group-option-edit-background-dynamic_color.webp?200|Color - Dynamic Color}}
[[:ui:ui-graphic-selection-phone_green_sq-group-option-edit-background-custom_color|ID1|Custom color@15,47,92,72]]
{{cfg>}}
   {
   }
{{<cfg}}
{{<imapmarkers}}

<wrap hi>**Dynamic Color dialog. Make selection above.**</wrap>

  * The **Custom color** option (the first element in the dialog above) is the only interactive link in this demo. In the app, this function allows the user to define a specific, static color (Hex code) for the selected object. Using this option overrides the Material You dynamic roles, meaning the object's color will remain static and will //not// update when the device wallpaper changes.

<WRAP center round tip 60%>
<WRAP centeralign>For a setup to use Dynamic Color, the user must "authorize" it:</WRAP>
<WRAP centeralign>''Main Menu'' > ''Launcher options'' > ''UI & Animation'' > ''Dynamic color scheme'' > {{:ui:ui-icon_checked_box.webp?direct&20}}</WRAP>
<WRAP centeralign>{{:ui:ui-animation-dynamic_color-checked.webp?direct&400}}</WRAP>
</WRAP>

Dynamic Color, based on Android's **Material You** design language, adapts the Launcher’s color palette based on the user's wallpaper or theme. It uses //predefined// roles (like "Primary," "Secondary," "Error") to apply consistent colors across different UI elements.

**Note on this Demo:** Since this wiki cannot detect the actual phone wallpaper, it is not possible to visually demonstrate the color changing in real-time.
  * If you have a **Green** wallpaper, selecting "Primary" makes the **//object//** Green.
  * If you have a **Black/White** wallpaper, "Primary" makes the **//object//** Black or White.

==== Color Roles Explained ====

<WRAP center round tip 60%>
Remember: Any settings made here apply only to the object //currently// modifying.
</WRAP>

^  Color Role Name  ^  Description  ^  Associated Role Name (mostly text on objects)  ^  Description  ^
|  **Custom color**  | Allows the user to define a specific,\\ static color (Hex code) for the\\ selected object. Using this option\\ overrides the Material You dynamic\\ roles, meaning the object's color\\ will remain static and will //not//\\ update when the device wallpaper changes. |  -  |  -  |
|  **Primary**  | The main accent color. Used for key buttons\\ or highlights. |  **On primary**  | Text/icons placed //on top// of a primary background (high contrast). |
|  **Primary container**  | A softer background variant for\\ cards or panels. |  **On primary container**  | Text/icons on top of the primary container. |
|  **Secondary**  | Supporting accent color for\\ less-prominent elements. |  **On Secondary**  | Text/icons on top of secondary backgrounds. |
|  **Secondary Container**  | A lighter version of secondary\\ used for secondary cards or panels. |  **On Secondary Container**  | Text/icons on top of the secondary container. |
|  **Tertiary**  | A third accent color for subtle details. |  **On Tertiary**  | Text/icons on top of the tertiary container. |
|  **Tertiary Container**  | This is a lighter version of tertiary used\\ for background of tertiary objects. |  **On tertiary container**  | Text/icons on top of the tertiary container. |
|  **Error**  | Used for alerts (usually Red). |  **On error**  | Text/icon color over error backgrounds |
|  **Error container**  | Text/icons on top of error backgrounds. |  **On error container**  | Text/icons on top of the error container. |
|  **Surface**  | The default background color for cards or pages. |  **On surface**  | Text/icons on top of the surface backgrounds. |

**Usage Tips:**
  ***Contrast:** The “On…” roles ensure visibility. If your background is dark, the “On…” color will be light.
  ***Consistency:** Using these roles ensures a theme looks good even if the wallpaper changes.

=== Automatic vs Manual Control ===

Total Launcher allows for a mix of automatic and manual control:
  ***Automatic:** Total Launcher pulls a palette from the wallpaper and assigns it to the roles (Primary, Secondary, etc.).
  ***Manual Override:** It is possible to override any specific color role. For example, "Error" could be forced to always be Blue, even if the wallpaper is Red.
    * To do this, use the [[ui:ui-resources-shape-selection-all-color-color_picker|Color Picker]] on that specific color role.

<WRAP center round tip 60%>
<WRAP centeralign>See more discussion at:</WRAP>
<WRAP centeralign>[[section:section-dynamic_color_customize|Dynamic Color]]</WRAP>
</WRAP>

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

<wrap hide>
===== Hidden Index Anchors =====
[[:ui:ui-graphic-selection-phone_green_sq-group-option-edit-background-custom_color|ID1|Custom color@15,47,92,72]]
{{cfg>}}
   {
   }
{{<cfg}}
</wrap>