PowerX Keys: Master Guide (Static Reference)

Welcome to the offline blueprint for PowerX Keys. Since you have JavaScript disabled, this is a plain text version of our documentation covering dashboard controls, triggers, timeline editing, action blocks, and core features.

1. The Command Center (Dashboard Controls)

Getting Started in 60 Seconds

Step 1: Create a Macro: Click the ➕ "Add Macro" button on the dashboard.
Step 2: Record or Build: Hit the Record button to capture your actions live, or drag blocks manually.
Step 3: Assign a Hotkey: Bind a keyboard shortcut and hit Start Engine. Press your hotkey anytime to run the macro!
Tip: Press F1 inside the editor to see a cheat sheet of all keyboard shortcuts.

Dashboard Controls

Add Macro Binding: Generates a new, empty macro workspace on your dashboard.
Bind Hotkey: Locks in your physical keyboard or mouse trigger (like CTRL+G or Mouse Button 4).
Reset Target: Erases the saved hotkey trigger, leaving the macro steps intact.
Start Engine: The master toggle switch that wakes up or disables the invisible background shortcut engine.
Run Macro (Test): Allows you to test a single macro instantly from the dashboard.
Favorite (Star): Pins your most-used macros to the top of the dashboard.
Filter Saved Macros: Hides all un-starred macros to declutter your dashboard.
Emoji Icon Picker: Lets you personalize each macro card with a custom emoji.
Visual Keyboard: Shows your active hotkeys on a beautiful interactive keyboard.
App Zoom / Scaling: Lets you resize the entire app to fit your screen perfectly.
Redesigned Macro Cards: Each macro card now looks premium and informative at a glance.
Master Kill Switch: Instantly stops ALL running macros in an emergency (Double ESC).
Duplicate Macro: Creates an exact copy of any existing macro.
Custom Profiles: Lets you organize your macros into separate profiles.
Hotkey Conflict Detection: Prevents hotkey clashes while still allowing advanced multi-binding.
Macro Import / Export: Share or back up your macros as files.

Trigger Modes

Single (Default Press): Standard trigger mode; one press runs the macro once.
DoubleTap: Requires two quick presses in rapid succession.
Hold: Activates while you are holding the hotkey down.
Release: Fires the macro when you release the key.
LongPress: Triggers only after holding the key for a longer time.
Toggle: Cycles through different actions each time you press the hotkey.
ScreenEvent: Auto-triggers when something appears on your screen.
Schedule: Runs your macro automatically on a repeating timer.
MobileRemote: Triggers the macro from your phone via the remote interface.

Pre-Built Actions

Media Controls: Volume up/down, mute, and playback controls.
Browser Tabs/Navigation: Quickly switch tabs, go back, or go forward.
System Navigation: Switch between virtual desktops instantly.
Quick Actions: Common system shortcuts like Lock PC, Screenshot, and Show Desktop.

App Scope Mode

Global (All Apps): The macro hotkey works in all applications.
Include Mode: The macro ONLY works inside the apps you pick.
Exclude Mode: The macro works everywhere EXCEPT the apps you pick.

2. The Macro Studio (Timeline & Recording)

Recording & Timeline

Hover-Preview (Eye Icon): Displays a small preview of the screenshot referenced in an Image Search step on hover.
Undo / Redo (Ctrl+Z / Ctrl+Y): Full timeline history support up to 500 levels deep.
Smart View vs Raw View: Smart View merges modifier keys and hides micro-delays; Raw View shows every millisecond.
Unsaved Changes Guard: Safety warning prompt when attempting to exit the editor without saving.
Upgraded Capture Tool: Precision screen capture options with Pinpoint, Window Area, and Sticky selection modes.
Keyboard Shortcut Sheet (F1): Open a reference card listing all editor shortcuts.
Step Reordering (Ctrl+Up/Down): Shifting macro step positions on the timeline.
Lasso Multi-Select: Bulk select, move, or delete multiple timeline steps at once.
Live Builder Validation: Automatic timeline analysis to highlight errors before saving.

3. Action Blocks

Physical Inputs

Mouse Action: Simulates Click, Double Click, Right Click, Scroll, or Drag.
Keyboard Action: Presses a single key or types a long string of text.
Smooth Mouse Trace: Uses curve-smoothing technology to draw natural, flowing mouse paths instead of straight robotic lines.

Optical Targeting

Image Search (Pixel-Pattern Matching): Scans the screen for a specific visual target and click it.
Color Pixel Search: Jumps to and clicks a specific hex color code on the screen.

Logic & Organization

Condition Box (If/Else): Checks screen conditions or variables before running steps.
Loop Block: Repeats a group of nested steps a set number of times or while a condition is met.
Delay Action: Pauses the macro for a set duration (milliseconds or seconds).
Call Macro: Links macros together by triggering another macro from within the current timeline.

Smart Inputs & Launchers

App Launcher: Launches any .exe, document, folder, or website URL.
Type Text (Fast Paste): Pastes massive paragraphs instantly using the clipboard.

System Alerts & OS

System Notification: Shows a Windows Toast message with custom headers and text.
Wait For Key: Pauses macro execution until a specific physical key is pressed.

4. PowerX Core Features

The Invisible Engine

Instant Execution Mode: Keeps macros ready in memory for practically zero delay.
Stuck Macro Protection: Detects macros stuck in infinite loops and shuts them down within 3 seconds.
Smooth Mouse Trace: Uses curve-smoothing technology for natural, flowing cursor paths.

PowerX Intelligence (AI)

Always-Online AI: Connects to multiple AI providers. If one is busy, it automatically switches to another, with no account or login needed.
AI Daily Usage Tracker: Free daily tier of 15 requests resetting daily at midnight UTC. Tracked on the server.

Mobile Remote

Control From Your Phone: Connect via local network (Wi-Fi) to trigger macros remotely.
PIN Security: PIN authorization (default PIN: 1234) to protect your workstation from unauthorized remote access.
Volume & Soundboard: Embedded sliders for computer volume adjustment and soundboards.

5. Global Logic & Rules

Advanced Failsafes & Settings

Emergency Stop (Double ESC): Global failsafe to abort all running macros immediately.
Anti-Loop Protection: Built-in safety limits to prevent runaway recursive macro loops.
Block Collision Rule: Defines how macros handle simultaneous triggers (Queue, Cancel, or Intercept).

Data & Storage

Local File Storage: Keeps all macros securely saved in a local database inside your app folder.
Smart Coordinate Scaling: Scales mouse coordinates when importing macros built on different screen resolutions.

Troubleshooting

Macro Not Firing: Check that the Engine is started, hotkey is not conflicting, and the correct app is focused.
Image Search Failing: Increase tolerance, tighten search area, recapture if resolution changed.
Antivirus Flagging: Add PowerX Keys to your antivirus whitelist. The app uses standard Windows APIs.
App Running Slow: Enable Performance Mode, reduce search areas, organize macros into profiles.
Keys Getting Stuck: Double-tap Escape for Emergency Stop. Ensure every Hold Down has a matching Release Up.