meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
howto:howto-share_object [2026/06/30 13:56] – created - external edit 127.0.0.1howto:howto-share_object [2026/07/19 12:00] (current) – ↷ Links adapted because of a move operation doreps
Line 1: Line 1:
-<WRAP center notice centeralign> +====== Share An Object With Other Total Launcher Users ======
-**⚠️ 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> +
- +
- +
----- +
- +
- +
-====== How To: Share an Object With Other TL Users ======+
  
 <WRAP centeralign tip> <WRAP centeralign tip>
 **Prerequisite**\\  **Prerequisite**\\ 
-This procedure assumes the use of the verified "Clean Slate Default" shell.\\ +This procedure assumes the use of the verified "Clean Slate Distro" shell.\\ 
 To understand how this shell was built or create it from scratch, please refer to:\\  To understand how this shell was built or create it from scratch, please refer to:\\ 
 [[:howto:howto-share_shell_prep|How To: Prepare the "Clean Slate" Setup]] [[:howto:howto-share_shell_prep|How To: Prepare the "Clean Slate" Setup]]
Line 33: Line 22:
   - **Download the Clean Slate Shell:**   - **Download the Clean Slate Shell:**
     - A pre-verified empty setup is available for this purpose.     - A pre-verified empty setup is available for this purpose.
-    - {{:shared_files:uitlm_clean_slate_distro.zip?linkonly|Download the uiTLM Clean Slate Shell here}}. +      - **Download the uiTLM Clean Slate Shell** {{:shared_files:uitlm_clean_slate_distro.zip?linkonly|here}}. 
-    - //(Reference: See [[howto-share_shell_prep|How To: Prepare the "Clean Slate" Setup]] for details on how this was created.)//+        - //(Reference: See [[howto-share_shell_prep|How To: Prepare the "Clean Slate" Setup]] for details on how this was created.)//
   - **Import and Restore:**   - **Import and Restore:**
-    - In the Total Launcher interface enter ''Edit Mode'' and navigate to ''Main menu'' > ''Backup center'' +    - In the Total Launcher interface enter ''Edit Mode'' and tap ''Launcher options'' > ''Backup center'' 
-    -  the ''Add'' {{:ui:ui-icon_add_gray.webp?direct&15}} > ''Import backup''. +    - In the Backup center, scroll to the bottom and tap ''Import backup''. 
-    - The device's file manage will open. Navigate to the folder containing the downloaded file `uiTLM_Clean_Slate_Distro.zip`.+    - The device's file manager will open. Navigate to the folder containing the downloaded file `uiTLM_Clean_Slate_Distro.zip`.
     - Once imported, tap the 3-dot menu next to the file and select ''Restore''.     - Once imported, tap the 3-dot menu next to the file and select ''Restore''.
   - **Verify the Environment:**   - **Verify the Environment:**
-    - Ensure the Home screen is completely black/empty (1 page). +    - After 'uiTLM_Clean_Slate_Distro' installs:      
-    - **Note:** The App Drawer (accessed via swipe up from the bottom right) will display the installed apps of the current device. This is normal; the "All Apps" group is dynamic and is not part of the saved setup.+      - Ensure the Home screen is completely black/empty (1 page). 
 +        - **Note:** The App Drawer (accessed via swipe up from the bottom right) will display the installed apps of the current device. This is normal; the "All Apps" group is dynamic and is not part of the saved setup.
  
 ===== Phase 2: Isolating the Object ===== ===== Phase 2: Isolating the Object =====
Line 50: Line 40:
   - **Option A: Creating a New Object**   - **Option A: Creating a New Object**
     - Long-press the empty screen to begin the process of adding a new Widget, Graphic (Text or Image) object.     - Long-press the empty screen to begin the process of adding a new Widget, Graphic (Text or Image) object.
