Don has not confirmed Gesture animation works and has no confirmation from Telegram post 20260214 whether double and triple tap gestures work. ====== Keys & Gestures ====== Gestures in Total Launcher provide a method for executing commands, launching applications, or manipulating the user interface without relying on visible buttons. These interactions are divided into two primary categories: global gestures that apply to the entire launcher environment, and object-specific gestures attached to individual items. Introduction to Gestures Total Launcher supports a wide array of inputs, including standard swipes, multi-touch interactions, and device sensor triggers (shaking or flipping the device). Configuring these allows for a minimalist design by hiding complex functionality behind invisible triggers. ++++Keys & Gestures dialog :|{{:ui:ui-gestures1-keys_gestures.webp?300|Keys & Gestures}} - {{:ui:ui-gestures2-landscape.webp?300|Landscape Gestures}} - {{:ui:ui-gestures3-other_advanced.webp?300|Advanced & Other Gestures}} ++++ **Navigate to:** ''Launcher Options'' > ''Key & Gestures''.\\ **Scope:** - Applies to the home screen and other launcher windows unless overridden by an object. ===== Global Gestures ===== Global gestures are detected on the background of the launcher (empty space) and are not tied to specific objects. These are managed within the main launcher settings. The ''Key & Gestures'' menu separates inputs into standard touch gestures, landscape-specific overrides, and sensor-based actions. ^ Keys & Gesture Input ^ Description ^ | **Home key** | For devices using Android's "Back-Home-Recent Apps" navigation controls the command can be re-assigned. The Android operating system does not allow third-party launchers to override the input of the Recent Apps button directly. However, any gesture can be assigned by launcher action "Recent Apps" | | **Back key** | ::: | | **Double tap** | Executes a command upon quickly tapping the screen background twice. | | **Triple tap** | Executes a command upon quickly tapping the screen background three times. | | **Swipe up** | Triggers an action when swiping upward on an empty area. | | **Swipe down\\ (Left half / Right half)** | Distinct actions can be assigned to swiping down on the ''left half'' versus the ''right half'' of the screen. | | **Swipe left/right** | Triggers actions when swiping horizontally across the screen. | | **Pinch out** | Typically used to toggle ''Edit mode'' or open menus. | | **Two-finger swipe\\ (Up/Down)** | Supports directional swipes using two fingers simultaneously. | | **Face down** | Executes an action when the device is placed screen-down on a flat surface. | | **Face up** | Executes an action when the device is placed screen-up. | | **Shake device** | Triggers an action when the device is shaken. Includes a ''Shake sensitivity'' setting. | ==== Landscape Mode ==== The ''Gestures Landscape'' section allows for a distinct set of actions when the device is rotated. * **Different actions for landscape:** - Enabling this toggle allows the user to assign unique actions to the gestures listed above when the device is in landscape orientation. ==== Advanced Settings ==== Additional configuration options are available at the bottom of the ''Key & Gestures'' menu. * **Gesture animation:** - Toggles the visual feedback when a gesture is recognized. * **Gesture vibration:** - Toggles haptic feedback when a gesture is executed. * **Disable long-press background:** - Prevents the long-press action from opening the launcher menu. Note that the menu can still be accessed via the ''Pinch out'' gesture (or ''Pinch in'' depending on configuration) even if this is enabled. * **Disallow page transition by touch:** - Prevents touching to change pages, requiring navigation via buttons, sequences or other links. Launcher Action Alternatives Gestures are generally global in nature. Look at Total Launcher's [[section-launcher_action|"Launcher Actions"]] as an alternative to accomplishing object specific actions. ===== Object-Specific Gestures ===== Gestures can also be assigned to individual objects, such as app icons, graphic images, or text. This allows a single object to perform multiple functions. * **Configuration:** - Select an object in ''Edit mode'', then navigate to the object's Action {{:ui:ui-icon_action.webp?direct&25}} menu . * **Swipe Actions:** - Determines what happens when the user swipes directly on the specific object. * **Direction:** - Directions for object swipes are generally limited to the four cardinal directions (Up, Down, Left, Right) relative to the object. Examples of object-specific configurations: - **Folder Emulation:** - Tapping an icon opens the app; swiping up on the same icon opens a folder. An example may be tap to open a Finance folder containing all financial-related apps while a swipe left would open the ABC Bank or a swipe right would open the primary credit card. - **Widget Control:** - Swiping on a music widget change the media volume. ===== Layout Strategies ===== For theme designers, gestures offer a way to maintain a clean aesthetic while retaining complex functionality. Advanced implementation often involves the use of invisible objects or "hotspots." * **Invisible Hotspots:** - Places a transparent ''Graphic'' object (opacity set to 0) over a specific area of the wallpaper. * **Layering (Z-Index):** - Ensures the invisible object intercepts touch events by placing it above other elements. This is achieved by selecting the object in ''Edit mode'' and using the **"Bring to front"** or **"Order"** commands to move it to the top layer. * **Action Assignment:** - Assigns a ''Tap'' or ''Swipe'' action to this invisible object to trigger the desired command. This technique is useful for: - **Stealth Navigation:** - Creating secret tap zones to reveal hidden windows. - **Custom Controls:** - Overlaying gesture areas on top of static wallpapers to simulate interactive buttons. - **Conflict Resolution:** - If a widget has internal touch controls that conflict with a global swipe gesture, placing a container or invisible object on top can manage how the touch is intercepted. **Note:** When ''Edit mode'' is active, some gestures may be disabled or modified to allow for object selection and movement. Testing should always be performed in ''Use mode''. {{page>site:site-footer-comment_feedback_block}}