SlimerJS runs on any platform on which Firefox or XulRunner is available: Linux (32bits and 64bits), Windows, MacOs X. XulRunner is the core of Firefox without its user interface.
On windows, you should open a terminal. You can use the classical cmd.exe, or the recent PowerShell.exe. You can also install Cygwin and use its terminal.
You cannot use the MingW32 environment on Windows because there are some issues with (no output in the console, and it lacks on some commands like mktemp).
On Linux, standalone editions need these libraries: libpthread.so, libdl.so, libstdc++.so, libm.so, libgcc_s.so, libc.so, ld-linux-x86-64.so. On Ubuntu/Debian, you can install/verify it by doing:
sudo apt-get install libc6 libstdc++6 libgcc1
To install SlimerJS, you need to download its package. It is available in two editions:
See the download page to know the places from where you can retrieve SlimerJS.
During its launch, SlimerJS tries to discover itself the path of Firefox or XulRunner. This is not a problem for the Standalone edition or linux packages.
In case it fails (this could be the case for the lightweight edition), or if you want to launch SlimerJS with a specific version of Firefox, you should create an environment variable containing the path of the Firefox/XulRunner binary. To create this environment variable from a command line:
export SLIMERJSLAUNCHER=/usr/bin/firefox
SET SLIMERJSLAUNCHER="c:\Program Files\Mozilla Firefox\firefox.exe
export SLIMERJSLAUNCHER="/cygdrive/c/program files/mozilla firefox/firefox.exe"
export SLIMERJSLAUNCHER=/Applications/Firefox.app/Contents/MacOS/firefox
You can of course set this variable in your .bashrc, .profile or in the computer properties on Windows.
By default, SlimerJS is configured to be compatible only with specific stable versions of Firefox and XulRunner. It’s because internal API of Firefox/XulRunner can be changed between versions, and so SlimerJS may not work as expected. Stranges behaviors or even fatal errors may appears with unsupported versions. SlimerJS has only been tested with specific versions of Firefox/XulRunner.
However, you can change this limitation, by modifying the maxVersion parameter (and/or the minVersion) in the application.ini of SlimerJS. But remember you do it at your own risk.
If you found issues with unsupported versions of Firefox/XulRunner, please discuss about it in the mailing-list, especially if it is about unstable version fo Firefox/XulRunner.
From a command line, call the slimerjs executable (or slimerjs.bat for Windows) with the path of a javascript file.
/somewhere/slimerjs-1.2.3/slimerjs myscript.js
# or if SlimerJS is in your $PATH:
slimerjs myscript.js
On Windows:
c:\somewhere\slimerjs-1.2.3\slimerjs.bat myscript.js
The js script should contain your instructions to manipulate a web page...
You can indicate several options on the command line. See the “configuration” chapter.
There is a tool called xvfb, available on Linux and MacOS. It allows to launch any “graphical” programs without the need of an X-Windows environment. Windows of the application won’t be shown and will be drawn only in memory.
Install it from your prefered repository (sudo apt-get install xvfb with debian/ubuntu).
Then launch SlimerJS like this:
xvfb-run ./slimerjs myscript.js
You won’t see any windows. If you have any problems with xvfb, see its documentation.