Windows Commands

Searches for a window by title or process name and saves its window handle (HWND) into a variable.

The returned handle is a number (HWND) that uniquely identifies the window. Pass this handle to other Window commands instead of a title for more reliable targeting — especially useful when multiple windows have similar titles.

If no matching window is found, the saved value will be 0.

Window Handle vs. Title:

Example flow:

1. Use Window: Find with “By Title” and "Notepad" → saves handle to myHandle
2. Use Window: Minimize with /$myHandle$/ → minimizes that exact window

Minimizes a window to the taskbar.

You can pass either a partial window title as a string, or a numeric window handle retrieved from the Window: Find command. Using a handle is more reliable when multiple windows share the same title.

Maximizes a window to fill the screen.

You can pass either a partial window title as a string, or a numeric window handle retrieved from the Window: Find command. Using a handle is more reliable when multiple windows share the same title.

Restores a minimized or maximized window to its previous normal size and position.

You can pass either a partial window title as a string, or a numeric window handle retrieved from the Window: Find command. Using a handle is more reliable when multiple windows share the same title.

Sends a close request to a window, equivalent to clicking the X button.

This sends a WM_CLOSE message to the window. Most applications will prompt to save unsaved work before closing. To force-terminate a process without a close dialog, use Process: Kill instead.

You can pass either a partial window title as a string, or a numeric window handle retrieved from the Window: Find command.

Brings a window to the foreground and gives it keyboard focus.

If the window is minimized, it will be restored before being focused. Useful for ensuring a specific application is in the foreground before sending keyboard input via Keyboard Simulate Press.

You can pass either a partial window title as a string, or a numeric window handle retrieved from the Window: Find command.

Hides a window from the screen and taskbar without closing it.

The application continues to run in the background. Use Window: Show to make it visible again. The window will not appear in the taskbar while hidden.

You can pass either a partial window title as a string, or a numeric window handle retrieved from the Window: Find command. Using a handle is recommended since the window cannot be located by title once hidden.

Makes a previously hidden window visible again.

Restores the window to its normal state after it was hidden with Window: Hide. Use a window handle stored before hiding, since hidden windows cannot be found by title.

Moves a window to the specified X/Y position on screen.

Position 0, 0 is the top-left corner of the primary monitor. Negative values or values beyond the screen resolution move the window off-screen or onto secondary monitors.

The window size is not changed, only its position.

Resizes a window to the specified width and height in pixels.

The window position is not changed, only its size. Some applications enforce minimum or maximum sizes and may not honor all values.

Retrieves the title, position, and size of a window and saves them as an object.

Use Object Get Variable to read individual fields from the returned object.

Saved Payload:

Example SAMMI Response Object:

{
  "title": "Untitled - Notepad",
  "x": 100,
  "y": 200,
  "width": 800,
  "height": 600
}

Enables, disables, or toggles the always-on-top state of a window.

When set to always-on-top, the window stays visible above all other windows, including maximized ones. This is equivalent to right-clicking a window’s title bar in some apps and choosing “Always on Top”.

Returns the title of the currently focused (active) window.

The saved value is the full window title string of whatever window currently has keyboard focus. Returns an empty string if no window is focused.

Useful for checking which application the user is currently in, or for branching logic based on what is active on screen.

Checks whether a process with the given name is currently running and saves the result as a boolean.

The check is case-insensitive. Returns true if at least one instance of the process is running, false otherwise.

Saved Value:

Example: Check if OBS is running by entering obs64.exe as the process name.

Forcefully terminates a process by name or PID.

This immediately and forcefully kills the process — there is no save prompt. Use Window: Close if you want to give the application a chance to save before exiting.

If multiple processes share the same name, all matching instances will be terminated. Use a PID for precise targeting.

Example: Provide notepad.exe to kill all Notepad windows, or a specific PID like 1234 to target only one instance.

Returns an array of all currently running processes and saves it into a variable.

The saved value is an array of objects. Each object contains information about one running process. Use Array Get Variable or Object Get Variable to read individual fields.

Each array entry contains:

Example SAMMI Response:

[
  { "name": "notepad.exe", "pid": 1234 },
  { "name": "obs64.exe", "pid": 5678 }
]

Returns the current Windows master volume level as a number between 0 and 100.

The saved value is the current system-wide master volume as an integer from 0 (muted/silent) to 100 (maximum).

This reads the Windows master volume, not the volume of a specific application. Use the OBS volume commands for OBS-specific audio control.

Sets the Windows master volume level.

Values are clamped to the range 0–100. This changes the system-wide master volume and affects all audio output. Setting this does not affect the mute state — use System: Set Master Mute to control muting separately.

Returns the current Windows master mute state as a boolean.

Saved Value:

This reads the Windows master mute state. Muting does not change the volume level — use System: Get Master Volume to check the current volume separately.

Enables, disables, or toggles the Windows master mute state.

Muting does not affect the volume level. Use System: Set Master Volume to control volume separately.

Returns an array of all available Windows audio output device names.

The saved value is an array of strings, where each entry is the name of an available audio output device.

Example SAMMI Response:

[
  "Speakers (Realtek Audio)",
  "Headphones (USB Audio Device)",
  "HDMI Output (NVIDIA High Definition Audio)"
]

Sets the audio volume (0–100) of a specific running application’s audio session.

The Process Name dropdown lists all applications that currently have an active audio session. Only these applications are supported — if your target app is not in the list, it may be using an audio API that is not compatible.

Typical workflow:

1. Open the command and check the Process Name dropdown for your target application.
2. Enter the desired volume (0 = mute, 100 = full volume).