﻿================================================================================
                     USER MANUAL: USER ACTIVITY EMULATOR (UAE)
================================================================================

OVERVIEW
--------
User Activity Emulator (UAE) is a category of specialized software designed 
for automated testing and reproducing user behavior (such as UI/E2E testing and 
stress testing). It automatically switches between applications, types text, 
and moves the mouse, while also offering the ability to record and play back 
actions.


PORTABLE INSTALLATION
---------------------
1. Extract the portable_uae_x_x_x.zip archive into any directory of your choice 
   (e.g., C:\Tools\UAE\).
2. Run uae.exe. The application is portable and requires no administrative 
   privileges or installation.


================================================================================
1. SCENARIO CONFIGURATION (SCENARIOS TAB)
================================================================================
The Scenarios tab allows you to create, edit, and remove predefined automation 
tasks (such as mouse movements, text typing, or stealth mouse background activity).

Creating a Scenario:
1. Click "Add" in the top menu.
2. Enter a scenario title in the "Scenario Name" field.
3. Select one of the primary action types:
   * Move Mouse: Emulates mouse cursor movement. Includes options for performing 
     a prior mouse click at specified coordinates (X, Y) using either the left 
     or right button.
   * Type Text: Emulates keypresses from a text file. Specify the target text file 
     path, configure up to two optional pre-clicks, and select a document 
     navigation command (e.g., Ctrl + End).
   * Stealth Mode: Background mouse movement and safe click in a non-interactive/
     hidden area (without triggering any interface elements or unwanted clicks), 
     configured with a specific time interval in seconds.
4. Click "Save" to preserve the scenario configuration.


================================================================================
2. APPLICATION SETUP & EXECUTION (APPLICATIONS TAB)
================================================================================
The primary Applications tab binds target windows to scenarios and controls 
overall execution parameters.

Configuring Target Applications:
1. Click "Browse" next to an application slot to select an active window.
2. Click "Select Scenario" to bind the target window to a configured scenario 
   (e.g., Stealth Mode or Type Text).
3. Click "Clear" to remove an entry line.

Execution Parameters (Settings):
* Run Duration: Total execution time for the automation cycle (in minutes). 
  Enabling "Random" introduces a randomized duration range.
* Delay Before Switch: Pause duration before switching to the next application 
  in seconds. Enabling "Random" applies a randomized delay interval.
* Loop: Continuously repeats the target application sequence.
* Ensure Window Focus During Execution: Forces the target window to the 
  foreground before performing actions.

Controls:
* Start (Ctrl+F5): Begins the automation sequence.
* Stop  (Ctrl+F6): Halts the automation sequence.


================================================================================
3. ACTION RECORDING & PLAYBACK (RECORDER TAB)
================================================================================
The Recorder module logs real-time user inputs and plays them back as automated 
macros.

Recording Options:
Enable (On) or disable (Off) tracking for specific input events:
* Keyboard: Keypresses and keyboard input.
* Mouse Move: Cursor path and movement.
* Mouse Clicks: Mouse button events.
* Switch Applications: Window focus and application switching.

Recording & Playback Controls:
* Record (Ctrl+F7) : Starts capturing user input.
* Finish (Ctrl+F8) : Ends input capture.
* Play   (Ctrl+F9) : Executes the recorded macro. Check "Loop" to repeat 
                     playback continuously.
* Stop   (Ctrl+F10): Stops macro playback.


================================================================================
4. GLOBAL CONFIGURATION (SETTINGS TAB)
================================================================================
The Settings tab customizes system behavior and interface settings:

* Minimize to System Tray: Sends the application to the system notification area 
  when minimized.
* Minimize on Play / Record: Automatically minimizes UAE whenever recording or 
  playback begins.
* Show Status Overlay: Displays an on-screen status banner during execution.
* Always on Top: Keeps the UAE window pinned above all other application windows.
* Turn Off All Events at: Schedules an automatic shutdown of all emulation 
  activities at a specified time (hours/minutes).
* Window Title: Customizes the main window header text.
