summaryrefslogtreecommitdiffstats
path: root/yt_dlp/extractor/patreon.py
diff options
context:
space:
mode:
Diffstat (limited to 'yt_dlp/extractor/patreon.py')
-rw-r--r--yt_dlp/extractor/patreon.py454
1 files changed, 454 insertions, 0 deletions
diff --git a/yt_dlp/extractor/patreon.py b/yt_dlp/extractor/patreon.py
new file mode 100644
index 0000000..d2ddb72
--- /dev/null
+++ b/yt_dlp/extractor/patreon.py
@@ -0,0 +1,454 @@
+import itertools
+
+from .common import InfoExtractor
+from .vimeo import VimeoIE
+from ..compat import compat_urllib_parse_unquote
+from ..networking.exceptions import HTTPError
+from ..utils import (
+ KNOWN_EXTENSIONS,
+ ExtractorError,
+ clean_html,
+ determine_ext,
+ int_or_none,
+ mimetype2ext,
+ parse_iso8601,
+ str_or_none,
+ traverse_obj,
+ try_get,
+ url_or_none,
+ urljoin,
+)
+
+
+class PatreonBaseIE(InfoExtractor):
+ USER_AGENT = 'Patreon/7.6.28 (Android; Android 11; Scale/2.10)'
+
+ def _call_api(self, ep, item_id, query=None, headers=None, fatal=True, note=None):
+ if headers is None:
+ headers = {}
+ if 'User-Agent' not in headers:
+ headers['User-Agent'] = self.USER_AGENT
+ if query:
+ query.update({'json-api-version': 1.0})
+
+ try:
+ return self._download_json(
+ f'https://www.patreon.com/api/{ep}',
+ item_id, note='Downloading API JSON' if not note else note,
+ query=query, fatal=fatal, headers=headers)
+ except ExtractorError as e:
+ if not isinstance(e.cause, HTTPError) or mimetype2ext(e.cause.response.headers.get('Content-Type')) != 'json':
+ raise
+ err_json = self._parse_json(self._webpage_read_content(e.cause.response, None, item_id), item_id, fatal=False)
+ err_message = traverse_obj(err_json, ('errors', ..., 'detail'), get_all=False)
+ if err_message:
+ raise ExtractorError(f'Patreon said: {err_message}', expected=True)
+ raise
+
+
+class PatreonIE(PatreonBaseIE):
+ _VALID_URL = r'https?://(?:www\.)?patreon\.com/(?:creation\?hid=|posts/(?:[\w-]+-)?)(?P<id>\d+)'
+ _TESTS = [{
+ 'url': 'http://www.patreon.com/creation?hid=743933',
+ 'md5': 'e25505eec1053a6e6813b8ed369875cc',
+ 'info_dict': {
+ 'id': '743933',
+ 'ext': 'mp3',
+ 'title': 'Episode 166: David Smalley of Dogma Debate',
+ 'description': 'md5:34d207dd29aa90e24f1b3f58841b81c7',
+ 'uploader': 'Cognitive Dissonance Podcast',
+ 'thumbnail': 're:^https?://.*$',
+ 'timestamp': 1406473987,
+ 'upload_date': '20140727',
+ 'uploader_id': '87145',
+ 'like_count': int,
+ 'comment_count': int,
+ 'uploader_url': 'https://www.patreon.com/dissonancepod',
+ 'channel_id': '80642',
+ 'channel_url': 'https://www.patreon.com/dissonancepod',
+ 'channel_follower_count': int,
+ },
+ }, {
+ 'url': 'http://www.patreon.com/creation?hid=754133',
+ 'md5': '3eb09345bf44bf60451b8b0b81759d0a',
+ 'info_dict': {
+ 'id': '754133',
+ 'ext': 'mp3',
+ 'title': 'CD 167 Extra',
+ 'uploader': 'Cognitive Dissonance Podcast',
+ 'thumbnail': 're:^https?://.*$',
+ 'like_count': int,
+ 'comment_count': int,
+ 'uploader_url': 'https://www.patreon.com/dissonancepod',
+ },
+ 'skip': 'Patron-only content',
+ }, {
+ 'url': 'https://www.patreon.com/creation?hid=1682498',
+ 'info_dict': {
+ 'id': 'SU4fj_aEMVw',
+ 'ext': 'mp4',
+ 'title': 'I\'m on Patreon!',
+ 'uploader': 'TraciJHines',
+ 'thumbnail': 're:^https?://.*$',
+ 'upload_date': '20150211',
+ 'description': 'md5:8af6425f50bd46fbf29f3db0fc3a8364',
+ 'uploader_id': 'TraciJHines',
+ 'categories': ['Entertainment'],
+ 'duration': 282,
+ 'view_count': int,
+ 'tags': 'count:39',
+ 'age_limit': 0,
+ 'channel': 'TraciJHines',
+ 'channel_url': 'https://www.youtube.com/channel/UCGLim4T2loE5rwCMdpCIPVg',
+ 'live_status': 'not_live',
+ 'like_count': int,
+ 'channel_id': 'UCGLim4T2loE5rwCMdpCIPVg',
+ 'availability': 'public',
+ 'channel_follower_count': int,
+ 'playable_in_embed': True,
+ 'uploader_url': 'http://www.youtube.com/user/TraciJHines',
+ 'comment_count': int,
+ },
+ 'params': {
+ 'noplaylist': True,
+ 'skip_download': True,
+ }
+ }, {
+ 'url': 'https://www.patreon.com/posts/episode-166-of-743933',
+ 'only_matching': True,
+ }, {
+ 'url': 'https://www.patreon.com/posts/743933',
+ 'only_matching': True,
+ }, {
+ 'url': 'https://www.patreon.com/posts/kitchen-as-seen-51706779',
+ 'md5': '96656690071f6d64895866008484251b',
+ 'info_dict': {
+ 'id': '555089736',
+ 'ext': 'mp4',
+ 'title': 'KITCHEN AS SEEN ON DEEZ NUTS EXTENDED!',
+ 'uploader': 'Cold Ones',
+ 'thumbnail': 're:^https?://.*$',
+ 'upload_date': '20210526',
+ 'description': 'md5:557a409bd79d3898689419094934ba79',
+ 'uploader_id': '14936315',
+ },
+ 'skip': 'Patron-only content'
+ }, {
+ # m3u8 video (https://github.com/yt-dlp/yt-dlp/issues/2277)
+ 'url': 'https://www.patreon.com/posts/video-sketchbook-32452882',
+ 'info_dict': {
+ 'id': '32452882',
+ 'ext': 'mp4',
+ 'comment_count': int,
+ 'uploader_id': '4301314',
+ 'like_count': int,
+ 'timestamp': 1576696962,
+ 'upload_date': '20191218',
+ 'thumbnail': r're:^https?://.*$',
+ 'uploader_url': 'https://www.patreon.com/loish',
+ 'description': 'md5:e2693e97ee299c8ece47ffdb67e7d9d2',
+ 'title': 'VIDEO // sketchbook flipthrough',
+ 'uploader': 'Loish ',
+ 'tags': ['sketchbook', 'video'],
+ 'channel_id': '1641751',
+ 'channel_url': 'https://www.patreon.com/loish',
+ 'channel_follower_count': int,
+ }
+ }, {
+ # bad videos under media (if media is included). Real one is under post_file
+ 'url': 'https://www.patreon.com/posts/premium-access-70282931',
+ 'info_dict': {
+ 'id': '70282931',
+ 'ext': 'mp4',
+ 'title': '[Premium Access + Uncut] The Office - 2x6 The Fight - Group Reaction',
+ 'channel_url': 'https://www.patreon.com/thenormies',
+ 'channel_id': '573397',
+ 'uploader_id': '2929435',
+ 'uploader': 'The Normies',
+ 'description': 'md5:79c9fd8778e2cef84049a94c058a5e23',
+ 'comment_count': int,
+ 'upload_date': '20220809',
+ 'thumbnail': r're:^https?://.*$',
+ 'channel_follower_count': int,
+ 'like_count': int,
+ 'timestamp': 1660052820,
+ 'tags': ['The Office', 'early access', 'uncut'],
+ 'uploader_url': 'https://www.patreon.com/thenormies',
+ },
+ 'skip': 'Patron-only content',
+ }]
+
+ def _real_extract(self, url):
+ video_id = self._match_id(url)
+ post = self._call_api(
+ f'posts/{video_id}', video_id, query={
+ 'fields[media]': 'download_url,mimetype,size_bytes',
+ 'fields[post]': 'comment_count,content,embed,image,like_count,post_file,published_at,title,current_user_can_view',
+ 'fields[user]': 'full_name,url',
+ 'fields[post_tag]': 'value',
+ 'fields[campaign]': 'url,name,patron_count',
+ 'json-api-use-default-includes': 'false',
+ 'include': 'audio,user,user_defined_tags,campaign,attachments_media',
+ })
+ attributes = post['data']['attributes']
+ title = attributes['title'].strip()
+ image = attributes.get('image') or {}
+ info = {
+ 'id': video_id,
+ 'title': title,
+ 'description': clean_html(attributes.get('content')),
+ 'thumbnail': image.get('large_url') or image.get('url'),
+ 'timestamp': parse_iso8601(attributes.get('published_at')),
+ 'like_count': int_or_none(attributes.get('like_count')),
+ 'comment_count': int_or_none(attributes.get('comment_count')),
+ }
+ can_view_post = traverse_obj(attributes, 'current_user_can_view')
+ if can_view_post and info['comment_count']:
+ info['__post_extractor'] = self.extract_comments(video_id)
+
+ for i in post.get('included', []):
+ i_type = i.get('type')
+ if i_type == 'media':
+ media_attributes = i.get('attributes') or {}
+ download_url = media_attributes.get('download_url')
+ ext = mimetype2ext(media_attributes.get('mimetype'))
+
+ # if size_bytes is None, this media file is likely unavailable
+ # See: https://github.com/yt-dlp/yt-dlp/issues/4608
+ size_bytes = int_or_none(media_attributes.get('size_bytes'))
+ if download_url and ext in KNOWN_EXTENSIONS and size_bytes is not None:
+ # XXX: what happens if there are multiple attachments?
+ return {
+ **info,
+ 'ext': ext,
+ 'filesize': size_bytes,
+ 'url': download_url,
+ }
+ elif i_type == 'user':
+ user_attributes = i.get('attributes')
+ if user_attributes:
+ info.update({
+ 'uploader': user_attributes.get('full_name'),
+ 'uploader_id': str_or_none(i.get('id')),
+ 'uploader_url': user_attributes.get('url'),
+ })
+
+ elif i_type == 'post_tag':
+ info.setdefault('tags', []).append(traverse_obj(i, ('attributes', 'value')))
+
+ elif i_type == 'campaign':
+ info.update({
+ 'channel': traverse_obj(i, ('attributes', 'title')),
+ 'channel_id': str_or_none(i.get('id')),
+ 'channel_url': traverse_obj(i, ('attributes', 'url')),
+ 'channel_follower_count': int_or_none(traverse_obj(i, ('attributes', 'patron_count'))),
+ })
+
+ # handle Vimeo embeds
+ if try_get(attributes, lambda x: x['embed']['provider']) == 'Vimeo':
+ embed_html = try_get(attributes, lambda x: x['embed']['html'])
+ v_url = url_or_none(compat_urllib_parse_unquote(
+ self._search_regex(r'(https(?:%3A%2F%2F|://)player\.vimeo\.com.+app_id(?:=|%3D)+\d+)', embed_html, 'vimeo url', fatal=False)))
+ if v_url:
+ return {
+ **info,
+ '_type': 'url_transparent',
+ 'url': VimeoIE._smuggle_referrer(v_url, 'https://patreon.com'),
+ 'ie_key': 'Vimeo',
+ }
+
+ embed_url = try_get(attributes, lambda x: x['embed']['url'])
+ if embed_url:
+ return {
+ **info,
+ '_type': 'url',
+ 'url': embed_url,
+ }
+
+ post_file = traverse_obj(attributes, 'post_file')
+ if post_file:
+ name = post_file.get('name')
+ ext = determine_ext(name)
+ if ext in KNOWN_EXTENSIONS:
+ return {
+ **info,
+ 'ext': ext,
+ 'url': post_file['url'],
+ }
+ elif name == 'video' or determine_ext(post_file.get('url')) == 'm3u8':
+ formats, subtitles = self._extract_m3u8_formats_and_subtitles(post_file['url'], video_id)
+ return {
+ **info,
+ 'formats': formats,
+ 'subtitles': subtitles,
+ }
+
+ if can_view_post is False:
+ self.raise_no_formats('You do not have access to this post', video_id=video_id, expected=True)
+ else:
+ self.raise_no_formats('No supported media found in this post', video_id=video_id, expected=True)
+ return info
+
+ def _get_comments(self, post_id):
+ cursor = None
+ count = 0
+ params = {
+ 'page[count]': 50,
+ 'include': 'parent.commenter.campaign,parent.post.user,parent.post.campaign.creator,parent.replies.parent,parent.replies.commenter.campaign,parent.replies.post.user,parent.replies.post.campaign.creator,commenter.campaign,post.user,post.campaign.creator,replies.parent,replies.commenter.campaign,replies.post.user,replies.post.campaign.creator,on_behalf_of_campaign',
+ 'fields[comment]': 'body,created,is_by_creator',
+ 'fields[user]': 'image_url,full_name,url',
+ 'filter[flair]': 'image_tiny_url,name',
+ 'sort': '-created',
+ 'json-api-version': 1.0,
+ 'json-api-use-default-includes': 'false',
+ }
+
+ for page in itertools.count(1):
+
+ params.update({'page[cursor]': cursor} if cursor else {})
+ response = self._call_api(
+ f'posts/{post_id}/comments', post_id, query=params, note='Downloading comments page %d' % page)
+
+ cursor = None
+ for comment in traverse_obj(response, (('data', ('included', lambda _, v: v['type'] == 'comment')), ...)):
+ count += 1
+ comment_id = comment.get('id')
+ attributes = comment.get('attributes') or {}
+ if comment_id is None:
+ continue
+ author_id = traverse_obj(comment, ('relationships', 'commenter', 'data', 'id'))
+ author_info = traverse_obj(
+ response, ('included', lambda _, v: v['id'] == author_id and v['type'] == 'user', 'attributes'),
+ get_all=False, expected_type=dict, default={})
+
+ yield {
+ 'id': comment_id,
+ 'text': attributes.get('body'),
+ 'timestamp': parse_iso8601(attributes.get('created')),
+ 'parent': traverse_obj(comment, ('relationships', 'parent', 'data', 'id'), default='root'),
+ 'author_is_uploader': attributes.get('is_by_creator'),
+ 'author_id': author_id,
+ 'author': author_info.get('full_name'),
+ 'author_thumbnail': author_info.get('image_url'),
+ }
+
+ if count < traverse_obj(response, ('meta', 'count')):
+ cursor = traverse_obj(response, ('data', -1, 'id'))
+
+ if cursor is None:
+ break
+
+
+class PatreonCampaignIE(PatreonBaseIE):
+
+ _VALID_URL = r'https?://(?:www\.)?patreon\.com/(?!rss)(?:(?:m/(?P<campaign_id>\d+))|(?P<vanity>[-\w]+))'
+ _TESTS = [{
+ 'url': 'https://www.patreon.com/dissonancepod/',
+ 'info_dict': {
+ 'title': 'Cognitive Dissonance Podcast',
+ 'channel_url': 'https://www.patreon.com/dissonancepod',
+ 'id': '80642',
+ 'description': 'md5:eb2fa8b83da7ab887adeac34da6b7af7',
+ 'channel_id': '80642',
+ 'channel': 'Cognitive Dissonance Podcast',
+ 'age_limit': 0,
+ 'channel_follower_count': int,
+ 'uploader_id': '87145',
+ 'uploader_url': 'https://www.patreon.com/dissonancepod',
+ 'uploader': 'Cognitive Dissonance Podcast',
+ 'thumbnail': r're:^https?://.*$',
+ },
+ 'playlist_mincount': 68,
+ }, {
+ 'url': 'https://www.patreon.com/m/4767637/posts',
+ 'info_dict': {
+ 'title': 'Not Just Bikes',
+ 'channel_follower_count': int,
+ 'id': '4767637',
+ 'channel_id': '4767637',
+ 'channel_url': 'https://www.patreon.com/notjustbikes',
+ 'description': 'md5:595c6e7dca76ae615b1d38c298a287a1',
+ 'age_limit': 0,
+ 'channel': 'Not Just Bikes',
+ 'uploader_url': 'https://www.patreon.com/notjustbikes',
+ 'uploader': 'Not Just Bikes',
+ 'uploader_id': '37306634',
+ 'thumbnail': r're:^https?://.*$',
+ },
+ 'playlist_mincount': 71
+ }, {
+ 'url': 'https://www.patreon.com/dissonancepod/posts',
+ 'only_matching': True
+ }, {
+ 'url': 'https://www.patreon.com/m/5932659',
+ 'only_matching': True
+ }]
+
+ @classmethod
+ def suitable(cls, url):
+ return False if PatreonIE.suitable(url) else super(PatreonCampaignIE, cls).suitable(url)
+
+ def _entries(self, campaign_id):
+ cursor = None
+ params = {
+ 'fields[post]': 'patreon_url,url',
+ 'filter[campaign_id]': campaign_id,
+ 'filter[is_draft]': 'false',
+ 'sort': '-published_at',
+ 'json-api-use-default-includes': 'false',
+ }
+
+ for page in itertools.count(1):
+
+ params.update({'page[cursor]': cursor} if cursor else {})
+ posts_json = self._call_api('posts', campaign_id, query=params, note='Downloading posts page %d' % page)
+
+ cursor = traverse_obj(posts_json, ('meta', 'pagination', 'cursors', 'next'))
+ for post_url in traverse_obj(posts_json, ('data', ..., 'attributes', 'patreon_url')):
+ yield self.url_result(urljoin('https://www.patreon.com/', post_url), PatreonIE)
+
+ if cursor is None:
+ break
+
+ def _real_extract(self, url):
+
+ campaign_id, vanity = self._match_valid_url(url).group('campaign_id', 'vanity')
+ if campaign_id is None:
+ webpage = self._download_webpage(url, vanity, headers={'User-Agent': self.USER_AGENT})
+ campaign_id = self._search_regex(r'https://www.patreon.com/api/campaigns/(\d+)/?', webpage, 'Campaign ID')
+
+ params = {
+ 'json-api-use-default-includes': 'false',
+ 'fields[user]': 'full_name,url',
+ 'fields[campaign]': 'name,summary,url,patron_count,creation_count,is_nsfw,avatar_photo_url',
+ 'include': 'creator'
+ }
+
+ campaign_response = self._call_api(
+ f'campaigns/{campaign_id}', campaign_id,
+ note='Downloading campaign info', fatal=False,
+ query=params) or {}
+
+ campaign_info = campaign_response.get('data') or {}
+ channel_name = traverse_obj(campaign_info, ('attributes', 'name'))
+ user_info = traverse_obj(
+ campaign_response, ('included', lambda _, v: v['type'] == 'user'),
+ default={}, expected_type=dict, get_all=False)
+
+ return {
+ '_type': 'playlist',
+ 'id': campaign_id,
+ 'title': channel_name,
+ 'entries': self._entries(campaign_id),
+ 'description': clean_html(traverse_obj(campaign_info, ('attributes', 'summary'))),
+ 'channel_url': traverse_obj(campaign_info, ('attributes', 'url')),
+ 'channel_follower_count': int_or_none(traverse_obj(campaign_info, ('attributes', 'patron_count'))),
+ 'channel_id': campaign_id,
+ 'channel': channel_name,
+ 'uploader_url': traverse_obj(user_info, ('attributes', 'url')),
+ 'uploader_id': str_or_none(user_info.get('id')),
+ 'uploader': traverse_obj(user_info, ('attributes', 'full_name')),
+ 'playlist_count': traverse_obj(campaign_info, ('attributes', 'creation_count')),
+ 'age_limit': 18 if traverse_obj(campaign_info, ('attributes', 'is_nsfw')) else 0,
+ 'thumbnail': url_or_none(traverse_obj(campaign_info, ('attributes', 'avatar_photo_url'))),
+ }