YAMJ / yamj-v2

Yet Another Movie Jukebox (YAMJ) v2
GNU General Public License v3.0
28 stars 11 forks source link

Download fanart for TV Series #229

Closed Omertron closed 9 years ago

Omertron commented 9 years ago

Original issue 229 created by Omertron on 2008-10-16T04:12:41.000Z:

From Excal and Issue 199:

How we handle tv-show fanart. (if we can't get tv-shows too...movies is a good enough start).

Currently we are getting all our TV fan-art from www.thetvdb.com

Currently each series is given a series ID. Then each tv series page uses that id for its url

Simpsons series page

http://www.thetvdb.com/?tab=series&id=71663&lid=7

Simpsons fan art page..

http://www.thetvdb.com/?tab=seriesfanart&id=71663

Simpsons fanart download examples...

http://www.thetvdb.com/banners/fanart/original/71663-4.jpg

http://www.thetvdb.com/banners/fanart/original/71663-2.jpg

A Dexter fanart download example is...

http://www.thetvdb.com/banners/fanart/original/79349-4.jpg

Omertron commented 9 years ago

Comment #1 originally posted by Omertron on 2008-10-16T04:36:21.000Z:

This would definitly be cool.

I know the site uses a API. I'm not sure exactly how it works though. Here's some information on it.

http://www.thetvdb.com/wiki/index.php/Programmers_API

Omertron commented 9 years ago

Comment #2 originally posted by Omertron on 2008-10-16T05:06:22.000Z:

thetvdb.vom has an API and requires registration (free) and use of a key. Not sure if that applies to how YAMJ will use it, but I would think so: http://www.thetvdb.com/wiki/index.php?title=Programmers_API

Omertron commented 9 years ago

Comment #3 originally posted by Omertron on 2008-10-16T20:26:46.000Z:

I've heard about the key...and i know its restrictive of uses per key.

So if we go that route (using the API)...we might have to request every person register and get their own key and insert that key into the moviejukebox.properties file.

Not ideal...but it would be pretty easy, and free. And you can always set a true/false like themoviedb.org one. So if they don't wanna go get their own Key..they can just leave that as false, and YAMJ won't attempt to download tv fanart.

Omertron commented 9 years ago

Comment #4 originally posted by Omertron on 2008-10-16T20:34:49.000Z:

actually i might be wrong...it appears they let you use a key for a public software as long as you inform your users to contribute to the website with info and fanart if possible.

Omertron commented 9 years ago

Comment #5 originally posted by Omertron on 2008-10-16T20:36:57.000Z:

Please fill out the information below to receive your API Key. The key will allow you to access the XML data files directly. We do monitor for abuse, so make sure you're following our guidelines.

* If you will be using the API information in a commercial product or website,

you must email scott@thetvdb.com and wait for authorization before using the API. However, you MAY use the API for development and testing before a public release. * If you have a publicly available program, you MUST inform your users of this website and request that they help contribute information and artwork if possible. * You MUST familiarize yourself with our data structure, which is detailed in the wiki documentation. * You MUST NOT perform more requests than are necessary for each user. This means no downloading all of our content (we'll provide the database if you need it). Play nice with our server. * You MUST NOT directly access our data without using the documented API methods. * You MUST keep the email address in your account information current and accurate in case we need to contact you regarding your key (we hate spam as much as anyone, so we'll never release your email address to anyone else). * Please feel free to contact us and request changes to our site and/or API. We'll happily consider all reasonable suggestions. * By pressing the button below, you are verifying you understand all of the requirements for using our API.

You must be logged in to get an API key

Omertron commented 9 years ago

Comment #6 originally posted by Omertron on 2008-10-16T20:37:50.000Z:

I guess depends on how legit you wanna be. It's easy enough to just scrape their site and obtain the images needed, since you can query based on IMDB id. Technically, even IMDB has a statement saying that scraping of their site is not allowed.

Omertron commented 9 years ago

Comment #7 originally posted by Omertron on 2008-10-16T20:45:45.000Z:

Hmmm, i didn't think thetvdb.com used imdb#'s at all. They have series ID's...but they seemed unique to the site as far as i could tell.

However, i'm not an expert by any means....quite frankly i have no idea what you're gonna be doing to get the images. I'm just trying to provide as much info as i find that seems to pertain to this subject to hopefully make it a little easier on you guys :)

Omertron commented 9 years ago

Comment #8 originally posted by Omertron on 2008-10-16T20:56:59.000Z:

Well, partly right. They do have their own unique series ID. But they also have a query page where you can enter the IMDB id. A resulting url might look like this: http://www.thetvdb.com/index.php?language=7&order=translation&searching=Search&tab=advancedsearch&imdb_id=tt0303461 Note the imdb_id parameter at the end. Anyway, was just a thought if we weren't able to go through their API.

Omertron commented 9 years ago

Comment #9 originally posted by Omertron on 2008-10-17T18:06:11.000Z:

I think that we should get the API key and follow the site's requirements. Honestly, if we believe their content is good enough for us to use, then we should respect their requirements. Having a look at the application form, it asks for a website and project name. Hardly a challenge ;-)

Omertron commented 9 years ago

Comment #10 originally posted by Omertron on 2008-10-17T18:24:16.000Z:

Having had my rant :P It seems that they don't offer an API way to access the IMDB search url

Omertron commented 9 years ago

Comment #11 originally posted by Omertron on 2008-10-17T18:26:14.000Z:

but I suppose we could still use it for regular queries based on title and year...?

Omertron commented 9 years ago

Comment #12 originally posted by Omertron on 2008-10-17T18:36:39.000Z:

Yes, if we are to assume that TheTVDB has better quality information on TV shows than IMDB then it would be a lot better to pull the information from here using the API than from IMDB

It also seems to be better structured for TV shows (obviously) and set-up for multi-language which will make the non-English contingent of the audience happy :-)

