Configuration Guide & Usage
Learn how to configure your KeyPad and use all its features effectively
Summary
Select a section below to jump directly to that part of the guide.
Color Configuration
How to Configure Colors
Step 1: Select Wanted Preset
Use the round knob in the main panel to select the preset you want to configure.
Select the correct preset before editing colors so changes apply to the intended profile.
Step 2: Access Configuration Panel
Click the top right menu icon to open the right panel configuration interface.
The right panel contains four configuration tabs: Preset Name, Icon Actions, Button, Glow.
Step 3: Navigate to Glow Tab
Click on the "Glow" tab to open color setup controls.
This tab includes two color areas: "Preset color" (configured per preset) and "Configuration" (global color behavior).
Step 4: Choose What to Configure
Select either "Preset color" or "Configuration", then use the RGB color selector to apply colors.
Both areas use the same RGB color selector interface.
In the "Configuration" area, you can set:
- • Button press color
- • Recording color
- • Start-up color
- • Disconnected color
- • Macro running color
- • Waiting color
Macro Builder Guide
Understanding Macro Blocks
Available Block Types
ACTIONS
Clicks on user previously captured coordinates using one of three modes: left click, right click, middle click
Presses at the captured start point, drags to the defined end coordinates, and releases for smooth click-drag actions
Executes user previously defined keypress combinations or single key presses
Types user-defined text into the currently focused input field or application
Starts a user-selected program or application from its file path or executable name
Opens a user-specified folder in file explorer at the defined directory path
WINDOW CONTROL
Activates and brings to front a window by matching its title text with user-defined criteria
Searches for windows by title text and returns True if found, False if not, for conditional logic
Checks if a user-defined window is currently focused and returns True when focused, False when it is not and is used inside an If Condition block.
LOGIC
Executes different blocks based on conditional blocks (If window is found, then [action], else [alternative action]).
Loops through contained blocks for a specified number of iterations
Executes contained blocks in a continuous loop while the assigned toggle button is active; pressing the same button again stops the loop.
TIMING
Pauses macro execution for a user-defined duration in seconds
SCRIPTS
Executes external user-specified scripts
TEMPLATES
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.