Need help with snacktory?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

458 Stars 133 Forks 196 Commits 23 Opened issues


Readability clone in Java

Services available


Need anything else?

Contributors list


Snacktory is no longer actively maintained by @karussell.

Crux is a fork under active development and is the recommended alternative.

  • Available under the same permissive Apache 2.0 License.
  • Adds several new features, such as Rich Text output (HTML), preserves links, extracts more metadata content, etc.
  • Optimized for Android. Decoupled from optional dependencies such as HttpUrlConnection, log4j, etc.
  • Actively developed by Chimbori, the developers of Hermit, a Lite Apps Browser for Android.
  • Already being used in multiple apps.
  • Crux has a different architecture from Snacktory: it is designed as a collection of several separate APIs instead of a single one. Clients can pick and choose which ones they wish to use.
  • As a result, Crux is not a drop-in replacement for Snacktory, but fairly easy to migrate to.


This is a small helper utility for people who don't want to write yet another java clone of Readability. In most cases, this is applied to articles, although it should work for any website to find its major area, extract its text, keywords, its main picture and more.

The resulting quality is high, even uses the core of snacktory. Also have a look into this article, it describes a news aggregator service which uses snacktory. But jetslide is no longer online.

Snacktory borrows some ideas and a lot of test cases from goose and jreadability:


The software stands under Apache 2 License and comes with NO WARRANTY


  • article text detection
  • get top image url(s)
  • get top video url
  • extraction of description, keywords, ...
  • good detection for none-english sites (German, Japanese, ...), snacktory does not depend on the word count in its text detection to support CJK languages
  • good charset detection
  • possible to do URL resolving, but caching is still possible after resolving
  • skipping some known filetypes
  • no http GET required to run the core tests


  • only top text supported at the moment


Include the repo at:

Then add the dependency


If you need this for Android be sure you read this issue.

Or, if you prefer, you can use a build generated by

Now you can use it as follows:

 HtmlFetcher fetcher = new HtmlFetcher();
 // set cache. e.g. take the map implementation from google collections:
 // fetcher.setCache(new MapMaker().concurrencyLevel(20).maximumSize(count).
 //    expireAfterWrite(minutes, TimeUnit.MINUTES).makeMap();

JResult res = fetcher.fetchAndExtract(articleUrl, resolveTimeout, true); String text = res.getText(); String title = res.getTitle(); String imageUrl = res.getImageUrl();


via Maven. Maven will automatically resolve dependencies to jsoup, log4j and slf4j-api

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.