Skip to content

A9T9/SeeShell

Repository files navigation

SeeShell

Example code for working with the SeeShell API. The API is ideal for more complex automation tasks, when a "linear" macro is not sufficient. The API allows you to control all SeeShell functions from your favorite programming or scripting language.

Note that some "ready to run" VBS and Powershell sample scripts are automatically installed with SeeShell. You find them in the folder

  • Desktop automation: C:\Users\ [Your user name] \documents\SeeShell\API
  • Web automation: C:\Users\ [Your user name] \documents\SeeShell.Browser\API

If you deleted these files, or simply want to update them to the latest version, you can download and re-run a demo file installer. It does not include SeeShell, but only updates the demo macros and the demo VBS and Powershell scripts.

Documentation: https://a9t9.com/SeeShell/docs

API: https://a9t9.com/SeeShell/docs#api

FAQ: https://a9t9.com/SeeShell/docs#faq

SeeShell separates the linear image flow logic (the screenshot scripts) and the programming/scripting logic with its Scripting API. So for tasks like conditional statements, use the API Scripting Interface. The PLAY command always returns detailed status and error information, and use can use this to base your IF/THEN/ELSE decisions on:

IntegerReturnValue = objSeeShell.Play ("Macro1.see")

if IntegerReturnValue = 1 then
  'Do something
  MsgBox "OK!"
else
  'error, do something else, like running another SeeShell macro.
  IntegerReturnValue = objSeeShell.Play ("Macro2.see")
end if

Technically, the API is implemented as a Windows COM interface. So while this example uses the VBS/Visual Basic syntax, you can use the SeeShell COM object from any programming or scripting language on Windows.