Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jellyfin/TMDbLib
C#.Net library for TheMovieDB
https://github.com/jellyfin/TMDbLib
movies themoviedb tmdb
Last synced: 10 days ago
JSON representation
C#.Net library for TheMovieDB
- Host: GitHub
- URL: https://github.com/jellyfin/TMDbLib
- Owner: jellyfin
- License: mit
- Created: 2013-02-12T18:30:34.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2024-10-29T13:57:24.000Z (15 days ago)
- Last Synced: 2024-10-30T00:00:40.013Z (15 days ago)
- Topics: movies, themoviedb, tmdb
- Language: C#
- Homepage:
- Size: 5.58 MB
- Stars: 357
- Watchers: 36
- Forks: 135
- Open Issues: 25
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE.txt
Awesome Lists containing this project
README
TMDbLib [](https://github.com/LordMike/TMDbLib/actions/workflows/dotnet.yml) [](https://www.nuget.org/packages/Tmdblib) [](https://github.com/LordMike/TMDbLib/packages/691970)
=======
A near-complete wrapper for v3 of TMDb's API (TheMovieDb - https://www.themoviedb.org/).
## Using alpha packages
All commits to master produce an Alpha package that can be [found here](https://github.com/LordMike/TMDbLib/packages/691970). [Read more on how to use these packages](https://blog.mbwarez.dk/consuming-my-nuget-packages-from-github/).
Index
---------
- [Nuget](#nuget)
- [Documentation](#documentation)
- [Examples](#examples)
- [Tips](#tips)
Documentation
--------
Most of the library is self-explaining, and closely follows the possibilities at the official TMDb documentation site: [developers.themoviedb.org](https://developers.themoviedb.org/3/getting-started).
Examples
--------
Simple example, getting the basic info for "A good day to die hard".
```csharp
TMDbClient client = new TMDbClient("APIKey");
Movie movie = client.GetMovieAsync(47964).Result;
Console.WriteLine($"Movie name: {movie.Title}");
```
Using the extra features of TMDb, we can fetch more info in one go (here we fetch casts as well as trailers):
```csharp
TMDbClient client = new TMDbClient("APIKey");
Movie movie = await client.GetMovieAsync(47964, MovieMethods.Credits | MovieMethods.Videos);
Console.WriteLine($"Movie title: {movie.Title}");
foreach (Cast cast in movie.Credits.Cast)
Console.WriteLine($"{cast.Name} - {cast.Character}");
Console.WriteLine();
foreach (Video video in movie.Videos.Results)
Console.WriteLine($"Trailer: {video.Type} ({video.Site}), {video.Name}");
```
It is likewise simple to search for people or movies, for example here we search for "007". This yields basically every James Bond film ever made:
```csharp
TMDbClient client = new TMDbClient("APIKey");
SearchContainer results = client.SearchMovieAsync("007").Result;
Console.WriteLine($"Got {results.Results.Count:N0} of {results.TotalResults:N0} results");
foreach (SearchMovie result in results.Results)
Console.WriteLine(result.Title);
```
However, another way to get all James Bond movies, is to use the collection-approach. TMDb makes collections for series of movies, such as Die Hard and James Bond. I know there is one, so I will show how to search for the collection, and then list all movies in it:
```csharp
TMDbClient client = new TMDbClient("APIKey");
SearchContainer collectons = client.SearchCollectionAsync("James Bond").Result;
Console.WriteLine($"Got {collectons.Results.Count:N0} collections");
Collection jamesBonds = client.GetCollectionAsync(collectons.Results.First().Id).Result;
Console.WriteLine($"Collection: {jamesBonds.Name}");
Console.WriteLine();
Console.WriteLine($"Got {jamesBonds.Parts.Count:N0} James Bond Movies");
foreach (SearchMovie part in jamesBonds.Parts)
Console.WriteLine(part.Title);
```
Tips
---------
* All methods are `async` and awaitable
* Most methods are very straightforward, and do as they are named, `GetMovie`, `GetPerson` etc.
* Almost all enums are of the `[Flags]` type. This means you can combine them: `MovieMethods.Casts | MovieMethods.Trailers`
* TMDb are big fans of serving as little as possible, so most properties on primary classes like `Movie` are null, until you request the extra data using the enums like above.