Merge branch 'jukebox' of https://github.com/remitamine/youtube-dl into remitamine...
[youtube-dl] / youtube_dl / downloader / f4m.py
1 from __future__ import division, unicode_literals
2
3 import base64
4 import io
5 import itertools
6 import os
7 import time
8
9 from .fragment import FragmentFD
10 from ..compat import (
11     compat_etree_fromstring,
12     compat_urlparse,
13     compat_urllib_error,
14     compat_urllib_parse_urlparse,
15 )
16 from ..utils import (
17     encodeFilename,
18     fix_xml_ampersands,
19     sanitize_open,
20     struct_pack,
21     struct_unpack,
22     xpath_text,
23 )
24
25
26 class FlvReader(io.BytesIO):
27     """
28     Reader for Flv files
29     The file format is documented in https://www.adobe.com/devnet/f4v.html
30     """
31
32     # Utility functions for reading numbers and strings
33     def read_unsigned_long_long(self):
34         return struct_unpack('!Q', self.read(8))[0]
35
36     def read_unsigned_int(self):
37         return struct_unpack('!I', self.read(4))[0]
38
39     def read_unsigned_char(self):
40         return struct_unpack('!B', self.read(1))[0]
41
42     def read_string(self):
43         res = b''
44         while True:
45             char = self.read(1)
46             if char == b'\x00':
47                 break
48             res += char
49         return res
50
51     def read_box_info(self):
52         """
53         Read a box and return the info as a tuple: (box_size, box_type, box_data)
54         """
55         real_size = size = self.read_unsigned_int()
56         box_type = self.read(4)
57         header_end = 8
58         if size == 1:
59             real_size = self.read_unsigned_long_long()
60             header_end = 16
61         return real_size, box_type, self.read(real_size - header_end)
62
63     def read_asrt(self):
64         # version
65         self.read_unsigned_char()
66         # flags
67         self.read(3)
68         quality_entry_count = self.read_unsigned_char()
69         # QualityEntryCount
70         for i in range(quality_entry_count):
71             self.read_string()
72
73         segment_run_count = self.read_unsigned_int()
74         segments = []
75         for i in range(segment_run_count):
76             first_segment = self.read_unsigned_int()
77             fragments_per_segment = self.read_unsigned_int()
78             segments.append((first_segment, fragments_per_segment))
79
80         return {
81             'segment_run': segments,
82         }
83
84     def read_afrt(self):
85         # version
86         self.read_unsigned_char()
87         # flags
88         self.read(3)
89         # time scale
90         self.read_unsigned_int()
91
92         quality_entry_count = self.read_unsigned_char()
93         # QualitySegmentUrlModifiers
94         for i in range(quality_entry_count):
95             self.read_string()
96
97         fragments_count = self.read_unsigned_int()
98         fragments = []
99         for i in range(fragments_count):
100             first = self.read_unsigned_int()
101             first_ts = self.read_unsigned_long_long()
102             duration = self.read_unsigned_int()
103             if duration == 0:
104                 discontinuity_indicator = self.read_unsigned_char()
105             else:
106                 discontinuity_indicator = None
107             fragments.append({
108                 'first': first,
109                 'ts': first_ts,
110                 'duration': duration,
111                 'discontinuity_indicator': discontinuity_indicator,
112             })
113
114         return {
115             'fragments': fragments,
116         }
117
118     def read_abst(self):
119         # version
120         self.read_unsigned_char()
121         # flags
122         self.read(3)
123
124         self.read_unsigned_int()  # BootstrapinfoVersion
125         # Profile,Live,Update,Reserved
126         flags = self.read_unsigned_char()
127         live = flags & 0x20 != 0
128         # time scale
129         self.read_unsigned_int()
130         # CurrentMediaTime
131         self.read_unsigned_long_long()
132         # SmpteTimeCodeOffset
133         self.read_unsigned_long_long()
134
135         self.read_string()  # MovieIdentifier
136         server_count = self.read_unsigned_char()
137         # ServerEntryTable
138         for i in range(server_count):
139             self.read_string()
140         quality_count = self.read_unsigned_char()
141         # QualityEntryTable
142         for i in range(quality_count):
143             self.read_string()
144         # DrmData
145         self.read_string()
146         # MetaData
147         self.read_string()
148
149         segments_count = self.read_unsigned_char()
150         segments = []
151         for i in range(segments_count):
152             box_size, box_type, box_data = self.read_box_info()
153             assert box_type == b'asrt'
154             segment = FlvReader(box_data).read_asrt()
155             segments.append(segment)
156         fragments_run_count = self.read_unsigned_char()
157         fragments = []
158         for i in range(fragments_run_count):
159             box_size, box_type, box_data = self.read_box_info()
160             assert box_type == b'afrt'
161             fragments.append(FlvReader(box_data).read_afrt())
162
163         return {
164             'segments': segments,
165             'fragments': fragments,
166             'live': live,
167         }
168
169     def read_bootstrap_info(self):
170         total_size, box_type, box_data = self.read_box_info()
171         assert box_type == b'abst'
172         return FlvReader(box_data).read_abst()
173
174
175 def read_bootstrap_info(bootstrap_bytes):
176     return FlvReader(bootstrap_bytes).read_bootstrap_info()
177
178
179 def build_fragments_list(boot_info):
180     """ Return a list of (segment, fragment) for each fragment in the video """
181     res = []
182     segment_run_table = boot_info['segments'][0]
183     fragment_run_entry_table = boot_info['fragments'][0]['fragments']
184     first_frag_number = fragment_run_entry_table[0]['first']
185     fragments_counter = itertools.count(first_frag_number)
186     for segment, fragments_count in segment_run_table['segment_run']:
187         for _ in range(fragments_count):
188             res.append((segment, next(fragments_counter)))
189
190     if boot_info['live']:
191         res = res[-2:]
192
193     return res
194
195
196 def write_unsigned_int(stream, val):
197     stream.write(struct_pack('!I', val))
198
199
200 def write_unsigned_int_24(stream, val):
201     stream.write(struct_pack('!I', val)[1:])
202
203
204 def write_flv_header(stream):
205     """Writes the FLV header to stream"""
206     # FLV header
207     stream.write(b'FLV\x01')
208     stream.write(b'\x05')
209     stream.write(b'\x00\x00\x00\x09')
210     stream.write(b'\x00\x00\x00\x00')
211
212
213 def write_metadata_tag(stream, metadata):
214     """Writes optional metadata tag to stream"""
215     SCRIPT_TAG = b'\x12'
216     FLV_TAG_HEADER_LEN = 11
217
218     if metadata:
219         stream.write(SCRIPT_TAG)
220         write_unsigned_int_24(stream, len(metadata))
221         stream.write(b'\x00\x00\x00\x00\x00\x00\x00')
222         stream.write(metadata)
223         write_unsigned_int(stream, FLV_TAG_HEADER_LEN + len(metadata))
224
225
226 def _add_ns(prop):
227     return '{http://ns.adobe.com/f4m/1.0}%s' % prop
228
229
230 class F4mFD(FragmentFD):
231     """
232     A downloader for f4m manifests or AdobeHDS.
233     """
234
235     FD_NAME = 'f4m'
236
237     def _get_unencrypted_media(self, doc):
238         media = doc.findall(_add_ns('media'))
239         if not media:
240             self.report_error('No media found')
241         for e in (doc.findall(_add_ns('drmAdditionalHeader')) +
242                   doc.findall(_add_ns('drmAdditionalHeaderSet'))):
243             # If id attribute is missing it's valid for all media nodes
244             # without drmAdditionalHeaderId or drmAdditionalHeaderSetId attribute
245             if 'id' not in e.attrib:
246                 self.report_error('Missing ID in f4m DRM')
247         media = list(filter(lambda e: 'drmAdditionalHeaderId' not in e.attrib and
248                                       'drmAdditionalHeaderSetId' not in e.attrib,
249                             media))
250         if not media:
251             self.report_error('Unsupported DRM')
252         return media
253
254     def _get_bootstrap_from_url(self, bootstrap_url):
255         bootstrap = self.ydl.urlopen(bootstrap_url).read()
256         return read_bootstrap_info(bootstrap)
257
258     def _update_live_fragments(self, bootstrap_url, latest_fragment):
259         fragments_list = []
260         retries = 30
261         while (not fragments_list) and (retries > 0):
262             boot_info = self._get_bootstrap_from_url(bootstrap_url)
263             fragments_list = build_fragments_list(boot_info)
264             fragments_list = [f for f in fragments_list if f[1] > latest_fragment]
265             if not fragments_list:
266                 # Retry after a while
267                 time.sleep(5.0)
268                 retries -= 1
269
270         if not fragments_list:
271             self.report_error('Failed to update fragments')
272
273         return fragments_list
274
275     def _parse_bootstrap_node(self, node, base_url):
276         if node.text is None:
277             bootstrap_url = compat_urlparse.urljoin(
278                 base_url, node.attrib['url'])
279             boot_info = self._get_bootstrap_from_url(bootstrap_url)
280         else:
281             bootstrap_url = None
282             bootstrap = base64.b64decode(node.text.encode('ascii'))
283             boot_info = read_bootstrap_info(bootstrap)
284         return (boot_info, bootstrap_url)
285
286     def real_download(self, filename, info_dict):
287         man_url = info_dict['url']
288         requested_bitrate = info_dict.get('tbr')
289         self.to_screen('[%s] Downloading f4m manifest' % self.FD_NAME)
290         urlh = self.ydl.urlopen(man_url)
291         man_url = urlh.geturl()
292         # Some manifests may be malformed, e.g. prosiebensat1 generated manifests
293         # (see https://github.com/rg3/youtube-dl/issues/6215#issuecomment-121704244
294         # and https://github.com/rg3/youtube-dl/issues/7823)
295         manifest = fix_xml_ampersands(urlh.read().decode('utf-8', 'ignore')).strip()
296
297         doc = compat_etree_fromstring(manifest)
298         formats = [(int(f.attrib.get('bitrate', -1)), f)
299                    for f in self._get_unencrypted_media(doc)]
300         if requested_bitrate is None:
301             # get the best format
302             formats = sorted(formats, key=lambda f: f[0])
303             rate, media = formats[-1]
304         else:
305             rate, media = list(filter(
306                 lambda f: int(f[0]) == requested_bitrate, formats))[0]
307
308         base_url = compat_urlparse.urljoin(man_url, media.attrib['url'])
309         bootstrap_node = doc.find(_add_ns('bootstrapInfo'))
310         boot_info, bootstrap_url = self._parse_bootstrap_node(bootstrap_node, base_url)
311         live = boot_info['live']
312         metadata_node = media.find(_add_ns('metadata'))
313         if metadata_node is not None:
314             metadata = base64.b64decode(metadata_node.text.encode('ascii'))
315         else:
316             metadata = None
317
318         fragments_list = build_fragments_list(boot_info)
319         if self.params.get('test', False):
320             # We only download the first fragment
321             fragments_list = fragments_list[:1]
322         total_frags = len(fragments_list)
323         # For some akamai manifests we'll need to add a query to the fragment url
324         akamai_pv = xpath_text(doc, _add_ns('pv-2.0'))
325
326         ctx = {
327             'filename': filename,
328             'total_frags': total_frags,
329         }
330
331         self._prepare_frag_download(ctx)
332
333         dest_stream = ctx['dest_stream']
334
335         write_flv_header(dest_stream)
336         if not live:
337             write_metadata_tag(dest_stream, metadata)
338
339         base_url_parsed = compat_urllib_parse_urlparse(base_url)
340
341         self._start_frag_download(ctx)
342
343         frags_filenames = []
344         while fragments_list:
345             seg_i, frag_i = fragments_list.pop(0)
346             name = 'Seg%d-Frag%d' % (seg_i, frag_i)
347             query = []
348             if base_url_parsed.query:
349                 query.append(base_url_parsed.query)
350             if akamai_pv:
351                 query.append(akamai_pv.strip(';'))
352             if info_dict.get('extra_param_to_segment_url'):
353                 query.append(info_dict['extra_param_to_segment_url'])
354             url_parsed = base_url_parsed._replace(path=base_url_parsed.path + name, query='&'.join(query))
355             frag_filename = '%s-%s' % (ctx['tmpfilename'], name)
356             try:
357                 success = ctx['dl'].download(frag_filename, {'url': url_parsed.geturl()})
358                 if not success:
359                     return False
360                 (down, frag_sanitized) = sanitize_open(frag_filename, 'rb')
361                 down_data = down.read()
362                 down.close()
363                 reader = FlvReader(down_data)
364                 while True:
365                     _, box_type, box_data = reader.read_box_info()
366                     if box_type == b'mdat':
367                         dest_stream.write(box_data)
368                         break
369                 if live:
370                     os.remove(encodeFilename(frag_sanitized))
371                 else:
372                     frags_filenames.append(frag_sanitized)
373             except (compat_urllib_error.HTTPError, ) as err:
374                 if live and (err.code == 404 or err.code == 410):
375                     # We didn't keep up with the live window. Continue
376                     # with the next available fragment.
377                     msg = 'Fragment %d unavailable' % frag_i
378                     self.report_warning(msg)
379                     fragments_list = []
380                 else:
381                     raise
382
383             if not fragments_list and live and bootstrap_url:
384                 fragments_list = self._update_live_fragments(bootstrap_url, frag_i)
385                 total_frags += len(fragments_list)
386                 if fragments_list and (fragments_list[0][1] > frag_i + 1):
387                     msg = 'Missed %d fragments' % (fragments_list[0][1] - (frag_i + 1))
388                     self.report_warning(msg)
389
390         self._finish_frag_download(ctx)
391
392         for frag_file in frags_filenames:
393             os.remove(encodeFilename(frag_file))
394
395         return True