I try to use arara with TeXShop on my Mac, but I don't understand some steps either javascript, probably because of my english & my programer level.

I create first the arara.engine in the /Engines folder :

export PATH=/usr/texbin:/usr/local/bin:${PATH} 
arara "$1"

I use Tex Live Utility, & the package arara exists. OK.

I install the arara-3.0-installer.jar with the cross-platform installer. Ok.

I put all files from sources in my computer. Ok. But I don't agree the step with Apache Maven, it just seemed too complicated… & isn't it to program complicated things ? :( So !

I choose the compilation mode arara & I just put in preamble :

% arara: xelatex
% arara: makeglossaries
% arara: xelatex -shell-escape
% arara: xelatex

& nothing. What I missed ? Thanks

1 Answer 1


There is already an arara engine in TeXShop, and arara is already installed as part of TeXLive. Move the arara engine from the ~/Library/TeXShop/Engines/Inactive folder to the Engines folder itself. Then restart TeXShop.

In your document add the line:

% !TEX TS-program = arara

in addition to your arara lines and things should just work.

You can get TeXShop to add this line for you by using the Program choice in the Macros menu.

(Or choose the arara engine from the dropdown menu next to the Typeset button)

Note If you have created your own engine, you need to make sure the executable bit is set. To do this, use the Terminal and use the following command (assuming you have named the engine myarara.engine:

 chmod +x ~/Library/TeXShop/Engines/myarara.engine

You shouldn't have to do this if you are using the preinstalled arara engine.

  • I haven't restart TeXShop, but now he said: - /Users/~/Library/TeXShop/Engines/arara.engine has no active execution bit - Now I have to configure this engine file, isn't it ?
    – Zouib
    Commented May 6, 2014 at 18:05
  • So I don't need this program arara-3.0-installer.jar and using Maven… Ok
    – Zouib
    Commented May 6, 2014 at 18:08
  • 4
    No, you shouldn't need to use the installer at all. And if you use the pre-installed arara engine, this error shouldn't arise. For the engine you created, you need to set the executable bit on the file. In a Terminal window you need to do chmod +x ~/Library/TeXShop/Engines/arara.engine.
    – Alan Munn
    Commented May 6, 2014 at 18:22
  • It is a success ! Thank you for this lesson ;) I lost a day trying to understand something simple. Thanks
    – Zouib
    Commented May 6, 2014 at 18:48
  • 1
    @kando I've added a note about that. For the default arara engine, I don't think it should be needed.
    – Alan Munn
    Commented Sep 13, 2020 at 14:39

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .