iggyvolz / korra-dl

Download episodes of The Legend of Korra on the terminal

Current version: 2014.10.3.2

Download episodes of The Legend of Korra on the terminal, directly from the Nickelodeon API!

Prerequisites

*ffmpeg *python (2 or 3) *git (optional)

If not pre-installed, all three of these can be installed quickly using brew, apt-get, or chocolatey. Run (brew install/sudo apt-get install/cinst) ffmpeg python git

Note: Mac already includes python and git, so there is no need to install these using brew.

Additional note: Ubuntu felt the need to rename ffmpeg and make changes to it. To install the actual ffmpeg, run sudo apt-add-repository ppa:jon-severinsson/ffmpeg;sudo apt-get update before attempting to install ffmpeg.

Another additional note: Has not been tested on Windows. Windows support is experimental as I don't have a Windows computer. Feel free to report issues or make pull requests.

How to run

Run the following script to install to /usr/local/bin/korra-dl:

curl https://raw.githubusercontent.com/iggyvolz/korra-dl/go/install|python

You can also clone the repo and run ./build to build from the episodes folder.

The syntax is korra-dl [episode number] [output type] [output file].

Output types

Nick offers 7 output types for download, and these are all available using the output type parameter (the second parameter). The higher the format number, the better quality the video is, and the longer it takes to download:

Format	Width	Height	Bitrate
1	384	216	300
2	384	216	400
3	512	288	750
4	640	360	1200
5	768	432	1700
6	960	540	2200
7	1280	720	3500

korra-dl's Issues

401 (215) clip

Add the 401/205 clip. http://www.nick.com/videos/clip/korra-215-clip.html

1080p support

There's been some indication from various people on the internet (I cannot confirm) that nick.com actually supports streaming up to 1080p. Can you confirm that? If so, is it possible for korra-dl to support 1080p streams?

Episode 403

Add episode 403

Season 4 Clip (Episode 400)

Put in the Episode 4 Clip, to be released 9/26.

Most episodes are not available

The expected response from the Nickelodeon API does not match the actual response.

I get the following traceback when trying to execute korra-dl:

$ python korra-dl 101 7 101.mp4
mkdir: /tmp/korra-dl: File exists
Traceback (most recent call last):
  File "korra-dl", line 72, in <module>
    for (i,item) in enumerate(ElementTree.XML(text)[0].findall("item")):
  File "/usr/local/Cellar/python/2.7.6_1/Frameworks/Python.framework/Versions/2.7/lib/python2.7/xml/etree/ElementTree.py", line 266, in __getitem__
return self._children[index]
IndexError: list index out of range

From this, and in looking at the code, it appears that the URL being requested is: http://udat.mtvnservices.com/service1/dispatch.htm?feed=nick_arc_player_prime&plugin.stage=live&mgid=mgid:arc:episode:nick.com:3176b6af-dda9-4b3b-a725-0fbc9c897c24 which responds with the following:

<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:media="http://search.yahoo.com/mrss/" xmlns:mediaad="http://blip.tv/mediaad"
 version="2.0"/>

The referenced line 72 from the traceback is expecting to find an "item" node which does not exist in the above response.

I am using OS 10.9 and have installed Python 2.7.6 through HomeBrew.