arara is a TeX automation tool based on rules and directives. It gives you subsidies to enhance your TeX experience.
Latest commit 2ed1142 Feb 4, 2017 @nlct nlct Added bib2gls rule
Failed to load latest commit information.
application Fixed two typos in Dec 15, 2016
docs Time to work on my tool again. :) Apr 17, 2016
rules Added bib2gls rule Feb 4, 2017
tools Added LICENSE. Nov 12, 2016
.gitignore Updates. :) Sep 28, 2014
.travis.yml Update .travis.yml Jan 3, 2015
LICENSE Added LICENSE file. Nov 12, 2016
README.markdown Update README.markdown Jun 18, 2015




arara is a TeX automation tool based on rules and directives. It gives you subsidies to enhance your TeX experience. The tool is an effort to provide a concise way to automate the daily TeX workflow for users and also package writers. Users might write their own rules when the provided ones do not suffice.

Basic use

To use arara, you need to tell it what to do. Unlike most other tools, you give arara these 'directives' in the document itself – usually near the top. So to run pdflatex once on your document, you should say something like:

% arara: pdflatex
Hello, world!

Now when you run arara my-file, that directive (% arara: ...) will be seen and carried out as described by the pdflatex rule. You can read more about rules and directives in the manual. In addition to documenting all of the rules that come standard with arara, its manual gives a detailed explanation of how arara works, how to create and use your own rules, and how to integrate the tool into the common TeX IDEs.

Current status

The arara team is working on the new 4.0 version. The code is ready and we are now focusing on rules, translations and the documentation itself. It might take a while since a lot of things have changed since version 3.0, so the manual has to be completely rewritten. Hopefully, we will release it soon. :)

  • Current TL version: 3.0 (codebase is available in the releases section)
  • Development/upcoming version: 4.0 (the repository itself holds the last changes)

Build status

arara uses Travis CI as a hosted continuous integration service. For each and every commit, we can see in real time the build status of our application checked against the following Java VM vendors:

  • OpenJDK 6.0
  • OpenJDK 7.0
  • Oracle Java 7.0
  • Oracle Java 8.0

More JVM's might be added soon. It is worth noting that arara is designed and built to be Java 5.0 compliant, so if you have an old JVM, it is almost sure that you will be able to run our beloved tool in it without any problems.

Current build status: Build Status


We use a Gitter chatroom for discussing things related to arara. You are more than welcome to come join the fun and say hi! to us. We also have the issues section in our repository as a valid channel to report problems, bugs and suggest improvements.

Our Gitter chatroom: Gitter


Would you like to make arara speak your own language? Splendid! We would love to have you in the team! Just send us an e-mail, join our dedicated chatroom or open an issue about it. The localization process is quite straightforward, we can help you! :) Any language is welcome!


Binary releases are powered by Bintray and not available in the repository anymore. You can click here or use the button below to get access to the current 3.0 release. Note that you need Java to run both the installer and arara itself.

Download: Download

If you want to try out the development version, you need to build it from source. It is actually a straightforward process: just clone this repository, go to the application/ directory and run mvn assembly:assembly (you need Apache Maven for this); you'll get the resulting .jar file in a target/ directory. Have fun!


This application is licensed under the New BSD License.Please note that the New BSD License has been verified as a GPL-compatible free software license by the Free Software Foundation, and has been vetted as an open source license by the Open Source Initiative.

The core team

  • Brazil Paulo Roberto Massa Cereda
  • Germany Marco Daniel
  • United Kingdom Brent Longborough
  • United Kingdom Nicola Louise Cecilia Talbot


No ducks were hurt in the making of this tool