Omertron commented 9 years ago

Comment #13 originally posted by Omertron on 2008-10-23T08:15:39.000Z:

While we're at it I supposed we should link this with issue 59 too

Omertron commented 9 years ago

Comment #14 originally posted by Omertron on 2008-11-18T06:02:19.000Z:

Yup. Seems like all of this TV stuff is related. So I'm implementing this right now along with Issue 59 fun fun

My TheTVDB API is at least complete, and is standalone if anyone wants to play with it or use it for any other purpose. The jar is located under the the lib directory as thetvdbapi.jar

Omertron commented 9 years ago

Comment #15 originally posted by Omertron on 2008-11-19T02:59:03.000Z:

As part of these changes, and changes needed for XBMC, will you guys be splitting up the structure to create items like , , , , , etc?

Or this is all to do later (if at all)?

Omertron commented 9 years ago

Comment #16 originally posted by Omertron on 2008-11-19T04:23:02.000Z:

That's all to-do stuff. This issue is separate from the XBMC enhancement, but there are certainly things that this one can benefit from the XBMC nfo in later implementations.

But as far as the documentation at their wiki here http://xbmc.org/wiki/?title=Import_-_Export_Library they only mention <movie> <tvshow> <episodedetails> and <musicvideo> I didn't see those other ones you mentioned

Omertron commented 9 years ago

Comment #17 originally posted by Omertron on 2008-11-19T04:23:55.000Z:

That's all to-do stuff. This issue is separate from the XBMC enhancement, but there are certainly things that this one can benefit from the XBMC nfo in later implementations.

But as far as the documentation at their wiki here http://xbmc.org/wiki/?title=Import_-_Export_Library they only mention

and I didn't see those other ones you mentioned
Omertron commented 9 years ago

Comment #18 originally posted by Omertron on 2008-11-19T05:38:45.000Z:

They were just examples off the top of my head... ideas!

Omertron commented 9 years ago

Comment #19 originally posted by Omertron on 2008-11-20T07:01:58.000Z:

<empty>