===== Using Variables =====

Total Launcher has the capability to import data values from several other automation applications
  ***Tasker** - an android automation application available from [[https://play.google.com/store/search?q=tasker&c=apps&utm_source=na_Med|Google Play Store]]
  ***macroDroid** - an android automation application available from [[https://play.google.com/store/search?q=macdroid&c=apps&utm_source=na_Med|Google Play store]]

==== Tasker Variables ====

  * In Tasker (see Tasker's help at Kustom Heavy Industries [https://help.kustom.rocks/] for a more detailed explanation), a task has two actions:
    * Variable Set
    * Send Variable
  * From Tasker's Action category "Plugin"
    * select "Total Launcher" from the alphabetical dialog
    * enter the following information with the symbols and brackets included. Substitute the appropriate varName.
        * Tasker variable name 
          * %varName
        * Total Launcher 
            * <varName>
  * In Total Launcher
    * Turn Edit Mode on
    * Navigate to the desired screen
    * press Object Add (+} in the upper right screen area to open a dialog of element types
        * Select Graphic. The dialog will list the built-in element types: 
            * Select Text
        * A dialog "Action on Tap" opens
            * tap the back button
        * the text element will shows on the screen
            * Tap and hold to move the text element to the desired location
    * Tap the Options icon (gear) icon to enter the object's Edit dialog. 
        * Tap the label "Text" for a list of settings for this element
            * Scroll to the end of the listing and select
                * Advanced - Variable
        * click on Variable
            * Enter the desired varName next to Text as <varName>
            * Any text entered prior to or after <> will be displayed as literal.
            * Tap OK
            * The varName value will now appear on the screen
                * Should the varName be displayed literally, the variable has no recognized value. Re-check your work and insure Tasker has transmitted the data.

<WRAP center round tip 60%>
Variable notes: 
  * When using variables within Total Launcher, a newline character (\n) works as a line break.
  * If using quotes in Total Launcher, text will //not// display unless the quotes are escaped by double quotes ("" n "")
      * In macroDroid, it appears 3 escape characters are required (\\\")
</WRAP>

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