SNH48 Live

This repository hosts technical documentation and helpers for the SNH48 Live YouTube channel.

Check snh48live.org for more resources.

Docs

about.md: general description of the channel.
video-source.md: technical info on how videos on the channel are extracted, and qualities thereof.
config.md: tool configurations documention.

videos.txt: short list of all content videos (channel info videos are not included).
data/videos/*.json: metadata of content videos directly from YouTube API v3.
partially-blocked.txt: short list of videos that are blocked in some countries (see claims.md for details). To get around region blocks, use a VPN service, e.g. Private Internet Access.
claims.md: list of videos and their associated copyright claims.
claims.json: list of videos and their associated copyright claims, in JSON format.
performances.json: a streamable line-oriented JSON data store of metadata of performances, used for snh48live.org/filter.
attendance.txt: human-readable attendance sheet (compiled by myself, might contain mistakes).
attendance.json: structured version of attendance.txt for machine consumption.

Helpers depend on Python 3.6+ and Zsh 5.0+.

download: the heart and soul of this channel. Downloads a VOD from live.snh48.com, then optionally uploads it to the channel.
extract-claims: extract video info and associated copyright claims from a YouTube copyright claims page, and automatically populate related datastores.
fetch-metadata: fetch metadata of all content videos.
fetch-schedule: fetch and format schedule data from https://snh48live.org/schedule/; helper for new-config.
new-config: generate download/upload configuration for a new performance.
new-attendance-entry: automatically populate as much of a new attendance sheet entry as possible.
parse-attendance-sheet: convert attendance.txt into attendance.json.
performers: retrieve performers lists from official streaming site.
post-to-tumblr: cross-post to Tumblr — a healthy dose of SEO and discoverability shenanigans doesn't hurt, right?
qa: basic quality assurance on Python source code.
record-performance: record performance metadata into performances.json.
searchrank: find this channel and its videos among the top 50 SNH48-related search results. Purely for bragging rights.
stats: fetch and display channel analytics data.
stats-monitor: run stats periodically, print and log results.
tweet: tweet to Twitter.
thumbnail: generate custom thumbnails.
update-metadata: update metadata of videos in various ways (check the subcommands).
upload: YouTube video uploader (WIP).