-      - If further guidance is needed see [[:section:section1-2-e_beginners_basic_editing_steps#to_add_an_object|Adding an Object]]+      - If further guidance is needed see [[section:section-basic_editing#to_add_an_object|Adding an Object]]
     - Style and configure the object as desired.     - Style and configure the object as desired.
     - Save it to the page     - Save it to the page
       - **//Optional://** - The object can also be saved to the Graphics Saved category       - **//Optional://** - The object can also be saved to the Graphics Saved category
         - Select the object         - Select the object
-        - In the Object Design menu (top) tap ''Save'' {{:ui:ui-icon_save.webp?direct&20}}+        - In the Object Design menu (top) tap ''Save'' {{ui:ui-icon_save-v4.webp?20}}
         - The object is saved and can be accessed anytime by ''Add'' > ''Graphic'' > ''Saved'' > select the graphic.         - The object is saved and can be accessed anytime by ''Add'' > ''Graphic'' > ''Saved'' > select the graphic.
- 
   - **Option B: Importing an Existing Design**   - **Option B: Importing an Existing Design**
     - If a graphic or icon exists in the local library:     - If a graphic or icon exists in the local library:
       - Long-press > ''Add'' > ''Graphic''.       - Long-press > ''Add'' > ''Graphic''.
-      - Select the ''Saved'' tab.+      - Select the existing graphic listing //or// the ''Saved'' tab.
         - **Important:** The "Saved" tab displays files on the //current device//. These are not shared automatically. The graphic **must** be tapped and placed onto the Home screen. Only objects physically residing on the page layout are bundled into the backup during export.         - **Important:** The "Saved" tab displays files on the //current device//. These are not shared automatically. The graphic **must** be tapped and placed onto the Home screen. Only objects physically residing on the page layout are bundled into the backup during export.
- 
   - **Option C: Copying from Another Setup**   - **Option C: Copying from Another Setup**
     - //(Advanced)// If the object exists in a different setup:     - //(Advanced)// If the object exists in a different setup:
-      - Restore the primary setup via ''Backup Center''. +      - Backup any existing setups before proceeding. 
-      - Select the object > ''Copy''. +      - Restore the target setup via ''Backup Center''. 
-      - Restore the "Clean Slate" setup via ''Backup Center''. +      - Select the desired object > ''Copy''. (This places that object automatically in the "Saved" graphic tab. 
-      - Long-press the empty page > ''Paste''.+      - Restore the "Clean Slate Distro" setup via ''Backup Center''. 
 +      - Long-press the empty page 
 +        - Dependent of the user device, tap ''Paste'' {{ui:ui-icon_add_paste-v4.webp?direct&25}} in the Object Design menu (top), or 
 +        - Select ''+'' in the Object Design menu > ''Graphic'' > ''Saved'' tab and tap the desire graphic
     - **Constraint:** Ensure **only** the object(s) intended for sharing exist on the page. Delete any accidental additions.     - **Constraint:** Ensure **only** the object(s) intended for sharing exist on the page. Delete any accidental additions.
  
 ===== Phase 3: Creating the Transfer File ===== ===== Phase 3: Creating the Transfer File =====
  
-Once the object is isolated, the setup is exported to create the distribution file.+Once the object is isolated, the setup is to be exported to create the distribution file.
  
   - **Save the Setup Internally:**   - **Save the Setup Internally:**
-    - Navigate to ''Main menu'' > ''Backup Center''. +    - Enter Edit Mode > Launcher options > ''Backup Center''. 
-    - Tap ''Add'' > ''New backup''. +    - Tap ''Add'' > and replace the default title to the backup with: 
-    - Enter a descriptive name (e.g., `Shared_Clock_Widget`).+      - A descriptive name (e.g., `Shared_Clock_Widget`).
     - Tap **OK**.     - Tap **OK**.
  
Line 86: Line 77:
     - Tap the 3-dot menu > ''Export backup''.     - Tap the 3-dot menu > ''Export backup''.
     - Select a destination (e.g., Downloads folder) and save.     - Select a destination (e.g., Downloads folder) and save.
-    - **Note:** This process typically creates a standard **.zip** archive. Verify the created ZIP backup is //not// a 0 byte file.\\ If it is see [[#troubleshooting:_0-Byte_Export_Error|Trouble Shooting]]+      - **Note:** This process typically creates a standard **.zip** archive. Verify the created ZIP backup is //not// a 0 byte file.\\ If it is see [[#troubleshooting:_0-Byte_Export_Error|Trouble Shooting]]
  
 ===== Phase 4: Distribution ===== ===== Phase 4: Distribution =====
Line 92: Line 83:
 The standalone file is now ready for sharing. The standalone file is now ready for sharing.
  
-  - **Locate:** Navigate to the destination folder selected in the previous step using a File Manager.+  - **Locate It:** Navigate to the destination folder selected in the previous step using a File Manager.
   - **Verify:** Check the file size. If the file is **0 bytes**, the export failed (see Troubleshooting below).   - **Verify:** Check the file size. If the file is **0 bytes**, the export failed (see Troubleshooting below).
-  - **Share:** Long-press the file > ''Share''. The file can be sent via Email, Telegram, Google Drive, or Discord.+  - **Share:** Long-press the file, select ''Share''. The file can be sent via Email, Telegram, Google Drive, or Discord. 
 + 
 +The process is now complete. Restore the original backup to the device used before the share procedure started.
  
 ===== Troubleshooting: 0-Byte Export Error ===== ===== Troubleshooting: 0-Byte Export Error =====