iMacros for Firefox

From iMacros
Revision as of 18:49, 16 November 2018 by Td (Talk | contribs)

Jump to: navigation, search


iMacros for Firefox (version 10 and above) is one of the iMacros Webextensions. A detailed documentation of features and limitations is found in that page. Here we document the few differences to that common page.

For the legacy versions (9 and below) refer to iMacros for Firefox Legacy.


iMacros End User License Agreement


Firefox Download from iMacros @ Mozilla Addons

Downloading Files

If you have iMacro File Access installed you can use the ONDOWNLOAD command to automate the download of files in Firefox. If the File Access is not installed, the ONDOWNLOAD parameters are ignored but the file is downloaded with its default file name, to Firefox default downloads folder. However, by default, Firefox will prompt you to choose between saving or opening a file upon download. iMacros cannot handle this prompt and will only be able to download the file if Firefox default action for this file type is Save File.

In order to have the download handled by iMacros, the action in Firefox preferences has to be set as Save File. See Change what Firefox does when you click on or download a file

If the file type you are downloading is not listed under Content Type, you will have to edit Firefox handlers.js file manually. In the example below we included .exe and .msi in handlers.json, using "action":0 for save.

   "defaultHandlersVersion": {
       "en-GB": 4
   "mimeTypes": {
       "application/pdf": {
           "action": 3,
           "extensions": [
       "application/x-7z-compressed": {
           "action": 0,
           "extensions": [
       "application/x-msi": {
           "action": 0,
           "extensions": [
       "application/x-executable": {
           "action": 0,
           "extensions": [

To locate the handlers.json file, type in Firefox navigation bar "about:support" and under General Information/Profile Folder you can click on the button Open Folder.

Clearing Cookies and Cache

When you clear the browser history in Firefox, iMacros stored data is also removed. Thus all your iMacros preferences are lost. iMacros will work again, but you preferences will be reset to their defaults. This also happens if you set Firefox to Clear history when Firefox closes in about:preferences#privacy.

The CLEAR command, on the other hand, does not delete iMacros data, while clearing cache and cookies. It also accepts an argument to filter the cookies to be cleared by domain name. Using CLEAR with no argument clears all cookies and cache. Using e.g.


will clear all of the cache, but only cookies from Facebook. If you only want to clear the cache, then specify a nonexistent domain name

CLEAR xxx.yyy.zzz

Scripting Firefox

Due to the WebExtensions framework adopted by Mozilla and released with Firefox 56 (a.k.a. Quantum), iMacros for Firefox 10 no longer includes the built-in Javascript scripting interface for playing .js files directly from the iMacros sidebar. However, as mentioned in Scripting Chrome and Firefox, you can still control iMacros for Firefox via external scripts and programs.

iMacros for Firefox requires the latest version of the iMacros scripting interface (API) included with the File Access installer under the following scenario:

If you use the iMacros Enterprise (v12.0 or older) scripting interface to connect to iMacros for Firefox *and* specify a non-default Firefox profile using e.g.:

  iimOpen("-fx -fxProfile MyProfile")

then you will need to copy and overwrite the following dlls first before this functionality will work with the current version of iMacros for Firefox. This is not required if you are already using a newer version of iMacros Enterprise (newer than v12.0) or if you are not using -fxProfile.

Source folder:

  • On 64-bit systems
  1. Copy imtcp.dll to %programfiles(x86)%\Ipswitch\iMacros
  2. Copy imtcp64.dll to %programfiles%\Ipswitch\iMacros
  • On 32-bit systems
  1. Copy imtcp.dll to %programfiles%\Ipswitch\iMacros

Known Issues

Current known issues with the latest version of iMacros for Firefox:

  • Docking the iMacros panel (sidebar) can break the ability to drag and drop tabs in Firefox.
  • Search and replace dialog no longer work in the macro editor due to Firefox CSP (Content Security Policy) for Web Extensions.

Version History

Version 10.0.2, released July 9, 2018

This is the first version which supports Firefox Quantum (Firefox 56 and above). It is a complete new version for the Firefox Webextension API, which has more similarities with iMacros for Chrome than previous versions of iMacros for Firefox. In particular, there are some commands, variables, and functionality that were previously supported but currently are not mostly because the WebExtension API provided by Mozilla still lacks support for it.

  • The following commands and variables are newly supported in iMacros 10:
    • SIZE
  • Known Issues:
    • Docking the iMacros panel (sidebar) can break the ability to drag and drop tabs in Firefox
    • Search and replace dialog no longer work in the macro editor due to Firefox CSP (Content Security Policy) for Web Extensions.
    • For security reasons in Firefox, you cannot navigate using URL GOTO to a privileged URL such as file:, data:, and about: (although about:home and about:blank are allowed)
  • Additional tweaks/enhancements made during the beta period:
    • Accept input and confirm PROMPT and other dialogs with a keyboard Enter
    • Editor Save and Save As buttons feedback on successful save
    • Changed Play button text to Resume when macro is paused
    • Added setting to ignore UnsupportedCommand errors bypassing parsing of line (use with care!)

See Also

Webextensions, Personal Edition, iMacros for Chrome, Features Comparison, iMacros for Firefox Legacy