VisualNEO Win Plugin Manual

neoSystem for VisualNEO Win

Plugin ID:com.visualneo.neosystem
Version:1.1.2
Suite:VisualNEO Automation & AI Suite (Commercial)
Publisher:SinLios
Category:System / Windows Automation & Shell

neoSystem exposes Windows process, hardware, window, environment, clipboard, registry, service, shell, network, notification, audio, and screenshot operations to NeoScript.

Quick Start

TEXT
. 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]"
TEXT
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

ActionParametersPurpose
neoSystemExecCapturecommand line, working directory, output variable, exit-code variable, timeout msExecutes hidden and captures stdout plus stderr. Timeout 0 waits indefinitely; exit code -2 means timed out.
neoSystemProcessListJSON variableLists running processes.
neoSystemProcessExistsexecutable name or PID, result variableReturns True when a process exists.
neoSystemProcessKillexecutable name or PID, forceTerminates 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

ActionParametersPurpose
neoSystemGetInfoJSON variableReturns Windows, architecture, processor, user, and uptime information.
neoSystemGetMemoryJSON variableReturns physical memory totals and usage.
neoSystemGetDrivesJSON variableReturns drive type, capacity, and free space.
neoSystemGetBatteryJSON variableReturns battery and AC status.
neoSystemGetDisplaysJSON variableReturns monitor bounds and work areas.

Window Control

ActionParametersPurpose
neoSystemWindowSetTopmostwindow title, topmostChanges always-on-top state.
neoSystemWindowMinimizewindow titleMinimizes the selected window.
neoSystemWindowMaximizewindow titleMaximizes the selected window.
neoSystemWindowBringToFrontwindow titleRestores and activates the selected window.
neoSystemWindowFlashwindow title, countFlashes 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

ActionParametersPurpose
neoSystemGetEnvvariable name, result variableReads an environment variable.
neoSystemSetEnvvariable name, valueSets it for the current VisualNEO process.
neoSystemClipboardGetTextresult variableReads Unicode text from the clipboard.
neoSystemClipboardSetTexttextReplaces 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

ActionParametersPurpose
neoSystemPowerActionaction, forceRuns lock, logoff, sleep, hibernate, restart, or shutdown.
neoSystemRegistryReadroot, key, value, result variableReads a string, expanded string, integer, or binary size.
neoSystemRegistryWriteroot, key, value, data, typeCreates or writes string, expand, dword, or boolean.
neoSystemRegistryDeleteroot, key, valueDeletes one value; an empty value name deletes the key.
neoSystemRegistryExistsroot, key, value, result variableTests 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

ActionParametersPurpose
neoSystemServiceStatusservice name, status variableReturns Running, Stopped, Paused, or NotFound.
neoSystemServiceStartservice nameRequests service start.
neoSystemServiceStopservice nameRequests service stop.
neoSystemServiceListJSON variableLists 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

ActionParametersPurpose
neoSystemGetSpecialFolderalias, result variableResolves Desktop, Documents, Downloads, AppData, LocalAppData, ProgramFiles, System, Windows, Startup, StartMenu, Fonts, Templates, SendTo, or Temp.
neoSystemCreateShortcutshortcut path, target, arguments, working directory, icon path, icon indexCreates a Windows .lnk file and its parent directory.
neoSystemRecycleBinDeletefile or folder pathSends one path to the Recycle Bin.
neoSystemRecycleBinEmptyshow confirmationEmpties the Recycle Bin on all drives.
neoSystemScreenshotwindow title, output .png or .bmp pathCaptures 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

ActionParametersPurpose
neoSystemGetNetworkInfoJSON variableReturns host name, one resolved local IPv4 address, and Windows Internet status.
neoSystemPinghost or IP, timeout ms, round-trip variable, success variableSends 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

ActionParametersPurpose
neoSystemShowNotificationtitle, message, icon type, timeout secondsRequests a Windows taskbar balloon notification.
neoSystemPlaySoundsystem sound name or WAV path, asynchronousPlays Asterisk, Exclamation, Error, Question, Beep, or a .wav file.
neoSystemSetVolumepercentage, muteSets the legacy wave-output device volume.
neoSystemGetVolumepercentage variable, mute variableReads 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.