Welcome to the home of Scribe, the simple OAuth Java lib!
Before submitting a pull request please read this
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
- Yahoo
- Foursquare
- Evernote
- Vimeo
- Yammer
- Windows Live
- and many more! check the examples folder
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.5</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
Follow me: @fernandezpablo