Distributing iMacros(Copy URL in PhpBB Forum Format - Info)
Features of the iMacros Player:
- All features of Enterprise Edition, except the ability to record new macros
- The option to install and run in the background (no visible user interface).
- Small size - The Player consists only of a few files (see detailed list below).
- All settings can be predefined, and macros/files can be added or removed from the installer - Roll-out a customized version to your users.
- Unlimited number of installations for a very low cost - royalty free!
The player license allows you to ship macros, scripts and programs based on iMacros along with a copy of iMacros itself to your users *without* royalty payment. Technically speaking this means that if iMacros is unlocked with the player license key your users have all the features of the SCRIPTING EDITION available except the ability to record new macros.
The iMacros Player license is available as 5-User, 50-User or Unlimited User license package.
iMacros Player licensing examples:
Question: I want to set up 12 PCs at twelve locations to monitor a WEB application and upload response time data to a central database. What license do I need to order?
Answer: You only need to order one iMacros Enterprise Edition license to create (record) the macros (Note: This assumes that you do all the recording on one machine). To replay the macros on your monitoring servers you can use an iMacros Player license package.
Question: Am I able to run the player concurrently?
Answer: Yes! Technically there is no limit in the number of Players than can run concurrently. The number is only limited by the memory and CPU resources of your PC of your machine(s). As a rule of thumb, you can open as many iMacros Player instances as you could open Internet Explorers instances on a given machine. From a license point of view, you can run an unlimited number of iMacros Players on the same machine at no extra charge (it counts as one license only).
There are two different approaches to distribute iMacros with your application.
Distributing the iMacros setup
You can distribute the normal setup executable from http://www.iopus.com/download/.
When installing your application on the clients computer, you can easily call the iMacros setup and install the iMacros Trial version. You can then either use the player license key as parameter in iimInit() or let your client enter it manually. Your client will then be able to play any macro you created. The Scripting Interface also works.
The setup supports some command line switches that make life easier.
Setup Command Line Switches
The installer program accepts the following optional command line parameters.
These instruct Setup to be silent or very silent. When Setup is silent the Wizard and the background window are not displayed but the installation progress window is. When a setup is very silent this installation progress window is not displayed. Everything else is normal, so for example error messages during installation are displayed.
If a restart is necessary and the /NORESTART command isn't used (see below) and Setup is silent it will display a "Reboot now?" message box. If it's very silent it will reboot without asking.
Prevents the user from cancelling during the installation process by disabling the Cancel button and ignoring clicks on the close button. Useful along with /SILENT.
Instructs Setup not to reboot even if it's necessary. Note that installing iMacros does not require a reboot unless iMacros was already installed and running on the machine during the setup.
Overrides the default directory name displayed on the Select Destination Directory Wizard page. A fully qualified pathname must be specified. If the [Setup] section directive DisableDirPage was set to yes this command line parameter is ignored. Example:
imacros-setup.exe /VERYSILENT /DIR="c:\imacros"
installs the software automatically in the c:\imacros directory.
Overrides the default folder name displayed on the Select Start Menu Folder wizard page. If the [Setup] section directive DisableProgramGroupPage was set to yes this command line parameter is ignored. The uninstaller program (unins000.exe) also accepts an optional command line parameter.
When specified the uninstaller will not ask the user any questions or display a message stating that uninstall is complete. Shared files that are no longer in use are deleted automatically without prompting. Any critical error messages will still be shown on the screen.
Restricted User Accounts
iMacros runs well on restricted user accounts, locked down systems and systems that use Active Directory services.
If you install the software for users with restricted rights, please note:
1. The software must be installed by a user with administrative rights 2. iMacros folders (Macros, Datasources, Downloads and Logs) are personal, so each user will have his own %USERPROFILE%\Documents\iMacros folder. However only the user who installed iMacros will have the Demo macros in his User Profile folder.
Modify settings directly
All settings used by iMacros 7 are stored in the registry. We do not recommend editing these settings manually unless you know what you are doing. If in doubt please contact the iMacros Support Team.
Distribute iMacros with your setup
This paragraph assumes that you do not want to use the iMacros installer, but want to create your own setup. iMacros is a compact application that consists only of the following files, which you need to copy to your client's computer:
- Required, iMacros Browser
- Required by both iMacros Browser and iMacros Plugin for IE
- iMacros.Core.dll (substitutes earlier iMacros.Engine.dll and iMacros.DialogManager.dll)
- Microsoft.mshtml.dll, register with RegAsm.exe /codebase
- Interop.SHDocVw.dll, Microsoft assembly
- imsys.dll, iMacros Dialog Manager helper assembly
- iimds.dll, iMacros Direct Screen
- iimir.dll, Image Recognition
- iimIRm.dll, Image Recognition
- iimIR1.dll, Image Recognition
- iimIR2.dll, Image Recognition
- iimIR3.dll, Image Recognition
- imatl.dll, register with regsvr32.exe
- Required by iMacros Plugin for IE
- iMacros.Plugin.dll, no tabs support (for use with IE 7 and below), register with RegAsm.exe /codebase
- iMacrosSidebar.dll, tabs support (for use with IE 8 and above), register with regsvr32.exe
- iMacros.Sidebar.Content.dll, tabs support (for use with IE 8 and above), register with RegAsm.exe /codebase
- Required, iMacros Scripting Interface
- iimConnector.dll, register with regsvr32.exe
- iimInterface.dll, register with regsvr32.exe
- imtcp.dll, the scripting interface which controls iMacros for Firefox and Chrome.
- Optional, native 64-bit version of the Scripting Interface
- iimInterface64.dll, register with regsvr32.exe (the regsvr32.exe file in the System32 folder on 64-bit Windows is a 64-bit version, despite the "32" in the name!)
- Required, use it to register iMacros.Plugin.dll, iMacros.Sidebar.Content.dll, and Microsoft.mshtml.dll
- Optional, iMacros icon
- Optional, iMacros Editor
- Microsoft Visual C++ 2008 SP1 Runtime Files x86
- and their x64 versions:
- Microsoft .NET 3.5 SP1
Besides copying the files above, the Player license key has to be entered manually in the registry at HKEY_CURRENT_USER\Software\iOpus\iMacros (both 32 and 64 bit OS), as LicenseKey.
Tip: To trouble-shoot installation related issues we find Dependency Walker useful.
Creating a Custom Install
The iMacros Setup executable was made using the Inno Setup custom installer, although no special features were used so you could use other installation software to create your own Setup Executable.
Inno Setup is available free of charge from here: 
You should also download the iMacros Player Inno installation script. The complete and documented source code is available as download inside our customer resources area.
Once you unzip the example script you will see the directory structure as shown.
You can open the Inno Setup Script file "iMacros.iss" within the IS Tool.
Here you can enter your Player license key and any settings you require.
You should also ensure that the latest iMacros binary files are located in the Bin folder, as described in the Readme.txt file. The iMacros macro files (= simple text files) can be placed anywhere, including a network drive or under source control.
You can then compile and run the script to create your installation file, which will be placed in the Setup folder.
Changes in an existing installation
All iMacros settings are stored in the registry (see also this forum post for some use cases for manipulating the registry directly). But since you can change most settings through the user interface editing the registry is not required or recommended for most users.
Note: The iMacros for Firefox settings are not stored in the registry. Here we follow the Firefox standard and store the addon settings in the Firefox user profile, so the iMacros for Firefox setting are per user. You can view and edit them by typing "about:config" in the address line. You can even select a certain user profile via the iimInit "-fxProfile" switch.
All iMacros paths can be changed directly in the user interface. To change them, go to the EDIT tab, click OPTIONS and open the PATH tab: