neoSystem exposes Windows process, hardware, window, environment, clipboard, registry, service, shell, network, notification, audio, and screenshot operations to NeoScript.
Quick Start
. Execute without a console window. The fifth argument is an optional timeout.
neoSystemExecCapture "powershell.exe -NoProfile -Command Get-Date" "" "[Output]" "[ExitCode]" "5000"
AlertBox "Command output" "[Output]"
neoSystemGetMemory "[MemoryJson]"
neoSystemGetBattery "[BatteryJson]"
neoSystemGetDisplays "[DisplaysJson]"
JSON actions return compact JSON text. Use VisualNEO's JSON actions to inspect or format it.
Processes and Execution
| Action | Parameters | Purpose |
|---|---|---|
neoSystemExecCapture | command line, working directory, output variable, exit-code variable, timeout ms | Executes hidden and captures stdout plus stderr. Timeout 0 waits indefinitely; exit code -2 means timed out. |
neoSystemProcessList | JSON variable | Lists running processes. |
neoSystemProcessExists | executable name or PID, result variable | Returns True when a process exists. |
neoSystemProcessKill | executable name or PID, force | Terminates matching processes. |
Quote executable paths and arguments exactly as required by Windows. Treat command text as code: never concatenate untrusted input into a shell command. Process termination can cause data loss.
System Information
| Action | Parameters | Purpose |
|---|---|---|
neoSystemGetInfo | JSON variable | Returns Windows, architecture, processor, user, and uptime information. |
neoSystemGetMemory | JSON variable | Returns physical memory totals and usage. |
neoSystemGetDrives | JSON variable | Returns drive type, capacity, and free space. |
neoSystemGetBattery | JSON variable | Returns battery and AC status. |
neoSystemGetDisplays | JSON variable | Returns monitor bounds and work areas. |
Window Control
| Action | Parameters | Purpose |
|---|---|---|
neoSystemWindowSetTopmost | window title, topmost | Changes always-on-top state. |
neoSystemWindowMinimize | window title | Minimizes the selected window. |
neoSystemWindowMaximize | window title | Maximizes the selected window. |
neoSystemWindowBringToFront | window title | Restores and activates the selected window. |
neoSystemWindowFlash | window title, count | Flashes its taskbar button. |
An empty title targets the active window. Otherwise neoSystem first tries an exact title and then a case-insensitive partial title match.
Environment and Clipboard
| Action | Parameters | Purpose |
|---|---|---|
neoSystemGetEnv | variable name, result variable | Reads an environment variable. |
neoSystemSetEnv | variable name, value | Sets it for the current VisualNEO process. |
neoSystemClipboardGetText | result variable | Reads Unicode text from the clipboard. |
neoSystemClipboardSetText | text | Replaces clipboard contents with Unicode text. |
Environment changes affect this process and child processes only; they do not permanently change the user's Windows environment.
Power and Registry
| Action | Parameters | Purpose |
|---|---|---|
neoSystemPowerAction | action, force | Runs lock, logoff, sleep, hibernate, restart, or shutdown. |
neoSystemRegistryRead | root, key, value, result variable | Reads a string, expanded string, integer, or binary size. |
neoSystemRegistryWrite | root, key, value, data, type | Creates or writes string, expand, dword, or boolean. |
neoSystemRegistryDelete | root, key, value | Deletes one value; an empty value name deletes the key. |
neoSystemRegistryExists | root, key, value, result variable | Tests a key or value. |
Supported roots are HKCU, HKLM, HKCR, HKU, and HKCC, including their full names. Invalid roots are rejected. Registry and power operations may require elevation and can damage the system or lose work; do not expose them to untrusted input.
Windows Services
| Action | Parameters | Purpose |
|---|---|---|
neoSystemServiceStatus | service name, status variable | Returns Running, Stopped, Paused, or NotFound. |
neoSystemServiceStart | service name | Requests service start. |
neoSystemServiceStop | service name | Requests service stop. |
neoSystemServiceList | JSON variable | Lists installed services and current states. |
Start and stop return after Windows accepts the request; use neoSystemServiceStatus when the final state matters. Administrative privileges are commonly required.
Shell and Files
| Action | Parameters | Purpose |
|---|---|---|
neoSystemGetSpecialFolder | alias, result variable | Resolves Desktop, Documents, Downloads, AppData, LocalAppData, ProgramFiles, System, Windows, Startup, StartMenu, Fonts, Templates, SendTo, or Temp. |
neoSystemCreateShortcut | shortcut path, target, arguments, working directory, icon path, icon index | Creates a Windows .lnk file and its parent directory. |
neoSystemRecycleBinDelete | file or folder path | Sends one path to the Recycle Bin. |
neoSystemRecycleBinEmpty | show confirmation | Empties the Recycle Bin on all drives. |
neoSystemScreenshot | window title, output .png or .bmp path | Captures a window, or the desktop when the title is empty. |
Recycle Bin actions are destructive. Some protected or remote locations may not support undo. A captured window may differ from what is visible when Windows or the target application blocks off-screen capture.
Network
| Action | Parameters | Purpose |
|---|---|---|
neoSystemGetNetworkInfo | JSON variable | Returns host name, one resolved local IPv4 address, and Windows Internet status. |
neoSystemPing | host or IP, timeout ms, round-trip variable, success variable | Sends an ICMP echo request. |
ICMP can be blocked even when normal Internet access works. Network status is an indicator, not proof that a particular service is reachable.
Notifications and Audio
| Action | Parameters | Purpose |
|---|---|---|
neoSystemShowNotification | title, message, icon type, timeout seconds | Requests a Windows taskbar balloon notification. |
neoSystemPlaySound | system sound name or WAV path, asynchronous | Plays Asterisk, Exclamation, Error, Question, Beep, or a .wav file. |
neoSystemSetVolume | percentage, mute | Sets the legacy wave-output device volume. |
neoSystemGetVolume | percentage variable, mute variable | Reads the legacy wave-output device volume. |
Notification visibility depends on Windows notification and focus settings. Volume actions use the WinMM wave-output API; on modern systems they may not represent the same endpoint shown by the Windows master-volume UI.
Included Examples
01-Hardware-and-Battery-Diagnostics.pub: system, memory, drive, battery, and display JSON.02-Process-Manager-and-Silent-Execution.pub: safe process inspection and captured command output.03-Network-Ping-and-Registry-Tools.pub: network diagnostics, a temporary HKCU registry value, and sound.neoSystem-demo.pub: compact overview.
The registry demo uses only HKCU\Software\VisualNeoDemo; it does not require machine-wide registry access.