trakt-java

A Java wrapper around the trakt API using retrofit.

Remote services are grouped into local service objects which can be centrally managed by a Trakt instance. It will act as a factory for all of the services and will automatically initialize them with your credentials and API key.

Usage

Add the following dependency to your Gradle project:

compile 'com.uwetrottmann:trakt-java:3.3.1'

Or for Maven:

<dependency>
  <groupId>com.uwetrottmann</groupId>
  <artifactId>trakt-java</artifactId>
  <version>3.3.1</version>
</dependency>

Dependencies

If you rather use the released jar, add dependencies yourself as you see fit. For example for Gradle:

compile 'com.squareup.retrofit:retrofit:1.6.1'
compile 'com.squareup.okhttp:okhttp:2.0.0' // not mandatory, but greatly recommended
compile 'com.squareup.okhttp:okhttp-urlconnection:2.0.0' // not mandatory, but greatly recommended

Or for Maven:

<dependency>
    <groupId>com.squareup.retrofit</groupId>
    <artifactId>retrofit</artifactId>
    <version>1.6.1</version>
</dependency>
<!-- not mandatory, but greatly recommended: -->
<dependency>
  <groupId>com.squareup.okhttp</groupId>
  <artifactId>okhttp</artifactId>
  <version>2.0.0</version>
</dependency>
<!-- not mandatory, but greatly recommended: -->
<dependency>
  <groupId>com.squareup.okhttp</groupId>
  <artifactId>okhttp-urlconnection</artifactId>
  <version>2.0.0</version>
</dependency>

Calling endpoints

Trakt trakt = new Trakt();
trakt.setAuthentication("username", "sha1_of_password");
trakt.setApiKey("api_key");

// Create service instance
ShowService showService = trakt.showService();

// Get trending shows on trakt
List<TvShow> shows = showService.trending();
for (TvShow show : shows) {
	System.out.println("Title: " + show.title);
}

// Post an episode as seen
Response response = showService.episodeSeen(new ShowService.Episodes(
    153021 // TVDb id of show, 1 // season, 1 // episode
));
if (response != null && response.status == Status.SUCCESS) {
    System.out.println("Successfully checked into show.");
}

See test cases in src/test/ for more examples.

Original Implementation

• trakt-java by Jake Wharton - @JakeWharton

License

Copyright 2013-2014 Uwe Trottmann

Licensed 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.