Skip to content
Mirror of Apache Tika
Java TeX HTML Matlab JavaScript Groovy
Latest commit c5b9cb7 @tballison tballison clean up tests in server that used to rely on EvilParser (early name …
…for MockParser)...discovered while working on 2.x branch TIKA-1 8 5 1.
Failed to load latest commit information.
tika-app [maven-release-plugin] prepare for next development iteration
tika-batch [maven-release-plugin] prepare for next development iteration
tika-bundle TIKA-1799: upgrade to POI 3.14-beta1
tika-core TIKA-1854: add handling for embeddedStorageClassId in MSOffice docs (…
tika-dotnet Prep pom.xmls for release - remove all SCM tags except for tika-paren…
tika-example [maven-release-plugin] prepare for next development iteration
tika-java7 [maven-release-plugin] prepare for next development iteration
tika-parent [maven-release-plugin] prepare for next development iteration
tika-parsers TIKA-1854: add handling for embeddedStorageClassId in MSOffice docs (…
tika-serialization [maven-release-plugin] prepare for next development iteration
tika-server clean up tests in server that used to rely on EvilParser (early name …
tika-translate [maven-release-plugin] prepare for next development iteration
tika-xmp [maven-release-plugin] prepare for next development iteration
.gitattributes TIKA-431: Tika currently misuses the HTTP Content-Encoding header, an…
.gitignore Fix for TIKA-1787: Include Stanford Name Entity Recognition in Tika c…
CHANGES.txt TIKA-1799: upgrade to POI 3.14-beta1
HEADER.txt Add svn:eol-style
KEYS Add Tyler Palsulich's key to KEYS.
LICENSE.txt TIKA-1817 Test DXF ASCII file, and detection unit test
NOTICE.txt TIKA-1581 - Typo & CHANGES.txt
README.md instructions for how to contribute via Github. This closes #31.
assembly.xml TIKA-281: Use repository.apache.org to deploy snapshots and releases
pom.xml [maven-release-plugin] prepare for next development iteration

README.md

Welcome to Apache Tika http://tika.apache.org/

Apache Tika(TM) is a toolkit for detecting and extracting metadata and structured text content from various documents using existing parser libraries.

Tika is a project of the Apache Software Foundation.

Apache Tika, Tika, Apache, the Apache feather logo, and the Apache Tika project logo are trademarks of The Apache Software Foundation.

Getting Started

Tika is based on Java 6 and uses the Maven 3 build system. To build Tika, use the following command in this directory:

mvn clean install

The build consists of a number of components, including a standalone runnable jar that you can use to try out Tika features. You can run it like this:

java -jar tika-app/target/tika-app-*.jar --help

Contributing via Github

To contribute a patch, follow these instructions (note that installing Hub is not strictly required, but is recommended).

0. Download and install hub.github.com
1. File JIRA issue for your fix at https://issues.apache.org/jira/browse/TIKA
- you will get issue id TIKA-xxx where xxx is the issue ID.
2. git clone http://github.com/apache/tika.git 
3. cd tika
4. git checkout -b TIKA-xxx
5. edit files
6. git status (make sure it shows what files you expected to edit)
7. git add <files>
8. git commit -m “fix for TIKA-xxx contributed by <your username>”
9. git fork
10. git push -u <your git username> TIKA-xxx
11. git pull-request

License (see also LICENSE.txt)

Collective work: Copyright 2011 The Apache Software Foundation.

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Apache Tika includes a number of subcomponents with separate copyright notices and license terms. Your use of these subcomponents is subject to the terms and conditions of the licenses listed in the LICENSE.txt file.

Export control

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.

The following provides more details on the included cryptographic software:

Apache Tika uses the Bouncy Castle generic encryption libraries for extracting text content and metadata from encrypted PDF files. See http://www.bouncycastle.org/ for more details on Bouncy Castle.

Mailing Lists

Discussion about Tika takes place on the following mailing lists:

Notification on all code changes are sent to the following mailing list:

The mailing lists are open to anyone and publicly archived.

You can subscribe the mailing lists by sending a message to [LIST]-subscribe@tika.apache.org (for example user-subscribe@...). To unsubscribe, send a message to [LIST]-unsubscribe@tika.apache.org. For more instructions, send a message to [LIST]-help@tika.apache.org.

Issue Tracker

If you encounter errors in Tika or want to suggest an improvement or a new feature, please visit the Tika issue tracker. There you can also find the latest information on known issues and recent bug fixes and enhancements.

Something went wrong with that request. Please try again.