route:/learn learn:contextual-help-catalog
Interactive app guide
Learn the App Learn Macro Handler buttons, workspaces, and editing tools in one place. Select a topic to see what it does, how to use it safely, and what to check before continuing.
217 documented actions 14 languages Responsive on mobile and desktop
Dashboard and navigation 45 Announcements Shows current product, service, safety, and release announcements newest first; unread entries are highlighted. Back Returns to the Profile screen without changing settings that you did not edit. Changes already applied on this screen remain saved. Cancel outgoing transfer Cancels the active outgoing transfer before the recipient imports it, cleans up the private package, and safely releases the one-transfer lock. Clear notification history Removes locally stored in-app notification history. Cloud vault Opens the Premium account’s private Cloud Vault. Up to three signed macro backups can be uploaded, replaced, deleted, and restored on another device signed in with the same Firebase UID; it is not continuous sync. Create macro Opens the macro creation flow where you can start from a template or an empty project. Create your first macro When the library is empty, lets you choose a template or a blank Code Editor or no-code workspace project. Delete cloud backup Permanently removes this backup from the account’s cloud vault. It does not delete copies already stored on any device. Delete selected macros Opens deletion confirmation for macros selected on Home; only selected entries are targeted. Edit macro guide Opens the guide editor for this macro so you can write, format, preview, and save its setup and usage instructions. Forum Opens the community forum. Browse topics, create a new topic, write replies, and follow help or macro-sharing discussions. Home Opens the main screen where you manage macros. From here you can open code or no-code workspaces, review macro status, and quickly check permissions and notifications. Import Downloads and verifies this account-owned signed backup, then runs the normal import security review before changing local data. Import macro Opens Android’s file picker for a Macro Handler archive and validates the package before importing it. Import transfer Downloads the pending package through a short-lived link, verifies ownership, signature, digest, and macro identity, then runs the standard sensitive-content review. The transfer is acknowledged only after the local import succeeds. Language Opens the 14-language selector. Choose a language to apply it across the app immediately; this does not change your device language or translate text stored inside a macro. Macro favorite Adds the macro to Favorites or removes it from that shortcut list without modifying project content. Macro settings Opens the selected macro settings, including its app target, display profile, triggers, and run options. Macro to send Selects which local macro will be packaged for transfer. The selected macro is prepared as a signed ZIP; shared or restricted macros cannot be transferred again. Macro Transfer Sends one signed macro to one registered recipient account by email as a Premium transfer. Only one outgoing transfer remains active at a time; it closes when the recipient imports or rejects it, the sender cancels it, or it expires. Macro Transfer Sends one signed macro package to another Premium user signed in with a verified Google account. A second outgoing transfer cannot start until the recipient imports or rejects the package, or the transfer is cancelled. Manage subscription Opens Google Play subscription management for the account used to purchase Premium. Cancellation and billing changes are completed in Google Play; they do not remove access already paid for before its entitlement end date. News Shows release notes, product announcements, and maintenance notices. Review new features and behavior changes here before using them. Notification details Opens the community or moderation screen linked to an actionable notification. Notifications Opens recent in-app community, moderation, account, and service notifications. Open Code Editor Opens the Lua source of an owned, editable macro after the editor access checks. Open moderation reports Opens notification history filtered to community moderation reports awaiting review. Open no-code workspace Opens the selected macro in Visual Builder so you can create and arrange automation blocks without writing code. Open profile settings Opens Profile settings, where you can change the app language, theme, control-panel sizing, diagnostics, legal content, and privacy-related options. Permission and service status Opens the live readiness checklist for overlay, accessibility, screen capture, notification, and background requirements. Permission requirement Opens the Android or app setting for this requirement and allows its status to be verified when you return. Profile Opens Profile, where you manage your account, Premium access, theme, language, app settings, and legal content. Recipient Google email Identifies the receiving Macro Handler account by its verified Google email address. The address is used only to resolve the account on the server; the raw email is not stored in the transfer record. Refresh transfers Reloads the latest incoming and outgoing transfer states with a one-shot, paged request. It does not open a live listener, keeping Firebase reads and battery use bounded. Reject transfer Rejects the pending macro without importing it and removes it from the recipient queue. The server cleans up the private package object and lets the sender start another transfer. Release notes Shows improvements and fixes included with each Macro Handler version. Scroll to compare releases. Replace Safely replaces this cloud slot with the current macro after confirmation. The previous cloud version is removed; the device copy is unchanged. Retry news loading Retries loading the selected Announcements or Release Notes list after a network or cache error. Run macro Runs the selected macro after its access, permission, and safety checks. Use the control panel to follow or stop the run. Send Gift Opens the secure gift purchase flow. Enter another registered user’s email, choose one month of Premium or Badge access, then confirm through Google Play. You cannot send a gift to yourself, and delivery occurs only after Google Play verifies the payment. Send macro Validates the selected macro, uploads its signed package through a short-lived secure link, and creates a pending transfer for the recipient. Incomplete uploads are never offered to the recipient. Share Opens the area for private, public, and shared macros. Use it to reach import, user sharing, public-macro, and gallery workflows. This device Export saves the current macro as a signed ZIP on this device; import opens a local signed ZIP for verification and security review. This path does not sync to the cloud or send the macro to another user. Upload current macro Uploads the current signed macro into a free private cloud slot. Shared or restricted macros are excluded, and the package must stay within 15 MiB. View macro guide Opens the saved setup and usage guide in reader mode. Edit the guide from Macro Settings. Cancel profile rebase Dismisses the rebase confirmation without changing coordinates or the device profile. The staged work area remains available for review until it is separately saved or the panel is closed. Capture screen region Hides transient controls and lets you select a screen region to save as a reusable image template. Close work-area panel Closes the work-area editor. If a selected region or Full Screen reset has not been saved, it drops that staged change while leaving the previously saved configuration intact. Emergency stop Immediately requests termination of the active MH-AI or autopilot run and interrupts subsequent planned actions. It cannot roll back taps, text entry, or app operations that already completed. Game area settings Opens the game-area and display controls used to align overlay automation with the active screen. Humanize gestures While a macro is running, cycles the active macro through off, low, medium, and high gesture variation levels. Minimize control panel Collapses the control panel into its floating bubble without stopping the current macro. Tap the bubble to restore the panel. Minimized control bubble Tap to restore the control panel, or drag to reposition the bubble. For an emergency stop, hold and release before Help opens; keep holding to open this explanation without stopping the macro. Open control tools Tap to open or close the auxiliary rail for screen capture, color picking, gesture recording, gallery, and touch debugging. Hold and release to minimize the panel; keep holding to open this explanation instead. Open MH-AI Opens the assistant for the active editable macro so you can ask for analysis or supported workflow changes in context. Pause or resume macro Pauses a running macro without ending its session. Tap again to resume from the paused state. Pick screen color Opens the on-screen color picker so you can sample a pixel and save its color for visual automation. Rebase work-area profile Creates a new reference profile for the current device and selected work area, proportionally transforms every no-code project coordinate from the old workspace into the new one, and saves the project and configuration together. Record gestures Starts or stops touch recording. The captured taps and swipes can be reviewed and reused as a Replay. Reset to full screen Stages the entire display as the work area. This action does not save by itself; the new bounds become persistent only after you use Save. Runtime screen dimming While a macro is running, cycles through the available dim levels to reduce glare without changing the captured automation coordinates. Save work area Persists the staged x, y, width, and height with the display profile, updates the active runtime area, and closes the panel. Select work area Opens the screen picker seeded with the current work area. You can drag the region, resize it from the corners, or scale it with two fingers; the result remains staged until you press Save. Start or stop macro Starts the active macro when idle. While it is running, the same control stops execution safely and updates the panel state. Stop and close panel Stops the current runtime, hides the control panel, and closes its overlay service. Use this when you are finished with the session. Touch debugging Shows or hides the runtime touch and swipe debug overlay so you can verify where automation gestures are being sent. Add Block button Opens the block catalog for the current workspace. Search or filter a block, check its behavior with the info action, then add it to the active branch or group. Add dialog field Opens the field catalog to add input, choice, media, layout, or other supported controls to the current page. Add dialog page Adds a new page and makes it the active page for newly added fields. Add this block Adds this block to the active branch, group, or root workspace. Review its required values after insertion. Add variable Opens the variable menu to create a value variable, code variable, or variable group in the current scope. Back to workspace Returns from the current builder subview to its parent workspace without deleting its content. Bind a variable Links this field to a compatible variable so its runtime value is used. Use the same control again to review or clear the link. Block information Explains what this block does, which values it expects, and any requirements to check before adding it. Block issue Issue: Block issue Tap the badge to show the same message briefly, then open the block values and correct the highlighted setting. Block name Identifies this step in the workflow. Tap the name to focus its action buttons; use the pencil to rename it. Long-press the rest of the card to start selection. Block screen guide Shows or hides this block’s point or region guide on the screen. Hiding the guide does not delete its saved coordinates. Block value “Block value” identifies the setting beside it. Change the neighboring control to configure how this block runs; compatible fields can also accept a variable binding. Changes are saved automatically. Block values and quick-open mode Tap to open or close this block’s values. Hold to enable or disable quick-open mode for all block cards; keep holding to open this help without triggering a tap. Breakpoint Marks this block as a debug pause point. It takes effect when the macro runs in debug mode. Choose a variable Selects a compatible project variable and inserts its reference into this field. Clear current scope Removes all blocks from the visible workspace scope; use undo if you need to restore the recorded state. Close no-code panel Closes the centered auxiliary panel and returns to the no-code workspace. It does not close the project or No-Code Workspace, and it does not execute any block. Close search Hides the block search field without removing or changing any blocks. Close workspace Closes the no-code workspace; editor persistence keeps the current project state for the next open. Compact field layout Toggles the focused dialog field between standard and space-saving compact layout. Copy item Copies the focused or selected builder item so it can be pasted without changing the original. Delete dialog page Deletes the current page and its fields. The last remaining page cannot be deleted. Delete item Deletes the focused or selected builder item. Review the target before using this destructive action. Delete selection Deletes the blocks currently selected in selection mode; unselected blocks are not affected. Dialog condition Controls whether this block runs by evaluating values collected from a macro dialog. Dialog field details Opens the selected dialog field's label, type, default value, variable binding, layout, and validation properties in one focused editing surface. Dialog page mode Switches between a single combined dialog and separate page presentation. Enable or disable block Turns this block on or off without deleting it. Disabled blocks remain in the project but are skipped when the macro runs. Enter group Opens this group so you can view and edit the blocks inside it. Use the workspace back control to return to the parent level. Exit selection mode Leaves multi-selection mode without deleting or moving the selected items. Favorite blocks Shows your starred blocks for faster access. Turning the filter off returns to the complete block catalog. Favorite this block Adds or removes this block from your favorites. It does not change blocks already placed in the project. Field action Tap once to run “Field action” or open its related picker/editor. Any selection or edit is applied to the corresponding block field and saved automatically. Field note Adds or edits a private builder note for the focused dialog field. The note is not shown to macro users. Field settings Opens the detailed settings for this point, region, search target, or related field without changing its current value. Find and replace Finds matching values in the current project and lets you review replacements in the dedicated panel. Group folders Opens group-folder navigation so you can enter or manage a reusable project scope. Import from library Opens the shared library filtered for the current item type and imports the entries you choose. Import from shared library Opens the reusable block library and inserts the selected item into the current branch, group, or root workspace. Move between groups Picks up the focused or selected items so you can place them in another compatible group or page. Move down Moves the focused or selected item one position later in the current list. Move selection Picks up selected blocks for placement into another compatible group, branch, or workspace scope. Move selection down Moves selected blocks one valid position later inside their current parent scope. Move selection up Moves selected blocks one valid position earlier inside their current parent scope. Move up Moves the focused or selected item one position earlier in the current list. No-code quick navigator A tap opens destinations for Project Map, Blocks, Dialog, Variables, Actions, and Groups; dragging persistently repositions the control, while a stationary hold opens this help. Paste item Pastes the copied compatible items into the current group, page, or list. Pick a value Selects a compatible coordinate, region, media item, replay, image, or color from the source offered by this field. Preview dialog Opens a live preview of the macro dialog so you can check fields, pages, defaults, and visibility rules. Project loop The checkbox enables a continuous project loop; with it off, the adjacent count sets a finite number of runs. Redo Reapplies the next recorded project state after an undo when redo history is available. Rename block Opens inline name editing for this block. Enter a clear workflow name and confirm with the keyboard; the change is saved automatically. Rename dialog page Changes the user-visible name of the active dialog page while preserving its fields, page order, and internal identity. Replace block Replaces this block with a compatible block while preserving transferable values where possible. Save selection to shared library Stores selected blocks as a reusable shared-library item without deleting them from the project. Screen guides Shows or hides point, region, and swipe guides while you configure visual automation; it does not delete saved guides. Search blocks Shows the search field and filters the visible block list without changing the project. Send to library Saves the focused or selected reusable items to the shared library for later use. Show dialog at startup Toggles whether this dialog is shown automatically when the macro starts. Test this block Runs only this block as a focused preview so you can verify its values before running the full macro. Test visible scope Runs only the branch or group currently shown. Use it to verify a focused section before running the complete macro. Transfer to Code Editor Validates the no-code project, generates Lua, and prepares it for the Code Editor without bypassing overwrite safeguards. Undo Restores the previous recorded Visual Builder project state when undo history is available. Variable details Opens a focused detail surface where you can inspect and edit the selected variable's name, type, scope, initial or current value, and linked block references. View generated code Validates the current project and previews the Lua generated by the no-code workspace. Workspace settings Opens Visual Builder settings and diagnostic options for this editing workspace. Workspace tools Shows or hides search, find and replace, undo, redo, generated-code preview, and clear actions. Choose this value Selects this compatible value for the code token currently being prepared. Clear editor Removes all text from the editor. Use Undo before leaving the editor if you need to restore it. Close Code Editor Closes the editor through its save-safe exit flow. If the latest changes cannot be saved, the editor remains available for recovery. Close search Hides the code search bar and returns focus to the editor. It does not change the script. Close snippet library Returns to the code editor without inserting or deleting a snippet. Close value picker Closes this picker without inserting a new code value. Compatibility details Shows the APIs, permissions, or runtime features this snippet needs before you use it. Copy Copies the selected code. If nothing is selected, it copies the complete script. Copy snippet Copies this snippet to the system clipboard without changing the editor. Cut / Move Removes the selected code and keeps it in the editor move buffer for the next Paste action. Discard editor changes Closes the Code Editor and drops changes that have not been saved. The last saved macro source remains unchanged. Filter snippet category Shows snippets from this category. Your code and current editor selection remain unchanged. Find next match Searches from the current position and selects the next matching result without changing the code. Import text file Loads a supported text, Lua, or JSON file into the editor after a size check. It replaces the current editor text, so review unsaved work first. Insert code value Converts the selected point, region, image, template, or value into valid code and inserts it at the cursor. Insert gallery asset Opens the macro gallery so you can choose an image or template and insert a safe code reference at the cursor. Insert snippet Inserts this snippet at the current selection or cursor after the editor safety checks. Line end Moves the cursor to the end of its current line without changing the script. Line start Moves the cursor to the start of its current line without changing the script. Paste Inserts the pending move buffer first; otherwise inserts clipboard text at the selection or cursor. Quick tools Shows editor actions for copy, clear, select, undo, redo, move, paste, and cursor navigation. Redo Reapplies the next recorded editor state after an undo when redo history is available. Save and close editor Validates and saves the current Lua source, then closes the Code Editor. If saving fails, the editor remains available for correction. Save and insert value Validates the entered value, saves it when required, and inserts the resulting code token. Scroll down Scrolls downward by several lines. Keep it pressed to continue scrolling; double-tap to jump to the bottom. Scroll up Scrolls upward by several lines. Keep it pressed to continue scrolling; double-tap to jump to the top. Search in code Opens the search bar. If it is already open, the same action moves to the next match. Select all Selects the complete script so the next copy, cut, or typing action can target it. Snippet library Opens searchable, categorized code snippets. Review a snippet, then copy it or insert it at the current selection or cursor. Undo Restores the previous recorded editor state when undo history is available. Cancel gallery dialog Dismisses the open gallery confirmation or editor dialog without applying its pending action. Gallery files, the current item, and the selection remain unchanged. Close gallery Closes the gallery without deleting any saved item. Copy item Copies this item name to the system clipboard. Delete item Deletes the selected item. Template images may show deletion options first; other items are deleted directly. Edit item Opens the appropriate editor for this image or color item. Import image Imports a new visual template from the device into this gallery. Import shared item Imports the selected template, color, or Replay from the shared library into the current macro. Manage templates Opens the full template manager for browsing and maintaining saved visual assets. Open shared library Opens the reusable shared library for gallery items. Pick gallery template In picker mode, returns the tapped image-template identifier to the requesting field and closes the gallery. It does not copy, edit, or duplicate the item. Save to shared library Copies this item into the reusable shared library. Background controls Uses the sampled corner color and tolerance to remove a matching background. Preview the result before saving. Cancel color edit Discards the current HSV and hex adjustments and returns. Cancel image edits Closes the editor without saving the current changes. Cancel region capture Closes the capture overlay and live preview, clears any pending replacement, and reports cancellation without creating a new image template. Cancel screen picker Closes the screen-region picker without returning new coordinates or a new shape, then restores the calling workspace. Close color editor Closes without changing the saved swatch. Close image editor Closes the image editor without saving the current changes. Confirm screen region Validates the selection width and height, converts the visible frame into raw display coordinates, and returns x, y, width, height, and the normalized shape to the calling tool. Crop controls Adjusts the crop area with presets and the X, Y, width, and height controls. Cycle search-region shape Cycles the search mask through rectangle, rounded rectangle, ellipse, and triangle. The bounding box can stay unchanged, but only pixels inside the selected shape participate in matching. Live capture preview Turns the repeating screen feed and frame-rate indicator behind the picker on or off. It is a framing aid only; the preview itself is not saved as a template. Mask brush Switches the mask brush between adding and erasing mask areas. Mask tools Builds a mask automatically, inverts the current mask, or clears it for a fresh start. Reset edits Restores the image editing values to their initial state. Save captured region Captures the exact selected display region through the screen-capture pipeline and creates a new template from those pixels, or updates the current template in a replacement flow. Save color Validates and saves the edited color value, then refreshes the gallery. Save image Validates and saves the result atomically. A name conflict is reported instead of overwriting another item. Tone controls Adjusts grayscale, brightness, contrast, and sharpening. Rapid changes use a bounded latest-only preview pipeline. Transform controls Rotates the image or flips it horizontally or vertically. Back to event list Returns to the event list without applying the current event edits. Cancel Replay naming Closes the naming screen and discards the newly captured but unsaved Replay session. Older recordings in the library are not affected. Convert to blocks Converts the selected recording into editable click, swipe, wait, and multi-touch blocks. Delete event Deletes only this event from the editable recording. Edit event Opens the position and timing controls for this recorded event. Move event down Moves this event one valid position later in the recording order. Move event up Moves this event one valid position earlier in the recording order. Open Replay editor Opens event-level timing, position, and order editing for the selected recording. Pause or resume Replay recording On pause, it closes active pointer gestures, temporarily disables touch capture, and excludes the paused interval from timing; Resume starts collecting events again. Pick point from screen Lets you select a reference point on screen and maps it safely into the recording coordinate space. Save event Validates the edited timing and position, then saves this event. Save Replay recording Writes the events from the stopped session to the Replay library under the entered name, or an automatically generated name when blank, together with the recording display profile. Select recording Opens saved recordings and assigns one to this Replay block. Stop Replay recording Safely drains active pointer gestures and ends the recording session. If at least one event exists, it opens the naming screen; this step does not persist the recording yet. Accessibility-only screen capture When enabled, visual blocks capture only through accessibility and Android does not show screen-recording consent. It can be slower than MediaProjection. App theme Selects one of eight coordinated light-to-dark theme tones and updates supported panels immediately. Macro behaviour is unchanged. Blocked users Manages people you blocked in community areas. Unblocking permits future visibility and interaction; it does not restore content that was previously removed. Cancel secret entry Closes the masked secret-entry prompt, drops the typed text, and returns without unlocking or running the protected macro or action. Confirm secret Trims the value in the masked field, hashes it on the device, and compares it with the stored secure hash. The protected operation continues only when the correct value matches. Diagnostic reports Turns optional anonymous crash and technical diagnostic reporting on or off. The choice applies immediately. License agreement (EULA) Opens the localized end-user licence agreement explaining the software licence and usage limits. Press-and-hold help for app actions Standard action buttons across the app show concise guidance on press and hold using the selected language and theme. A single tap performs the action, while controls with dedicated guidance show more detailed usage steps. Privacy policy Opens the localized Privacy Policy packaged with the app and explains how data and permissions are handled. Terms of service Opens the localized Terms of Service covering account, purchase, community, and acceptable-use conditions. Open button list Press-and-hold help for app actions › General actions
Press-and-hold help for app actions app-action Standard action buttons across the app show concise guidance on press and hold using the selected language and theme. A single tap performs the action, while controls with dedicated guidance show more detailed usage steps.
1 Open the screen that contains this control: Press-and-hold help for app actions.
2 Tap the control once to apply the action or open its related picker.
3 Verify completion by checking the opened screen, selected value, and resulting status message.
Before you continue Before confirming, check the active selection, screen state, and the target the action will affect.