# Tabula

Tabula helps you liberate data tables trapped inside PDF files.

* The latest downloads and documentation are always available at:
  http://tabula.technology/

* Read more about Tabula on OpenNews Source:
  https://source.opennews.org/en-US/articles/introducing-tabula/

* See the GitHub project for source code, technical info, and more:
  https://github.com/tabulapdf/tabula

* Find a bug? Report it on GitHub:
  https://github.com/tabulapdf/tabula/issues

© 2012-2016 Manuel Aristarán. Available under MIT License.
See `AUTHORS.txt` and `LICENSE.txt`.

---

## Using Tabula

First, make sure you have a recent copy of Java installed. You can
download Java at https://www.java.com/download/ . Tabula requires
a Java Runtime Environment compatible with Java 6 or Java 7.

### Windows (tabula-win.zip)

Open tabula.exe and a browser should automatically open to
http://127.0.0.1:8080/ . If not, open your web browser of choice and visit
that URL.

### Mac OS X (tabula-mac.zip)

Open the Tabula app and a browser should automatically open to
http://127.0.0.1:8080/ . If not, open your web browser of choice and visit
that URL.

### JAR file for Linux/Other (tabula-jar.zip)

Open a terminal window, and `cd` to inside this `tabula` directory,
then run the following command

  java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -jar tabula.jar

Then, manually open your web browser to http://127.0.0.1:8080/ to access
the Tabula interface. Tabula binds to port 8080 by default. You can change
it with the `warbler.port` option; for example, if you want to use port 9999:

  java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -Dwarbler.port=9999 -jar tabula.jar

(You can enable the old "automatically open browser" behavior by using
the `-Dtabula.openBrowser=true` option.)