本篇介紹如何使用 Python 的 pytube 模組，自動下載 YouTube 的影片。
pytube是一個專門用來下載 YouTube 影片的 Python 模組，除了提供程式介面的自動化下載功能，也附帶有指令下載工具，可以快速下載 YouTube 的影片。
安裝 pytube 模組
Python 的 pytube 模組可以透過標準的 pip 直接安裝：
# 安裝 pytube 模組
pip install pytube
指令下載 YouTube 影片
在 Python 的 pytube 模組附帶了一個 pytube 指令稿，可以讓使用者快速下載 YouTube 影片：
# 下載 YouTube 影片
pytube https://youtube.com/watch?v=2lAe1cqCOXo
執行之後就會將 YouTube 下載並儲存為 MP4 影片。
撥放清單
pytube 指令稿也可以下載 YouTube 撥放清單中的所有影片：
# 下載 YouTube 影片
pytube https://www.youtube.com/playlist?list=PLS1QulWo1RIaJECMeUT4LFwJ-ghgoSH6n
下載音樂（只有聲音）
若只需要下載 YouTube 影片的聲音部分，不需要影像，可以加上 -a 或 --audio 參數，並指定下載的格式，例如：
# 下載 YouTube 影片的聲音部分 pytube -a mp4 https://youtube.com/watch?v=2lAe1cqCOXo
指定影片下載格式
我們可以加上 -l 或 --list 參數查詢 YouTube 影片有哪一些格式可以下載：
# 查詢 YouTube 影片的格式 pytube -l https://youtube.com/watch?v=2lAe1cqCOXo
Loading video... <Stream: itag="17" mime_type="video/3gpp" res="144p" fps="12fps" vcodec="mp4v.20.3" acodec="mp4a.40.2" progressive="True" type="video"> <Stream: itag="18" mime_type="video/mp4" res="360p" fps="24fps" vcodec="avc1.42001E" acodec="mp4a.40.2" progressive="True" type="video"> <Stream: itag="22" mime_type="video/mp4" res="720p" fps="24fps" vcodec="avc1.64001F" acodec="mp4a.40.2" progressive="True" type="video"> <Stream: itag="137" mime_type="video/mp4" res="1080p" fps="24fps" vcodec="avc1.640028" progressive="False" type="video"> <Stream: itag="248" mime_type="video/webm" res="1080p" fps="24fps" vcodec="vp9" progressive="False" type="video"> <Stream: itag="399" mime_type="video/mp4" res="1080p" fps="24fps" vcodec="av01.0.08M.08" progressive="False" type="video"> <Stream: itag="136" mime_type="video/mp4" res="720p" fps="24fps" vcodec="avc1.4d401f" progressive="False" type="video"> <Stream: itag="247" mime_type="video/webm" res="720p" fps="24fps" vcodec="vp9" progressive="False" type="video"> <Stream: itag="398" mime_type="video/mp4" res="720p" fps="24fps" vcodec="av01.0.05M.08" progressive="False" type="video"> <Stream: itag="135" mime_type="video/mp4" res="480p" fps="24fps" vcodec="avc1.4d401e" progressive="False" type="video"> <Stream: itag="244" mime_type="video/webm" res="480p" fps="24fps" vcodec="vp9" progressive="False" type="video"> <Stream: itag="397" mime_type="video/mp4" res="480p" fps="24fps" vcodec="av01.0.04M.08" progressive="False" type="video"> <Stream: itag="134" mime_type="video/mp4" res="360p" fps="24fps" vcodec="avc1.4d401e" progressive="False" type="video"> <Stream: itag="243" mime_type="video/webm" res="360p" fps="24fps" vcodec="vp9" progressive="False" type="video"> <Stream: itag="396" mime_type="video/mp4" res="360p" fps="24fps" vcodec="av01.0.01M.08" progressive="False" type="video"> <Stream: itag="133" mime_type="video/mp4" res="240p" fps="24fps" vcodec="avc1.4d4015" progressive="False" type="video"> <Stream: itag="242" mime_type="video/webm" res="240p" fps="24fps" vcodec="vp9" progressive="False" type="video"> <Stream: itag="395" mime_type="video/mp4" res="240p" fps="24fps" vcodec="av01.0.00M.08" progressive="False" type="video"> <Stream: itag="160" mime_type="video/mp4" res="144p" fps="24fps" vcodec="avc1.4d400c" progressive="False" type="video"> <Stream: itag="278" mime_type="video/webm" res="144p" fps="24fps" vcodec="vp9" progressive="False" type="video"> <Stream: itag="394" mime_type="video/mp4" res="144p" fps="24fps" vcodec="av01.0.00M.08" progressive="False" type="video"> <Stream: itag="139" mime_type="audio/mp4" abr="48kbps" acodec="mp4a.40.5" progressive="False" type="audio"> <Stream: itag="140" mime_type="audio/mp4" abr="128kbps" acodec="mp4a.40.2" progressive="False" type="audio"> <Stream: itag="249" mime_type="audio/webm" abr="50kbps" acodec="opus" progressive="False" type="audio"> <Stream: itag="250" mime_type="audio/webm" abr="70kbps" acodec="opus" progressive="False" type="audio"> <Stream: itag="251" mime_type="audio/webm" abr="160kbps" acodec="opus" progressive="False" type="audio">
itag 是 YouTube 區分影片格式用的標籤，我們可以透過這裡的 itag 值來指定下載的影片格式，例如下載 webm 格式、品質為 50k bps 的聲音檔：
# 查詢 YouTube 影片的格式 pytube --itag 249 zh-TW https://youtube.com/watch?v=2lAe1cqCOXo
程式自動化下載 YouTube 影片
在 Python 的 pytube 模組也可以用於一般的指令稿中，撰寫自動化下載 YouTube 影片的程式。
下載 YouTube 影片
首先從 pytube 模組引入 YouTube，建立 YouTube 物件：
from pytube import YouTube # 建立 YouTube 物件 yt = YouTube('http://youtube.com/watch?v=2lAe1cqCOXo')
我們可以透過 YouTube 物件取得一些影片的基本資訊：
# 影片標題 print(yt.title)
YouTube Rewind 2019: For the Record | #YouTubeRewind
# 影片縮圖 print(yt.thumbnail_url)
https://i.ytimg.com/vi/2lAe1cqCOXo/sddefault.jpg
在 YouTube 的 streams 中通常會包含非常多種影片格式：
# 查看所有影片格式 print(yt.streams)
[<Stream: itag="17" mime_type="video/3gpp" res="144p" fps="12fps" vcodec="mp4v.20.3" acodec="mp4a.40.2" progressive="True" type="video">, <Stream: itag="18" mime_type="video/mp4" res="360p" fps="24fps" vcodec="avc1.42001E" acodec="mp4a.40.2" progressive="True" type="video">, <Stream: itag="22" mime_type="video/mp4" res="720p" fps="24fps" vcodec="avc1.64001F" acodec="mp4a.40.2" progressive="True" type="video">, <Stream: itag="137" mime_type="video/mp4" res="1080p" fps="24fps" vcodec="avc1.640028" progressive="False" type="video">, <Stream: itag="248" mime_type="video/webm" res="1080p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="399" mime_type="video/mp4" res="1080p" fps="24fps" vcodec="av01.0.08M.08" progressive="False" type="video">, <Stream: itag="136" mime_type="video/mp4" res="720p" fps="24fps" vcodec="avc1.4d401f" progressive="False" type="video">, <Stream: itag="247" mime_type="video/webm" res="720p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="398" mime_type="video/mp4" res="720p" fps="24fps" vcodec="av01.0.05M.08" progressive="False" type="video">, <Stream: itag="135" mime_type="video/mp4" res="480p" fps="24fps" vcodec="avc1.4d401e" progressive="False" type="video">, <Stream: itag="244" mime_type="video/webm" res="480p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="397" mime_type="video/mp4" res="480p" fps="24fps" vcodec="av01.0.04M.08" progressive="False" type="video">, <Stream: itag="134" mime_type="video/mp4" res="360p" fps="24fps" vcodec="avc1.4d401e" progressive="False" type="video">, <Stream: itag="243" mime_type="video/webm" res="360p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="396" mime_type="video/mp4" res="360p" fps="24fps" vcodec="av01.0.01M.08" progressive="False" type="video">, <Stream: itag="133" mime_type="video/mp4" res="240p" fps="24fps" vcodec="avc1.4d4015" progressive="False" type="video">, <Stream: itag="242" mime_type="video/webm" res="240p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="395" mime_type="video/mp4" res="240p" fps="24fps" vcodec="av01.0.00M.08" progressive="False" type="video">, <Stream: itag="160" mime_type="video/mp4" res="144p" fps="24fps" vcodec="avc1.4d400c" progressive="False" type="video">, <Stream: itag="278" mime_type="video/webm" res="144p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="394" mime_type="video/mp4" res="144p" fps="24fps" vcodec="av01.0.00M.08" progressive="False" type="video">, <Stream: itag="139" mime_type="audio/mp4" abr="48kbps" acodec="mp4a.40.5" progressive="False" type="audio">, <Stream: itag="140" mime_type="audio/mp4" abr="128kbps" acodec="mp4a.40.2" progressive="False" type="audio">, <Stream: itag="249" mime_type="audio/webm" abr="50kbps" acodec="opus" progressive="False" type="audio">, <Stream: itag="250" mime_type="audio/webm" abr="70kbps" acodec="opus" progressive="False" type="audio">, <Stream: itag="251" mime_type="audio/webm" abr="160kbps" acodec="opus" progressive="False" type="audio">]
我們可以利用條件篩選功能，選出我們要的串流格式來下載，例如先篩選 progressive 類型的 MP4 影片格式：
# 篩選 progressive 類型的 MP4 影片格式 progMP4 = yt.streams.filter(progressive=True, file_extension='mp4') print(progMP4)
[<Stream: itag="18" mime_type="video/mp4" res="360p" fps="24fps" vcodec="avc1.42001E" acodec="mp4a.40.2" progressive="True" type="video">, <Stream: itag="22" mime_type="video/mp4" res="720p" fps="24fps" vcodec="avc1.64001F" acodec="mp4a.40.2" progressive="True" type="video">]
接著找出解析度最好的 MP4 影片：
# 找出解析度最好的 MP4 影片 targetMP4 = progMP4.order_by('resolution').desc().first() print(targetMP4)
<Stream: itag="22" mime_type="video/mp4" res="720p" fps="24fps" vcodec="avc1.64001F" acodec="mp4a.40.2" progressive="True" type="video">
決定好要下載的影片串流格式之後，即可進行下載：
# 下載影片 video_file = targetMP4.download() print(video_file)
/home/ubuntu/tmp/YouTube Rewind 2019 For the Record YouTubeRewind.mp4
下載的影片檔案預設會放在目前的執行目錄之下，我們也可以在 download() 的參數中直接指定下載影片檔案的放置目錄：
# 下載影片並儲存至 /tmp/youtube_dl 目錄 video_file = targetMP4.download("/tmp/youtube_dl") print(video_file)
/tmp/youtube_dl/YouTube Rewind 2019 For the Record YouTubeRewind.mp4
下載 YouTube 撥放清單
若要以程式下載 YouTube 撥放清單中的所有影片，可以使用 Playlist 功能。
首先以 YouTube 撥放清單網址來建立 Playlist 物件：
from pytube import Playlist # 建立 Playlist 物件 p = Playlist('https://www.youtube.com/playlist?list=PLS1QulWo1RIaJECMeUT4LFwJ-ghgoSH6n')
或是以 YouTube 撥放清單中的其中一部影片網址來建立 Playlist 物件也可以：
# 建立 Playlist 物件 p = Playlist('https://www.youtube.com/watch?v=41qgdwd3zAg&list=PLS1QulWo1RIaJECMeUT4LFwJ-ghgoSH6n')
Playlist 物件中會包含一些撥放清單的基本資訊：
# 撥放清單標題 print(p.title)
Python Tutorial for Beginners (For Absolute Beginners)
撥放清單終究包含了所有影片的 YouTube 物件，所以只要以迴圈的方式逐一下載每部 YouTube 影片即可：
# 逐一處理撥放清單中的影片 for video in p.videos: # 下載 YouTube 影片 video.streams.first().download()