/scribe-java

Simple OAuth library for Java

Primary LanguageJavaMIT LicenseMIT

Welcome to the home of Scribe, the simple OAuth Java lib!

travis-ci-status

Why use Scribe?

Dead Simple

Who said OAuth was difficult? Configuring scribe is so easy your grandma can do it! check it out:

OAuthService service = new ServiceBuilder()
.provider(LinkedInApi.class)
.apiKey(YOUR_API_KEY)
.apiSecret(YOUR_API_SECRET)
.build();

That single line (added newlines for readability) is the only thing you need to configure scribe with LinkedIn’s OAuth API for example.

Threadsafe

Hit Scribe as hard and with many threads as you like.

Supports all major 1.0a and 2.0 OAuth APIs out-of-the-box

  • Google
  • Facebook
  • Yahoo
  • LinkedIn
  • Twitter
  • Foursquare
  • Evernote
  • Vimeo
  • Yammer
  • Windows Live

Small and modular

Scribe’s code is small (about 1k LOC) and simple to understand. No smart-ass or “clever” hacks here.

Android-Ready

Works out of the box with android™ applications.

Stable & bulletproof

Good test coverage to keep you safe from harm.

When something bad actually happens, Scribe’s meaningful error messages will tell you exactly what went wrong, when and where.

Pull it from Maven! (new)

You can pull scribe from a maven repository, just add this to your pom.xml file:

<dependency>
<groupId>org.scribe</groupId>
<artifactId>scribe</artifactId>
<version>1.3.0</version>
</dependency>

Getting started in less than 2 minutes

Check the Getting Started page and start rocking!

Please Read the FAQ before creating an issue :)

Questions?

Feel free to drop me an email, but there’s already a StackOverflow tag for scribe you should use. I’m subscribed to it so I’ll pick the question immediately.

Note that it really helps to run scribe on debug mode (since 1.3.0), to get additional info. To do this simply call the .debug() method on the ServiceBuilder.

Forks

Looking for a scribe variation? check the Fork List

If you have a useful fork that should be listed there please contact me (see About me).

About me

LinkedIn profile

Email me: fernandezpablo85 at gmail.com

Follow me: @fernandezpablo