1 from __future__ import unicode_literals
9 from .common import AudioConversionError, PostProcessor
11 from ..compat import (
12 compat_subprocess_get_DEVNULL,
27 class FFmpegPostProcessorError(PostProcessingError):
31 class FFmpegPostProcessor(PostProcessor):
32 def __init__(self, downloader=None):
33 PostProcessor.__init__(self, downloader)
34 self._determine_executables()
36 def check_version(self):
37 if not self.available:
38 raise FFmpegPostProcessorError('ffmpeg or avconv not found. Please install one.')
40 required_version = '10-0' if self.basename == 'avconv' else '1.0'
41 if is_outdated_version(
42 self._versions[self.basename], required_version):
43 warning = 'Your copy of %s is outdated, update %s to version %s or newer if you encounter any errors.' % (
44 self.basename, self.basename, required_version)
46 self._downloader.report_warning(warning)
49 def get_versions(downloader=None):
50 return FFmpegPostProcessor(downloader)._versions
52 def _determine_executables(self):
53 programs = ['avprobe', 'avconv', 'ffmpeg', 'ffprobe']
54 prefer_ffmpeg = self._downloader.params.get('prefer_ffmpeg', False)
57 self.probe_basename = None
62 location = self._downloader.params.get('ffmpeg_location')
63 if location is not None:
64 if not os.path.exists(location):
65 self._downloader.report_warning(
66 'ffmpeg-location %s does not exist! '
67 'Continuing without avconv/ffmpeg.' % (location))
70 elif not os.path.isdir(location):
71 basename = os.path.splitext(os.path.basename(location))[0]
72 if basename not in programs:
73 self._downloader.report_warning(
74 'Cannot identify executable %s, its basename should be one of %s. '
75 'Continuing without avconv/ffmpeg.' %
76 (location, ', '.join(programs)))
79 location = os.path.dirname(os.path.abspath(location))
80 if basename in ('ffmpeg', 'ffprobe'):
84 (p, os.path.join(location, p)) for p in programs)
85 self._versions = dict(
86 (p, get_exe_version(self._paths[p], args=['-version']))
88 if self._versions is None:
89 self._versions = dict(
90 (p, get_exe_version(p, args=['-version'])) for p in programs)
91 self._paths = dict((p, p) for p in programs)
94 prefs = ('ffmpeg', 'avconv')
96 prefs = ('avconv', 'ffmpeg')
103 prefs = ('ffprobe', 'avprobe')
105 prefs = ('avprobe', 'ffprobe')
107 if self._versions[p]:
108 self.probe_basename = p
113 return self.basename is not None
116 def executable(self):
117 return self._paths[self.basename]
120 def probe_available(self):
121 return self.probe_basename is not None
124 def probe_executable(self):
125 return self._paths[self.probe_basename]
127 def run_ffmpeg_multiple_files(self, input_paths, out_path, opts):
131 os.stat(encodeFilename(path)).st_mtime for path in input_paths)
134 for path in input_paths:
135 files_cmd.extend([encodeArgument('-i'), encodeFilename(path, True)])
136 cmd = ([encodeFilename(self.executable, True), encodeArgument('-y')] +
138 [encodeArgument(o) for o in opts] +
139 [encodeFilename(self._ffmpeg_filename_argument(out_path), True)])
141 if self._downloader.params.get('verbose', False):
142 self._downloader.to_screen('[debug] ffmpeg command line: %s' % shell_quote(cmd))
143 p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, stdin=subprocess.PIPE)
144 stdout, stderr = p.communicate()
145 if p.returncode != 0:
146 stderr = stderr.decode('utf-8', 'replace')
147 msg = stderr.strip().split('\n')[-1]
148 raise FFmpegPostProcessorError(msg)
149 self.try_utime(out_path, oldest_mtime, oldest_mtime)
151 def run_ffmpeg(self, path, out_path, opts):
152 self.run_ffmpeg_multiple_files([path], out_path, opts)
154 def _ffmpeg_filename_argument(self, fn):
155 # ffmpeg broke --, see https://ffmpeg.org/trac/ffmpeg/ticket/2127 for details
156 if fn.startswith('-'):
161 class FFmpegExtractAudioPP(FFmpegPostProcessor):
162 def __init__(self, downloader=None, preferredcodec=None, preferredquality=None, nopostoverwrites=False):
163 FFmpegPostProcessor.__init__(self, downloader)
164 if preferredcodec is None:
165 preferredcodec = 'best'
166 self._preferredcodec = preferredcodec
167 self._preferredquality = preferredquality
168 self._nopostoverwrites = nopostoverwrites
170 def get_audio_codec(self, path):
172 if not self.probe_available:
173 raise PostProcessingError('ffprobe or avprobe not found. Please install one.')
176 encodeFilename(self.probe_executable, True),
177 encodeArgument('-show_streams'),
178 encodeFilename(self._ffmpeg_filename_argument(path), True)]
179 if self._downloader.params.get('verbose', False):
180 self._downloader.to_screen('[debug] %s command line: %s' % (self.basename, shell_quote(cmd)))
181 handle = subprocess.Popen(cmd, stderr=compat_subprocess_get_DEVNULL(), stdout=subprocess.PIPE, stdin=subprocess.PIPE)
182 output = handle.communicate()[0]
183 if handle.wait() != 0:
185 except (IOError, OSError):
188 for line in output.decode('ascii', 'ignore').split('\n'):
189 if line.startswith('codec_name='):
190 audio_codec = line.split('=')[1].strip()
191 elif line.strip() == 'codec_type=audio' and audio_codec is not None:
195 def run_ffmpeg(self, path, out_path, codec, more_opts):
199 acodec_opts = ['-acodec', codec]
200 opts = ['-vn'] + acodec_opts + more_opts
202 FFmpegPostProcessor.run_ffmpeg(self, path, out_path, opts)
203 except FFmpegPostProcessorError as err:
204 raise AudioConversionError(err.msg)
206 def run(self, information):
207 path = information['filepath']
209 filecodec = self.get_audio_codec(path)
210 if filecodec is None:
211 raise PostProcessingError('WARNING: unable to obtain file audio codec with ffprobe')
214 if self._preferredcodec == 'best' or self._preferredcodec == filecodec or (self._preferredcodec == 'm4a' and filecodec == 'aac'):
215 if filecodec == 'aac' and self._preferredcodec in ['m4a', 'best']:
216 # Lossless, but in another container
219 more_opts = ['-bsf:a', 'aac_adtstoasc']
220 elif filecodec in ['aac', 'mp3', 'vorbis', 'opus']:
221 # Lossless if possible
223 extension = filecodec
224 if filecodec == 'aac':
225 more_opts = ['-f', 'adts']
226 if filecodec == 'vorbis':
230 acodec = 'libmp3lame'
233 if self._preferredquality is not None:
234 if int(self._preferredquality) < 10:
235 more_opts += ['-q:a', self._preferredquality]
237 more_opts += ['-b:a', self._preferredquality + 'k']
239 # We convert the audio (lossy)
240 acodec = {'mp3': 'libmp3lame', 'aac': 'aac', 'm4a': 'aac', 'opus': 'opus', 'vorbis': 'libvorbis', 'wav': None}[self._preferredcodec]
241 extension = self._preferredcodec
243 if self._preferredquality is not None:
244 # The opus codec doesn't support the -aq option
245 if int(self._preferredquality) < 10 and extension != 'opus':
246 more_opts += ['-q:a', self._preferredquality]
248 more_opts += ['-b:a', self._preferredquality + 'k']
249 if self._preferredcodec == 'aac':
250 more_opts += ['-f', 'adts']
251 if self._preferredcodec == 'm4a':
252 more_opts += ['-bsf:a', 'aac_adtstoasc']
253 if self._preferredcodec == 'vorbis':
255 if self._preferredcodec == 'wav':
257 more_opts += ['-f', 'wav']
259 prefix, sep, ext = path.rpartition('.') # not os.path.splitext, since the latter does not work on unicode in all setups
260 new_path = prefix + sep + extension
262 # If we download foo.mp3 and convert it to... foo.mp3, then don't delete foo.mp3, silly.
263 if (new_path == path or
264 (self._nopostoverwrites and os.path.exists(encodeFilename(new_path)))):
265 self._downloader.to_screen('[youtube] Post-process file %s exists, skipping' % new_path)
266 return [], information
269 self._downloader.to_screen('[' + self.basename + '] Destination: ' + new_path)
270 self.run_ffmpeg(path, new_path, acodec, more_opts)
271 except AudioConversionError as e:
272 raise PostProcessingError(
273 'audio conversion failed: ' + e.msg)
275 raise PostProcessingError('error running ' + self.basename)
277 # Try to update the date time for extracted audio file.
278 if information.get('filetime') is not None:
280 new_path, time.time(), information['filetime'],
281 errnote='Cannot update utime of audio file')
283 information['filepath'] = new_path
284 information['ext'] = extension
286 return [path], information
289 class FFmpegVideoConvertorPP(FFmpegPostProcessor):
290 def __init__(self, downloader=None, preferedformat=None):
291 super(FFmpegVideoConvertorPP, self).__init__(downloader)
292 self._preferedformat = preferedformat
294 def run(self, information):
295 path = information['filepath']
296 prefix, sep, ext = path.rpartition('.')
297 outpath = prefix + sep + self._preferedformat
298 if information['ext'] == self._preferedformat:
299 self._downloader.to_screen('[ffmpeg] Not converting video file %s - already is in target format %s' % (path, self._preferedformat))
300 return [], information
301 self._downloader.to_screen('[' + 'ffmpeg' + '] Converting video from %s to %s, Destination: ' % (information['ext'], self._preferedformat) + outpath)
302 self.run_ffmpeg(path, outpath, [])
303 information['filepath'] = outpath
304 information['format'] = self._preferedformat
305 information['ext'] = self._preferedformat
306 return [path], information
309 class FFmpegEmbedSubtitlePP(FFmpegPostProcessor):
310 # See http://www.loc.gov/standards/iso639-2/ISO-639-2_utf-8.txt
499 def _conver_lang_code(cls, code):
500 """Convert language code from ISO 639-1 to ISO 639-2/T"""
501 return cls._lang_map.get(code[:2])
503 def run(self, information):
504 if information['ext'] not in ['mp4', 'mkv']:
505 self._downloader.to_screen('[ffmpeg] Subtitles can only be embedded in mp4 or mkv files')
506 return [], information
507 subtitles = information.get('requested_subtitles')
509 self._downloader.to_screen('[ffmpeg] There aren\'t any subtitles to embed')
510 return [], information
512 sub_langs = list(subtitles.keys())
513 filename = information['filepath']
514 sub_filenames = [subtitles_filename(filename, lang, sub_info['ext']) for lang, sub_info in subtitles.items()]
515 input_files = [filename] + sub_filenames
520 # Don't copy the existing subtitles, we may be running the
521 # postprocessor a second time
524 if information['ext'] == 'mp4':
525 opts += ['-c:s', 'mov_text']
526 for (i, lang) in enumerate(sub_langs):
527 opts.extend(['-map', '%d:0' % (i + 1)])
528 lang_code = self._conver_lang_code(lang)
529 if lang_code is not None:
530 opts.extend(['-metadata:s:s:%d' % i, 'language=%s' % lang_code])
532 temp_filename = prepend_extension(filename, 'temp')
533 self._downloader.to_screen('[ffmpeg] Embedding subtitles in \'%s\'' % filename)
534 self.run_ffmpeg_multiple_files(input_files, temp_filename, opts)
535 os.remove(encodeFilename(filename))
536 os.rename(encodeFilename(temp_filename), encodeFilename(filename))
538 return sub_filenames, information
541 class FFmpegMetadataPP(FFmpegPostProcessor):
544 if info.get('title') is not None:
545 metadata['title'] = info['title']
546 if info.get('upload_date') is not None:
547 metadata['date'] = info['upload_date']
548 if info.get('artist') is not None:
549 metadata['artist'] = info['artist']
550 elif info.get('uploader') is not None:
551 metadata['artist'] = info['uploader']
552 elif info.get('uploader_id') is not None:
553 metadata['artist'] = info['uploader_id']
554 if info.get('description') is not None:
555 metadata['description'] = info['description']
556 metadata['comment'] = info['description']
557 if info.get('webpage_url') is not None:
558 metadata['purl'] = info['webpage_url']
559 if info.get('album') is not None:
560 metadata['album'] = info['album']
563 self._downloader.to_screen('[ffmpeg] There isn\'t any metadata to add')
566 filename = info['filepath']
567 temp_filename = prepend_extension(filename, 'temp')
569 if info['ext'] == 'm4a':
570 options = ['-vn', '-acodec', 'copy']
572 options = ['-c', 'copy']
574 for (name, value) in metadata.items():
575 options.extend(['-metadata', '%s=%s' % (name, value)])
577 self._downloader.to_screen('[ffmpeg] Adding metadata to \'%s\'' % filename)
578 self.run_ffmpeg(filename, temp_filename, options)
579 os.remove(encodeFilename(filename))
580 os.rename(encodeFilename(temp_filename), encodeFilename(filename))
584 class FFmpegMergerPP(FFmpegPostProcessor):
586 filename = info['filepath']
587 temp_filename = prepend_extension(filename, 'temp')
588 args = ['-c', 'copy', '-map', '0:v:0', '-map', '1:a:0']
589 self._downloader.to_screen('[ffmpeg] Merging formats into "%s"' % filename)
590 self.run_ffmpeg_multiple_files(info['__files_to_merge'], temp_filename, args)
591 os.rename(encodeFilename(temp_filename), encodeFilename(filename))
592 return info['__files_to_merge'], info
595 # TODO: figure out merge-capable ffmpeg version
596 if self.basename != 'avconv':
599 required_version = '10-0'
600 if is_outdated_version(
601 self._versions[self.basename], required_version):
602 warning = ('Your copy of %s is outdated and unable to properly mux separate video and audio files, '
603 'youtube-dl will download single file media. '
604 'Update %s to version %s or newer to fix this.') % (
605 self.basename, self.basename, required_version)
607 self._downloader.report_warning(warning)
612 class FFmpegFixupStretchedPP(FFmpegPostProcessor):
614 stretched_ratio = info.get('stretched_ratio')
615 if stretched_ratio is None or stretched_ratio == 1:
618 filename = info['filepath']
619 temp_filename = prepend_extension(filename, 'temp')
621 options = ['-c', 'copy', '-aspect', '%f' % stretched_ratio]
622 self._downloader.to_screen('[ffmpeg] Fixing aspect ratio in "%s"' % filename)
623 self.run_ffmpeg(filename, temp_filename, options)
625 os.remove(encodeFilename(filename))
626 os.rename(encodeFilename(temp_filename), encodeFilename(filename))
631 class FFmpegFixupM4aPP(FFmpegPostProcessor):
633 if info.get('container') != 'm4a_dash':
636 filename = info['filepath']
637 temp_filename = prepend_extension(filename, 'temp')
639 options = ['-c', 'copy', '-f', 'mp4']
640 self._downloader.to_screen('[ffmpeg] Correcting container in "%s"' % filename)
641 self.run_ffmpeg(filename, temp_filename, options)
643 os.remove(encodeFilename(filename))
644 os.rename(encodeFilename(temp_filename), encodeFilename(filename))
649 class FFmpegSubtitlesConvertorPP(FFmpegPostProcessor):
650 def __init__(self, downloader=None, format=None):
651 super(FFmpegSubtitlesConvertorPP, self).__init__(downloader)
655 subs = info.get('requested_subtitles')
656 filename = info['filepath']
657 new_ext = self.format
659 if new_format == 'vtt':
660 new_format = 'webvtt'
662 self._downloader.to_screen('[ffmpeg] There aren\'t any subtitles to convert')
664 self._downloader.to_screen('[ffmpeg] Converting subtitles')
665 for lang, sub in subs.items():
668 self._downloader.to_screen(
669 '[ffmpeg] Subtitle file for %s is already in the requested'
672 new_file = subtitles_filename(filename, lang, new_ext)
674 if ext == 'dfxp' or ext == 'ttml':
675 self._downloader.report_warning(
676 'You have requested to convert dfxp (TTML) subtitles into another format, '
677 'which results in style information loss')
679 dfxp_file = subtitles_filename(filename, lang, ext)
680 srt_file = subtitles_filename(filename, lang, 'srt')
682 with io.open(dfxp_file, 'rt', encoding='utf-8') as f:
683 srt_data = dfxp2srt(f.read())
685 with io.open(srt_file, 'wt', encoding='utf-8') as f:
698 subtitles_filename(filename, lang, ext),
699 new_file, ['-f', new_format])
701 with io.open(new_file, 'rt', encoding='utf-8') as f: