smooth-dl.py: support downloading from a local file in download_file()
[smooth-dl.git] / README
1 smooth-dl.py is a program to download content served using Smooth Streaming
2 technology, it currently works only with Rai.tv
3
4 Simple tutorial:
5
6 The "manifest file" needed by smooth-dl can be retrieved in several ways:
7
8  - Install the SilverSpoof.user.js Greasemonkey script form the 'scripts/'
9    directory, then visit a page on the Rai.tv site which is using Smooth
10    Streaming, look at the source page and search for the 'mediaUri' string,
11    this is most likely the client Manifest, or the address of a playlist
12    containing the client Manifest.
13
14  - Alternatively you can install the "Direct Download Links" Greasemonkey
15    script from http://userscripts.org/scripts/show/108910 and you will get
16    a "Direct Link" to the *.csm file, just do "Copy Link Location" and use it
17    like in the smooth-dl lines below.
18
19 View the Manifest of some RAI content:
20   ./smooth-dl.py -i "http://smoothreplay.rai.it/ReplayTV/manifests/38640.csm"
21
22 Download the lowest video quality in a dir named "rai1":
23   ./smooth-dl.py -q 3 - d rai1 "http://smoothreplay.rai.it/ReplayTV/manifests/38640.csm"
24
25 And mux the streams together using for example the command like outputted by
26 smooth-dl.py
27
28 Note, if ffmpeg returns an error like:
29   [avi @ 0xe39a50] Aspect ratio mismatch between encoder and muxer layer
30 you can force the aspect with the "-aspect" options, for a 720x544 video the
31 option will be "-aspect 45:34".
32
33 Show the sync delay between the video and audio streams:
34   ./smooth-dl.py -s "http://smoothreplay.rai.it/ReplayTV/manifests/38640.csm"
35
36 You can use the av sync delay in the conversion scripts in the 'scripts/'
37 directory.
38
39 Yeah, it's "Occhio alla Spesa" in the examples above but there's an uncle of
40 mine as a guest in the first part.
41
42
43 For multi-clip videos you have to download the single clips one by one
44 selecting the right streams:
45 ./smooth-dl.py -d report -i http://www.rai.it/dl/video/smooth/report-2811201021.38.00.csm
46 ./smooth-dl.py -d report -v 0 -a 1 http://www.rai.it/dl/video/smooth/report-2811201021.38.00.csm
47 ./smooth-dl.py -d report -v 2 -a 3 http://www.rai.it/dl/video/smooth/report-2811201021.38.00.csm
48 ./smooth-dl.py -d report -v 4 -a 5 http://www.rai.it/dl/video/smooth/report-2811201021.38.00.csm
49
50 Examples of working Manifests on Rai Replay:
51 http://smoothreplay.rai.it/ReplayTV/manifests/38640.csm
52 http://smoothreplay.rai.it/replaytv/Annozero/20-05-2010_/20-05-2010.ism
53 http://www.rai.it/dl/video/smooth/report-2811201021.38.00.csm
54
55
56 Accesspolicy:
57 http://smoothreplay.rai.it/clientaccesspolicy.xml
58
59 Examples of currently NOT WORKING Manifests:
60 http://dorigny.v.free.fr/blend/Wildlife.ismc
61 http://mediadl.microsoft.com/mediadl/iisnet/smoothmedia/Experience/BigBuckBunny_720p.ism
62 http://smooth.edge3b.rtl.hu/eb28faa6-c3bc-4a5a-9dcf-11329bf8d1d0/IB05905A_b5fdf62e-1857-4e60-8d3f-dfa08e69a8a5.ism