Configuration Guide & Usage

Learn how to configure your KeyPad and use all its features effectively

Button Configuration

How to Configure Buttons

Step 1: Access Configuration Panel

Click the top right menu icon to open the right panel configuration interface.

The right panel contains three configuration tabs: Preset Name, Icon Actions, and Button.

Step 2: Navigate to Button Tab

Click on the "Button" tab to access button selection and configuration options.

This tab provides a dropdown menu where you can select one of the 9 available buttons.

Step 3: Select Target Button

Use the dropdown to select the specific button you want to configure (1-9).

When a button is selected, the corresponding button in the 9-button grid will be highlighted to show which one is currently being configured.

Step 4: Choose Function Type

Set Shortcut

Configure keyboard shortcuts for rapid command execution

Set Alt Symbol

Define custom unicode characters and special symbols

Open Application

Launch specified applications or executable files

Open Folder

Access designated directory paths in file explorer

Macro Actions

Advanced macro editor for creating complex automation sequences

Macro Builder Guide

Understanding Macro Blocks

Available Block Types

ACTIONS
Click

Clicks on user previously captured coordinates using one of three modes: left click, right click, middle click

Press

Executes user previously defined keypress combinations or single key presses

Type Text

Types user-defined text into the currently focused input field or application

Launch App

Starts a user-selected program or application from its file path or executable name

Open Folder

Opens a user-specified folder in file explorer at the defined directory path

WINDOW CONTROL
Focus Window

Activates and brings to front a window by matching its title text with user-defined criteria

Check Window

Searches for windows by title text and returns True if found, False if not, for conditional logic

LOGIC
If Condition

Executes different blocks based on check window condition. If window is found, then [action], else [alternative action]

Repeat

Loops through contained blocks for a specified number of iterations

TIMING
Wait

Pauses macro execution for a user-defined duration in seconds

SCRIPTS
Run Script

Executes external user-specified scripts

TEMPLATES
Template

Calls pre-saved macro templates containing multiple blocks, functioning as reusable automation functions

Building Macros

Drag & Drop Interface

Drag blocks from the toolbar to the macro workspace. Arrange them in the order you want them to execute.

Block Configuration

Click on any block to configure its parameters. Each block type has specific settings you can adjust.

Testing & Debugging

Use the test button to run your macro and see how it behaves. Use the step-through feature to debug complex macros.

Templates & Nesting

Working with Templates

Nesting Macros (Templates)

Macro within Macros

Create complex workflows by calling one macro from within another using templates. This allows for modular and reusable automation.

Template Nesting

Templates can reference other templates, creating a hierarchy of configurations for complex setups. Save your macro configurations as templates for reuse.

Import/Export

Sharing Templates

Export your templates as files to share with others or backup your configurations.

Best Practices & Tips

Configuration Tips

  • • Group related functions in the same mode
  • • Use descriptive names for your configurations
  • • Test macros thoroughly before using them in production
  • • Keep frequently used actions easily accessible
  • • Use templates to organize different workflows

Macro Building Tips

  • • Start simple and build complexity gradually
  • • Use wait blocks to ensure proper timing
  • • Test macros on different screen resolutions

Troubleshooting

Common Issues & Solutions

Macros Not Working

  • • Check if target applications are running
  • • Verify screen resolution hasn't changed
  • • Ensure macros aren't running too fast
  • • Test individual blocks to isolate issues

Button Not Responding

  • • Check if SinTuch application is running
  • • Verify hardware connection
  • • Ensure button is properly configured
  • • Check for conflicting software

Script Execution Issues

  • • Check script file paths are correct
  • • Test scripts manually first

Ready to Start Configuring?

Now that you understand the basics, start configuring your KeyPad to match your workflow.