Show Stream preview thumbnails in /strims

[hayksaakian]

Notes from various apis:

all apis assumed stream is live

twitch https://github.com/justintv/Twitch-API/blob/master/v3_resources/streams.md#get-streamschannel

endpoint:

api.twitch.tv/kraken/streams/CHANNEL_NAME

json:

image_url = json.stream.preview.large

hitbox http://developers.hitbox.tv/media

endpoint:

api.hitbox.tv/media/stream/CHANNEL_NAME

json:

image_url = "edge.sf.hitbox.tv" + json.livestream[0].media_thumbnail_large

http://static/img/media/live/newlegacyinc_large_000.jpg

ustream http://ustream.github.io/api-docs/channel.html

endpoint:

https://api.ustream.tv/channels/CHANNEL_IDjson

json

image_url = json.channel.thumbnail.live

those seem like the most popular platforms, so let's start with them.

Notes:

• castamp is a massive hack, and we won't be getting thumbnails
• mlg has images, but not real thumbnails, but might not be worth the effort (api is undocumented) see: http://streamapi.majorleaguegaming.com/service/streams/all and: http://www.majorleaguegaming.com/api/channels/all.js?fields=id,name,slug,subtitle,stream_name,type,is_hidden,image_1_1,image_16_9_small,image_16_9_medium,image_background,url,embed_code,description
• youtube has thumbnails, not sure if live has an api or thumbnails
• azubu apparently does http://content.azubu.tv/api/

[hayksaakian]

We now support thumbnails for everything except Castamp and MLG

Castamp would require some kind of scraping hack since they don't have an API. Do they even have thumbnails?

MLG only provides these fields via API, but maybe there's some API we don't know about

"Only allowed fields are: id, name, slug, subtitle, description, stream_name, type, default_tab, send_tweet, send_email, send_push_notification, is_hidden, chat_is_disabled, bracket_url, image_1_1, image_16_9, image_16_9_small, image_16_9_medium, image_16_9_large, image_background, social_twitter, url, stream_featured, stream_sort_order, embed_code, mobile_embed_code, tags, tag_names, children, subscription_url, donate_url"

http://www.majorleaguegaming.com/api/channels/all.js?slug=csgo&fields=id,name,slug,subtitle,stream_name,image_16_9_medium,description

[hayksaakian]

get viewer numbers on a specific stream:

$STREAM_NAME usually looks like mlgXYZ (where xyz is some number)

http://streamapi.majorleaguegaming.com/service/streams/status/$STREAM_NAME

get HLS playlists for a specific stream

http://streamapi.majorleaguegaming.com/service/streams/playback/$STREAM_NAME?format=all

[hayksaakian]

placholders:

mlg: http://s3.amazonaws.com/s3.majorleaguegaming.com/tv-category-icons/image_16_9s/95/medium/comingsoon.jpg?1390332269

[hayksaakian]

mlg ready as of

https://github.com/ILiedAboutCake/OverRustle-API/commit/ec7cbfe38d47927ec5d55e363ea4f454a27dbffe

keep in mind the thumbs are going to not really be thumbs, but rather a static image the channel woner chose.

TODO:

• twitch vods
• dailymotion
• picarto.tv default: https://www.picarto.tv/img/thumbnail_stream_default.png

Never:

• castamp
• advanced (we might be able to do it with https://www.url2png.com/ or some other URL to Image thing)

[hayksaakian]

for website screenshots, we're using http://www.page2images.com/my_account/apikey

they have a 3000 api calls / month free tier

[hayksaakian]

punting screenshots