https://github.com/uwetrottmann/tmdb-java
Java wrapper around themoviedb.org API v3 using retrofit2 (inofficial).
https://github.com/uwetrottmann/tmdb-java
java movies tmdb tmdb-api tv
Last synced: 5 months ago
JSON representation
Java wrapper around themoviedb.org API v3 using retrofit2 (inofficial).
- Host: GitHub
- URL: https://github.com/uwetrottmann/tmdb-java
- Owner: UweTrottmann
- License: apache-2.0
- Created: 2012-09-29T11:15:22.000Z (about 13 years ago)
- Default Branch: main
- Last Pushed: 2024-08-12T13:29:47.000Z (about 1 year ago)
- Last Synced: 2025-05-15T13:08:07.719Z (5 months ago)
- Topics: java, movies, tmdb, tmdb-api, tv
- Language: Java
- Homepage:
- Size: 972 KB
- Stars: 173
- Watchers: 13
- Forks: 61
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
**[Pull requests](CONTRIBUTING.md) (e.g. support for more API endpoints, bug fixes) are welcome!**
# tmdb-java
A Java wrapper around the [TMDb v3 API](https://developer.themoviedb.org/reference/intro/getting-started) using [retrofit 2](https://square.github.io/retrofit/).
## Usage
[Available on Maven Central](https://central.sonatype.com/search?q=tmdb-java)
Add the following dependency to your Gradle project:
```groovy
implementation("com.uwetrottmann.tmdb2:tmdb-java:2.11.0")
```
or your Maven project:
```xml
com.uwetrottmann.tmdb2
tmdb-java
2.11.0
```
Use like any other retrofit2 based service. For example:
```java
// Create an instance of the service you wish to use
// you should re-use these
Tmdb tmdb = new Tmdb(API_KEY);
MoviesService moviesService = tmdb.moviesService();
// Call any of the available endpoints
try {
Response response = moviesService
.summary(550)
.execute();
if (response.isSuccessful()) {
Movie movie = response.body();
System.out.println(movie.title + " is awesome!");
}
} catch (Exception e) {
// see execute() javadoc
}
```
See test cases in `src/test/` for more examples and the [retrofit website](https://square.github.io/retrofit/) for configuration options.
### Android
This library ships Java 8 bytecode. This requires Android Gradle Plugin 3.2.x or newer.
## Proguard / R8
It is likely not every method in this library is used, so it is probably useful to strip unused ones with Proguard.
Apply the [Proguard rules for retrofit](https://square.github.io/retrofit/#download).
The specific rules for this library are [already bundled](src/main/resources/META-INF/proguard/tmdb-java.pro) into the
release which can be interpreted by R8 automatically, ProGuard users must manually add the rules.
## License
This work by [Uwe Trottmann](https://uwetrottmann.com) is licensed under the [Apache License 2.0](LICENSE.txt).
[Contributors](https://github.com/UweTrottmann/tmdb-java/graphs/contributors) and changes are tracked by Git.
Do not just copy, make it better.