====== How to Configure Total Launcher After Installation ======

This guide provides the basic procedure for initializing, customizing, and backing up a new Total Launcher installation.

===== Starting with a Clean Slate =====

Before designing the new user interface, the existing default widgets must be removed. ++Click here|{{:howto:howto-instructables-install_default_screen.webp?direct&200}}++ to view the default installation setup.

  - Long press a blank area of the screen to enter layout edit options.
    * Verify that the main window shrinks and the ''Menu'' icon appears on the bottom left.
  - Press the ''Edit Off'' icon {{:ui:ui-icon_edit_mode-edit_off.webp?direct&25}} on the right to change it to ''Edit On'' {{:ui:ui-icon_edit_mode-edit_on.webp?direct&25}}.
  - Tap the center of the window to return it to full size while keeping the editor enabled.
  - Long press a widget to highlight it and activate element edit mode.
  - Tap the trash can icon {{:ui:ui-icon_delete.webp?direct&25}} in the top right corner and confirm the deletion.
  - Repeat the deletion process for all other default elements until the screen is clear.
  - Tap a blank space on the window or press the device back button to save and exit element edit mode.

===== Setting a Background Image =====

  - Long press anywhere on the screen to shrink the window view.
  - Tap the ''Image'' icon {{:ui:ui-icon_image.webp?25}} located at the bottom of the window.
  - Decide if the layout will be for landscape **or** portrait mode (each are independent of the other)
    - Select the landscape (or portrait) image option to open the image library page.
  - Press the plus (''+'') icon {{:ui:ui-icon_add_gray.webp?direct&25}} and navigate to the device location of the desired background image.
  - Select the image to import and save a copy into the launcher library.
  - Tap the picture within the library to open the background setting page.
  - Select ''Stretch to fit screen'' and press ''OK''.
  - Tap the main window to apply and display the new full-size background.

===== Adding and Customizing a Clock Element =====

  - Tap the plus (''+'') icon in the top right corner.
  - Navigate through ''Graphic'' > ''Text'' > ''Default'' to place a ++text box on the screen.|{{:ui:ui-object_add-text-selection-selected.webp?direct&200}}++
  - Tap the Option icon {{:ui:ui-icon_option.webp?25}} to open element settings.
  - Select ''Text'' and then select ''Date/time''.
  - Tap the end of the default format string, delete the contents, and input ''HH:mm'' or ''hh:mm'' via the keyboard.
  - Scroll to the bottom of the page, tap ''OK'', and swipe right-to-left to back out of the screen to view the clock.
  - Adjust the position of the clock by dragging it, or adjust the size using the dots around the bounding box.
  - Change the text color if necessary by tapping the Option icon, navigating to ''Text color'', selecting ''color'', choosing the preferred color.
  - Swipe right-to-left to back out of the screen and save changes.

===== Creating an Application Launch Button =====

  - Tap the plus (''+'') icon and select ''Graphic'' > ''Text'' > ''Default''.
  - Tap the Option icon, select ''Text'', and ensure ''Plain text'' is active.
  - Tap the text field, enter the desired application name, scroll to the bottom of the page and tap ''OK''.
  - Check the ''Capitalise all'' box if uniform lettering is desired, then swipe right-to-left to exit the screen.
  - Tap the Action icon {{:ui:ui-icon_action.webp?direct&25}} to the left of the Option icon.
  - Under ''Tap'', press the ''Action'' field and select ''Application''.
  - Scroll through the list, select the desired application.
  - Swipe right-to-left, drag the text element over the target background area, and resize it to fit.
  - Tap an empty space to de-select and finalize the button.

===== Creating a Website Shortcut with Copied Elements =====

  - Tap the plus (''+'') icon and select ''Graphic'' > ''Image'' > ''Default''.
  - Tap ''Image'', press the plus (''+'') icon, and select a button image from the storage location.
  - Tap the imported image in the library, position it on an empty space, and resize it.
  - Long press an existing text element and tap the ''Copy'' icon {{:ui:ui-icon_copy.webp?direct&25}}.
  - Tap the plus (''+'') icon, select ''Paste'' {{:ui:ui-icon_add_paste.webp?direct&25}}, and drag the duplicate text over the new button image.
  - Tap the Option icon, select ''Text'', modify the text to reflect the website name, scroll down and select Ok and back out of the editor.
  - From the device browser, copy the target website URL.
  - Long press the text on the new button, select the Option icon, and tap ''Action'' > ''Launcher action''.
  - Scroll to the bottom, tap ''Open URL'', and paste the copied URL, remove the default %%http://%% prefix.
  - Tap ''OK'', then swipe right-to-left twice to save and return to the page. Tap ''Edit ON'' to exit.

===== Utilizing Multi-Element Copy and Paste =====

  - Long press a button element to open the editor.
  - Tap additional button elements to highlight and select multiple items simultaneously.
  - Tap the ''Copy'' icon, followed by ''Paste''.
  - Drag the duplicated group of elements to the empty positions on the grid. Tap a blank space to de-select the elements.
  - Edit the actions and text of the pasted buttons individually to save configuration time.

===== Adding Audio Effects to Elements =====

  - Ensure sound files are saved in a device-accessible directory.
  - Open the element editor by long pressing the target item.?
  - Tap the Action icon and select the ''Sound'' option to access the launcher sound library.
  - Import with the ''Add'' icon and select the desired audio file, then swipe right-to-left to return to the page. Tap an empty space.
  - Verify that the assigned sound plays whenever the element is tapped. Tap ''Edit ON'' to exit edit mode.

===== Creating Backups and Setting the Default Launcher =====

  - Long press a blank space on the launcher screen and tap the ''Menu'' icon {{:ui:ui-icon_edit_mode-menu.webp?direct&25}}.
    - Select ''Backup center'', tap the plus (''+'') icon, and select ''New backup''.
    - Insert a custom identifier in front of the default ''backup_YYMMDD'' text string using underscores instead of spaces (e.g., ''My_New_Table_01_backup_YYMMDD'' with the YYMMDD being the current date).
    - Tap ''OK'' and wait for the ''Backup successful'' confirmation message before exiting by a swipe right-to-left.
  - Set Total Launcher as the system default by navigating through system settings: ''Settings'' > ''Apps'' > ''Total Launcher'' > ''Home App'', and select ''Total Launcher''.

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